NexusPay 0

NexusPay - High-Performance Web-to-Game Gateway​

The most efficient, lightweight, and secure way to connect your web store with your Minecraft server.

NexusPay acts as an automated bridge that synchronizes your website purchases with the game in real-time. It ensures players receive their products safely without any manual intervention from administrators.

Key Features​

• Asynchronous Synchronization: The plugin queries your web API in the background, preventing any lag or spikes in your server's performance (TPS).
• Smart-Delivery System: Commands are only executed if the player is online. If the player is offline, the purchase remains pending until their next login.
• Delivery Confirmation (Callback): Once a command is executed, the plugin automatically notifies your website to mark the purchase as completed, preventing duplicate deliveries.
• Highly Configurable: Includes a comprehensive config.yml to manage your API Key, store URL, and check intervals.
• Ultra-Lightweight: At only 6 KB, the code is highly optimized to use minimal CPU and RAM.
  

How it works​

1. Request: Every minute (configurable), NexusPay requests the list of pending purchases from your web API using a secure Secret Key.
2. Validation: It processes the JSON response and checks which players are currently active on the server.
3. Execution: Commands are executed through the server console, automatically replacing the %player% variable with the user's name.
4. Confirmation: After success, it sends a POST signal back to the web to close the transaction loop.
   

Technical Requirements​

• Java Version: Compiled with Java 17 for maximum compatibility with modern servers (1.18 - 1.21+).
• Dependencies: None. The plugin is completely standalone.
• Web API: Requires your website to return a JSON list with id, player, and command fields.

--- ### Frequently Asked Questions (FAQ)

Does it support multiple commands per player?
Yes! If your Web API returns multiple command lines for a single ID, NexusPay will process them sequentially.

Is it compatible with all versions?
NexusPay is designed to be version-independent. As long as you are running Java 17+, it will work on Spigot, Paper, or Purpur from 1.18 to 1.21.x.

How often does it check for purchases?
By default, every 60 seconds, but you can change the check-interval in the config.yml to suit your needs.

### Commands & Permissions
Since this is an automated gateway, it works through the console. However, you can use: * /nexuspay reload - Reloads the configuration file. (Permission: nexuspay.admin)