JPEconomy

The money system for your Paper server: balances, payments, banknotes and as many extra currencies as you want.

Part of JP Plugins, but it works on its own.

Features

Money

• /balance, /pay and /baltop
• Players can turn incoming payments on or off (/paytoggle)
• Money requests: /payrequest Steve 500 sends a clickable pay button
• Banknotes: /withdraw turns money into an item. Each note can only be cashed in once, so a duplicated note pays nothing
• Transaction history for admins

Extra currencies

• Add currencies like gems or tokens in config.yml
• Each one gets its own commands and top list

For server owners

• Vault provider, so every Vault plugin can use it
• Sync between servers over MySQL or Redis
• SQLite or MySQL
• Messages in English, Spanish, Portuguese, French and German, or add your own language
• Balance change event for other plugins

Requirements

• Paper 26.3 or newer (Java 25)

Optional

• Vault: lets other plugins use JPEconomy's money
• PlaceholderAPI: placeholders in texts, and JPEconomy's own placeholders

Installation

1. Put the jar in your server's plugins folder.
2. Restart the server. plugins/JPEconomy/ is created with the config and messages.
3. Change what you want in the files, then use /eco reload or restart.

Type /jp as an operator to see every JP plugin you have installed, its version and which optional plugins it found.

Commands

• /balance [player] (also /bal, /money): Show your balance or another player's.
• /pay <player> <amount>: Send money to another player.
• /payrequest <player> <amount> (also /requestmoney, /payreq): Ask another player for money.
• /paytoggle (also /togglepay): Turn incoming payments on or off.
• /baltop [page] (also /balancetop, /moneytop, /topmoney): The richest players.
• /withdraw <amount> (also /banknote): Turn money into a banknote item.
• /eco <give|take|set|reset|history|reload> (also /economy, /jpeconomy): Economy admin commands.

Permissions

• jpeconomy.balance (everyone): See your own balance.
• jpeconomy.balance.others (everyone): See other players' balances.
• jpeconomy.pay (everyone): Pay other players.
• jpeconomy.payrequest (everyone): Ask other players for money.
• jpeconomy.paytoggle (everyone): Turn incoming payments on or off.
• jpeconomy.baltop (everyone): See the richest players.
• jpeconomy.withdraw (everyone): Create banknotes with /withdraw.
• jpeconomy.banknote.redeem (everyone): Cash in banknotes by right-clicking them.
• jpeconomy.bypass.cooldown (operators): Skip the /pay cooldown.
• jpeconomy.bypass.paytoggle (operators): Pay players who turned payments off.
• jpeconomy.admin (operators): /eco give, take, set, reset, history and reload.

Placeholders

Needs PlaceholderAPI.

• %jpeconomy_balance%: balance as a plain number, e.g. 1234.5
• %jpeconomy_balance_formatted%: balance with the currency sign, e.g. $1,234.50
• %jpeconomy_balance_short%: short balance, e.g. $1.23K
• %jpeconomy_balance_commas%: balance with thousands separators
• %jpeconomy_rank%: position in /baltop (0 = not listed)
• %jpeconomy_accepts_payments%: true / false
• %jpeconomy_top_name_<n>%: name at place n
• %jpeconomy_top_balance_<n>%: formatted balance at place n
• %jpeconomy_<currency>%: balance in an extra currency, e.g. %jpeconomy_gems%
• %jpeconomy_<currency>_formatted%: the same with the currency's sign
• %jpeconomy_<currency>_short%: short form, e.g. 1.2K
• %jpeconomy_<currency>_commas%: with thousands separators
• %jpeconomy_<currency>_rank%: position in that currency's top list
• %jpeconomy_<currency>_top_name_<n>%: name at place n for that currency
• %jpeconomy_<currency>_top_balance_<n>%: balance at place n for that currency

Support

Full docs, the default config and setup guides are on the JPEconomy page of the JP Plugins website. Questions, bugs or ideas? Join the JP Plugins Discord.

License

JPEconomy is free to use on any server, including servers that make money, but it is not open source. Don't reupload, sell or share modified copies of it. The full terms are in LICENSE.txt inside the jar.