What is BotchedEconomy?
BotchedEconomy is the in-house economy behind the Botched plugins. Set up as many currencies as you like, each with its own symbol, decimals, starting balance, and limit. Balances are stored as exact decimals, so nobody ever sees $99.99999, and every change is logged with a reason you can look up with /eco history.
It also adds an animated sidebar scoreboard. Boards switch by world, permission, or condition, values flash when money changes, and live lines from BotchedSkills and BotchedMobs show skill levels, clan tags, and dungeon progress. Players can hide it with /sb, and their choice sticks across restarts.
What you can do
Multiple currencies
Coins and Gems out of the box. Add more in config.yml, each with its own format, limits, and payable setting.
Crash-safe storage
Every change is written to a journal the moment it happens and replayed on start, so a crash loses nothing.
Animated sidebar
Multiple boards with shine and wave animations, right-aligned values, and balance change flashes.
Shared by every plugin
BotchedSkills, BotchedMobs, BotchedDurability, BotchedNPCs, and BotchedSkyblock all use one balance. No Vault needed.
Features
- Any number of currencies, each with a symbol, decimals, starting balance, and maximum
- Exact decimal balances, rounded to each currency’s decimals
- Every change logged with a reason, viewable with
/ecohistory /paywith amounts like 500, 1,250, 2.5k, or $40- Confirmation for large payments, a per-payment maximum, cooldowns, and
/paytoggle - Offline players can be paid and get a “while you were away” summary when they join
/baltopwith gold, silver, and bronze for the top three and your own rank on the last line- Animated sidebar boards that switch by world, permission, or condition
- Live sidebar lines from BotchedSkills and BotchedMobs, including dungeon runs
- Steps aside when a minigame gives a player its own scoreboard
- Optional PlaceholderAPI placeholders, including balance and rank for offline players
- Developer API jar with balance, transfer, rank, and transaction events
Commands
| Command | What it does |
|---|---|
/bal [player] [currency] | Show balances and your rank |
/pay <player> <amount> [currency] | Send money |
/pay confirm | Send a payment that is waiting for confirmation |
/paytoggle | Block or allow incoming payments |
/baltop [currency] [page] | Richest players |
/sb | Hide or show your sidebar (also /bsidebar, /bsb, /sidebar) |
/sb list | Every board and which one you see |
| Command | What it does |
|---|---|
/eco give | take | set <player> <amount> | Change a balance |
/eco giveall <amount> | Give everyone who is online |
/eco reset <player> | Back to the starting balance |
/eco history <player> | Recent transactions with reasons |
/eco stats | Money in circulation, average, and richest |
/sb board <id> [player] | Pin a board for yourself or a player |
/eco reload | Reload config, messages, and the scoreboard |
Get started
- Place BotchedEconomy-1.4.3.jar in your server’s plugins folder.
- Restart the server. Every player gets an account the first time they join.
- Set your currencies in plugins/BotchedEconomy/config.yml.
- Edit the boards in scoreboard.yml, or keep the defaults.
- Run
/ecoreload to apply your changes.
With BotchedEconomy installed, prices in the other Botched plugins are paid in coins: each emerald in their configs is worth 10 by default.
Requirements
| Area | Support |
|---|---|
| Server software | Paper 1.21.8 through 26.3, one jar |
| Java | 21 or newer |
| Dependencies | None. Vault support is optional and off by default |
| Optional | PlaceholderAPI |
Latest version
Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.
Bank map support
Works with Paper 1.21.8 – 26.3
- Works with the new Bank map in BotchedZones 1.5.0. Its Bankers and vaults open the same bank menu
- Two new API methods for other plugins:
openBank(Player)andbankers()
- Included with purchase
Earlier versions (4)
Paper 26.3 Banker fix
Works with Paper 1.21.8 – 26.3
- The Banker NPC works on Paper 26.3, where the chain block was renamed
Guide books
Works with Paper 1.21.8 – 26.3
- Player and staff guide books: read them with
/guideor/sb guide, addgivefor a physical copy. Books are never handed out automatically - The staff book needs staff permission, and
guide.ymlupdates live when edited
- Included with purchase
Vault is opt-in and cleaner leaderboards
Works with Paper 1.21.8 – 26.3
- BotchedEconomy no longer takes over Vault by default, so it won’t replace EssentialsX, CMI or similar. Turn it on with
vault.register-as-economy: true - Servers that ran 1.2.0 have the old
vault.enabledsetting removed automatically on start - Leftover clan bank accounts no longer show on
/baltop, the sidebar rankings or the BotchedHub richest-players board - From 1.2.0: optional Vault support, a hard balance limit, every history file replayed after a crash and safe saving on shutdown
- Included with purchase
Sidebar on /sb and offline-player fixes
Works with Paper 1.21.8 – 26.3
- The sidebar now lives on
/sb(also/bsidebar,/bsb,/sidebar), so vanilla/scoreboardworks again /eco give,take,setand/balwork on players who joined before BotchedEconomy was installed- Animated sidebar scoreboard with multiple boards, per-world and per-condition switching
/payconfirmation for large amounts,/paytoggle, and a "while you were away" summary/baltopwith your own rank, plus/eco giveall,/eco historyand/eco stats
- Included with purchase
Screens










