Kirri’s Economy

A real bank for your server, for what you really mine.
Accounts of diamonds, emeralds, gold, iron and more · debit cards · ATMs · payment terminals · transfers to anyone · a branch with tellers, guards and a vault

Fabric · Forge · NeoForge | 1.20.1 · 1.21.1 · 26.3 | 18 languages | Needed on the server and on every client

Fabric also needs Fabric API.

There is no money in this mod: no currency, no prices, no interest and no credit. Your account holds the materials you deposited, counted in whole units, and that is all. What you see is what you own.

Walk up to a teller counter, a vault or an ATM and deposit what you carry. The items really leave your inventory and appear in your account, and withdrawing gives them back. Blocks count too: a diamond block goes in as 9 diamonds.

Your balance is a list with the real icon of every material and how many you have. The app has a dark and a light theme.

The tellers greet you when you come close, look at you, count and hand things over. The guards stand at the door and salute. None of them are mobs: they can’t be pushed, killed or lost.

The Bank Deed builds the whole branch in one go: counters, vault, ATMs, guards, marble floor and carpet. It never overwrites a block; it tells you how many are in the way. By default only operators and creative players can use it. Every piece can also be crafted and placed one by one.

Ask for a debit card at the counter. It has your masked number and your name on it, in six designs, with an optional PIN. You can block it and replace it. A card only works for its owner and only if they carry it: a stolen card is useless, even with the right PIN. Three wrong PINs block it until you visit a counter.

ATMs take deposits from anyone. To withdraw at an ATM you need your own card (the server can turn that off).

Send any material to any player, online or offline, with a note. They get a notification and it stays in their history. You can also ask someone for a material: they pay or decline with one click.

Anyone can place a payment terminal and set a price in a material, for example 3 diamonds. Buyers pay from their account with their card, and the owner gets it even when they are offline. If the owner changes the price while you’re deciding, nothing is charged. You can also pay a player directly by using your card on them.

• The bank has no item slots: it takes and gives items directly on the server.
• Every operation has an id: a double click, a resent packet or a reconnect never repeats it.
• Whole numbers with overflow checks. /bank admin verify checks at any moment that every material adds up.
• Saved with the world, with checksummed backups. If the data can’t be read, the bank locks instead of starting from zero.
• Every movement is written to an audit log in the world folder.

config/kirriseconomy.json decides which materials the bank accepts, including items from other mods by their id, and which blocks count as several units. It also sets transfer and card payment limits, PIN attempts, whether ATMs need a card, and who may use the Bank Deed.

Commands: /bank balance, /bank history, /bank pay <player> <item> <count> [note], and /bank admin info | material | verify | reload for operators.

• Fabric 1.20.1, 1.21.1 and 26.3 (needs Fabric API) · Forge 1.20.1, 1.21.1 and 26.3 · NeoForge 1.21.1 and 26.3. On 1.20.1, the Forge file also works on NeoForge.
• Install it on the server and on every client.
• Kirri’s Phone (optional) adds a Bank app to the phone: balance, history, transfers and cards from anywhere. Depositing and withdrawing still need a bank.
• Kirri’s Voice goes well with it, and isn’t needed.

Tested: 293 automatic checks of the bank logic, including stolen cards, PIN guessing, double clicks, fake packets, overflow and full inventories, plus 300,000 random operations where no material is ever created or lost. Real servers on every version, restarted on the same world. A real client on Fabric 1.21.1 and 26.3 playing through every screen, and the game starting with the mod on the other loaders. Played together with Kirri’s Phone and Kirri’s Voice.

Not tested yet: big modpacks, and materials from specific other mods.

Found a bug? Tell us on Discord: https://discord.gg/farurQrxpT