nEconomy
nEconomy Modern multi-currency economy plugin for Paper servers, built for performance, clean command UX, and flexible server setups. Overview nEconomy provides a full economy stack with: Multiple configurable currencies (coins, gems, event tokens, etc.) Player-to-player payments baltop rankings with cache Redeem codes with usage limits and expiration Currency conversion rules Withdraw/deposit banknote items Vault and PlaceholderAPI integration Compatibility Item Value --- --- Plugin Version 1.1.0 Platform Paper (Paper API) Target API 1.21 Tested Dependency Target paper-api 1.21.8-R0.1-SNAPSHOT Java Version 21 Storage SQLite, MySQL Locales English (messagesen.yml), Turkish (messagestr.yml) Key Features Feature Description --- --- Multi-Currency Define unlimited currencies in currencies.yml with symbol, tier, aliases, and command support. Pay System Configurable cooldown + amount limits for safe player transfers. Baltop Cached leaderboard pages for better performance. Redeem Codes Create, delete, list, and inspect usage logs for redeem codes. Per-Player Redeem Cap Optional per-player usage limit (0 = unlimited per player). Expirable Codes Set expiration in days for redeem campaigns and events. Converter Currency conversion rules with automatic mode support. Withdraw/Deposit Convert balance to item notes and redeem back into balance. PlaceholderAPI Balance and leaderboard placeholders with internal cache support. Vault Hook Integrates with Vault-enabled plugins via linked currency. Installation Build or download the plugin jar. Place nEconomy-<version.jar into your server plugins/ folder. Start the server once to generate default configs. Stop server and edit: plugins/nEconomy/config.yml plugins/nEconomy/currencies.yml plugins/nEconomy/converters.yml plugins/nEconomy/withdraw.yml Start the server again. Configuration Summary config.yml Path Purpose Example --- --- --- storage.type Select backend SQLITE / MYSQL storage.mysql. MySQL connection settings host, port, database, user, password default-locale Active language file en / tr main-command Root command alias neconomy vault-linked-currency Currency used by Vault bridge coin default-pay-currency Default pay currency coin pay.cooldown-seconds Payment cooldown 2 pay.min-amount Min transferable amount 0.01 pay.max-amount Max transferable amount 1000000000 baltop.page-size Results per page 10 baltop.cache-ttl-seconds Baltop cache TTL 30 display-decimal-places Number formatting precision 2 placeholder-cache-millis Placeholder result cache 500 currencies.yml Field Description --- --- id Unique currency identifier display-name Formatted display name (MiniMessage supported) symbol Currency symbol shown in UI/messages tier Relative progression or conversion tier commands Aliases for direct currency command routes enable-subcommands Enables currency-specific command tree converters.yml Field Description --- --- from Source currency ID to Target currency ID mode Conversion mode (e.g. AUTO) Commands Replace /neconomy with your configured main-command if changed. Player Commands Command Description --- --- /neconomy wallet Shows balances for available currencies /neconomy pay <player <amount [currency] Sends currency to another player /neconomy baltop [currency] [page] Shows top balances /neconomy redeem <code Starts redeem flow /neconomy redeem confirm [code] Confirms pending redeem /neconomy redeem cancel Cancels pending redeem /neconomy withdraw <currency <amount Creates a banknote item /neconomy deposit Deposits banknote from hand /neconomy convert <from <to <amount Converts between currencies Admin Commands Command Description --- --- /neconomy admin reload Reloads plugin config/messages /neconomy admin give <player <currency <amount Adds balance /neconomy admin take <player <currency <amount Removes balance /neconomy admin set <player <currency <amount Sets exact balance /neconomy admin balance <player <currency Checks player balance /neconomy admin redeem create ... Creates redeem codes (new + legacy formats) /neconomy admin redeem delete <code Deletes redeem code /neconomy admin redeem list Lists redeem codes /neconomy admin redeem uses <code Shows code usage log Permissions Permission Default Description --- --- --- neconomy.use true Wallet and currency root command usage neconomy.pay true Player transfers neconomy.baltop true Leaderboard access neconomy.redeem true Redeem command usage neconomy.withdraw true Withdraw/deposit access neconomy.convert true Currency conversion access neconomy.admin op Admin command tree neconomy.bypass.currency op Bypass per-currency restrictions neconomy.currency. false Access all per-currency permission nodes neconomy. op Full plugin permissions PlaceholderAPI Identifier: %neconomy<params% Pattern Example Result --- --- --- balance<currency %neconomybalancecoin% Formatted balance raw<currency %neconomyrawgem% Raw numeric balance formatted<currency %neconomyformattedcoin% Formatted numeric balance baltop<currency<rankname %neconomybaltopcoin1name% Name at rank baltop<currency<rankvalue %neconomybaltopcoin1value% Value at rank Notes Redeem workflows are optimized for Paper command/UI behavior. Economy operations are designed with async-safe patterns and repository-backed persistence. For large servers, MySQL is recommended over SQLite. Support If you use this in production, keep backups of your database and test major config changes on a staging server first.