NexusEconomy

What is NexusEconomy?

NexusEconomy is a next-generation core economy plugin that registers a compatible Bukkit economy service, acting as a native and modern alternative to the Vault API. This allows other plugins to handle transactions and balances without relying on the traditional Vault.jar file. It features advanced persistent storage (BalanceStore), modular multi-language support, and direct transaction flows.

━━━━━ IMPORTANT ━━━━━

DO NOT run this plugin alongside the traditional Vault.jar file. NexusEconomy registers its own fully compatible economic service provider natively. Strictly requires Java 25 and PaperMC 26.1 / 26.3.

━━━━━━ Features ━━━━━━

Vault Alternative: Acts as a completely independent Bukkit economy service provider without requiring external dependencies.
Advanced Persistence: Server accounts are securely managed and saved locally through the internal BalanceStore class.
Integrated API: Features the public static NexusEconomyAPI class with typed support for direct queries and developer transactions.
Rank Support: Built-in integration via LuckPermsSupport for streamlined network permission management.
Multi-language: Standalone modular language system featuring native out-of-the-box support for Spanish (es.yml) and English (en.yml).
Next-Gen Messaging: Native implementation of the Adventure API (Kyori) for modern RGB text components and formatting in chat.
Safe Reloads: The /nexuseconomy reload system updates config.yml and language files on the fly without overwriting values.

━━━━━ Installation ━━━━━

Copy the .jar file into your server's plugins folder. Ensure Java 25 is selected in your hosting startup settings and boot the server to generate the configuration files and translations.
Plugin Compatibility: Efficiently replaces the universal Vault bridge, allowing users to integrate virtual shops, reward addons, and auctions with significantly higher performance.

━━━━━ Commands ━━━━━━

📃Command List:

• 1:💲/balance Displays the player's current balance in chat using clean, language-specific text components.
• 2:💲/pay Directly and securely sends a specified amount to another active player, validating account funds in BalanceStore before processing.
• 3:💲/nexuseconomy reload Allows administrators to instantly reload economic limits and chat translations.

━ Configuration System ━

The configuration system helps manage in-game finances. Administrators can easily adjust thresholds, modify chat alerts, and adapt settings to their server's economy.
Adjusting Starting Balance
To modify the amount of money new players receive when they join for the first time, edit the balance_inicial line in config.yml.
Economic Limits
The system allows setting a balance_minimo and balance_maximo to control server inflation and natively prevent fraudulent money generation.
Text Customization
All chat messages for sent/received payments or insufficient funds from the config automatically deserialize, maintaining a clean and professional look.
Secure Management
Utilizes a unified API and a controlled command environment to ensure that account balances never suffer duplications or data loss, providing absolute stability for production environments.