WhiteLabelEconomy

Features

• Multi-currency economy
• Configurable currency names, symbols, decimals, and starting balances
• White-label branding through config.yml and messages.yml
• Fully editable player-facing messages
• Player-to-player payments
• Configurable transfer taxes with percentage and flat fees
• System tax collector account, such as system:tax
• Currency exchange with configurable rates and exchange fees
• Admin commands to set, give, and take balances
• Flatfile balance storage
• Unit-tested economy core

Commands

Player commands:

• /eco help
• /eco balance [player] [currency]
• /balance [player] [currency]
• /bal [player] [currency]
• /money [player] [currency]
• /pay [currency]
• /eco pay [currency]
• /eco exchange <from_currency> <to_currency>
• /eco currencies

Admin commands:

• /eco admin set [currency]
• /eco admin give [currency]
• /eco admin take [currency]
• /eco reload

Permissions

wle.balance, wle.balance.others, wle.pay, wle.exchange, wle.admin, wle.reload

White-label configuration

You can change the economy name, message prefix, colors, currency names, symbols, decimals, starting balances, and all player-facing messages without recompiling the plugin.

Example currency configuration:

currencies: coin: singular: "Coin" plural: "Coins" symbol: "⛃" decimals: 2 starting-balance: "100.00" gem: singular: "Gem" plural: "Gems" symbol: "◆" decimals: 2 starting-balance: "0.00"

Installation

1. Download the plugin jar.
2. Place it in your Paper server's plugins folder.
3. Start the server once.
4. Edit config.yml and messages.yml.
5. Run /eco reload or restart the server.

Compatibility

Built against Paper API 1.20.4 and Java 17.

Current limitations

This is an early functional release. Vault, PlaceholderAPI, SQL storage, and persistent transaction audit history are not included yet. Real command aliases still come from plugin.yml, while branding, messages, and currencies are white-label configurable.