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 (messages_en.yml), Turkish (messages_tr.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

1. Build or download the plugin jar.
2. Place nEconomy-<version>.jar into your server plugins/ folder.
3. Start the server once to generate default configs.
4. Stop server and edit:
   • plugins/nEconomy/config.yml
   • plugins/nEconomy/currencies.yml
   • plugins/nEconomy/converters.yml
   • plugins/nEconomy/withdraw.yml
5. 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>	%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

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.