Plugins
Ürün
Modern multi-currency economy plugin for Paper servers, built for performance, clean command UX, and flexible server setups.
nEconomy provides a full economy stack with:
baltop rankings with cache| 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 (messages_en.yml), Turkish (messages_tr.yml) |
| Feature | Description |
|---|---|
| Multi-Currency | Define unlimited currencies in with symbol, tier, aliases, and command support. |
currencies.yml| 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. |
nEconomy-<version>.jar into your server plugins/ folder.plugins/nEconomy/config.ymlplugins/nEconomy/currencies.ymlplugins/nEconomy/converters.ymlplugins/nEconomy/withdraw.ymlconfig.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) |
Replace
/neconomywith your configuredmain-commandif changed.
| 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 |
| 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 |
| 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 |
Identifier: %neconomy_<params>%
| Pattern | Example | Result |
|---|---|---|
balance_<currency> | %neconomy_balance_coin% | Formatted balance |
raw_<currency> | %neconomy_raw_gem% | Raw numeric balance |
formatted_<currency> | %neconomy_formatted_coin% | Formatted numeric balance |
baltop_<currency>_<rank>_name | %neconomy_baltop_coin_1_name% | Name at rank |
baltop_<currency>_<rank>_value | %neconomy_baltop_coin_1_value% | Value at rank |
If you use this in production, keep backups of your database and test major config changes on a staging server first.