Minecraft Plugin · Available

BotchedEconomy

Your server’s own money: multiple currencies, crash-safe storage, payments with confirmation, and an animated sidebar scoreboard that every Botched plugin shares.

Discuss on the forum
Website downloads
0
BotchedEconomy artwork
Platform
Paper 1.21.8 – 26.3
Java
21+
Version
1.4.3
Requires
Nothing else
Overview

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.

Highlights

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.

Everything included

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 /eco history
  • /pay with 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
  • /baltop with 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
Reference

Commands

Player commands
CommandWhat it does
/bal [player] [currency]Show balances and your rank
/pay <player> <amount> [currency]Send money
/pay confirmSend a payment that is waiting for confirmation
/paytoggleBlock or allow incoming payments
/baltop [currency] [page]Richest players
/sbHide or show your sidebar (also /bsidebar, /bsb, /sidebar)
/sb listEvery board and which one you see
Admin commands
CommandWhat 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 statsMoney in circulation, average, and richest
/sb board <id> [player]Pin a board for yourself or a player
/eco reloadReload config, messages, and the scoreboard
Setup

Get started

  1. Place BotchedEconomy-1.4.3.jar in your server’s plugins folder.
  2. Restart the server. Every player gets an account the first time they join.
  3. Set your currencies in plugins/BotchedEconomy/config.yml.
  4. Edit the boards in scoreboard.yml, or keep the defaults.
  5. Run /eco reload 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.

Compatibility

Requirements

AreaSupport
Server softwarePaper 1.21.8 through 26.3, one jar
Java21 or newer
DependenciesNone. Vault support is optional and off by default
OptionalPlaceholderAPI
Updates

Latest version

Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.

v1.4.3Latest

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) and bankers()
  • BotchedEconomy-1.4.3.jarUniversal build · Java 21 · 239.6 KBIncluded with purchase
Earlier versions (4)
v1.4.2

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
v1.3.0

Guide books

Works with Paper 1.21.8 – 26.3

  • Player and staff guide books: read them with /guide or /sb guide, add give for a physical copy. Books are never handed out automatically
  • The staff book needs staff permission, and guide.yml updates live when edited
  • BotchedEconomy-1.3.0.jarUniversal build · Java 21 · 169.8 KBIncluded with purchase
v1.2.1

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.enabled setting 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
  • BotchedEconomy-1.2.1.jarUniversal build · Java 21 · 146.4 KBIncluded with purchase
v1.1.1

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 /scoreboard works again
  • /eco give, take, set and /bal work on players who joined before BotchedEconomy was installed
  • Animated sidebar scoreboard with multiple boards, per-world and per-condition switching
  • /pay confirmation for large amounts, /paytoggle, and a "while you were away" summary
  • /baltop with your own rank, plus /eco giveall, /eco history and /eco stats
  • BotchedEconomy-1.1.1.jarUniversal build · Java 21Included with purchase