BankSystem

Bank System Mod

About

BankSystem is a Minecraft mod that adds a full banking system to the game. Every player gets an account that can hold money and items, with support for shared accounts, per-user permissions, redstone automation, in-world balance displays, and an interactive balance-history chart. Players can found companies, hire workers, mint physical share items, pay wages on a schedule and hand out dividends to shareholders. The Bank Terminal includes a full crafting grid that can pull ingredients directly from your account, and individual slots can be bound to third-party currency mods so a single balance is shared across every system that touches it. Ideal for multiplayer servers with active economies, and the financial backbone for the Stock Market Mod.

Version 2.1.0 is a TEST VERSION. It ships major new systems — companies with workers, physical shares, the Share Stamper block, recurring payouts and dividends, a company statistics dashboard, plus the external-currency-mod binding SPI (Numismatics and Lightman's Currency) and the in-game Mod Settings screen — none of which have been fully tested in production. Expect bugs. Feedback and bug reports are welcome on GitHub. Do not use on production servers without backups. Stable release: v1.4.1.

Features

Bank Accounts

• Personal and shared bank accounts holding both money and items in the same slot list.
• Per-user permissions — Deposit, Withdraw, and Manage, mixed and matched per account and per member.
• Shared accounts always keep at least one manager — the last user cannot be removed by accident.
• Money system with 21 denominations — cent coins (1¢, 5¢, 10¢, 20¢, 50¢), a $1 coin, everyday notes ($5, $10, $20, $50, $100, $200, $500, $1000) and a high-value tier for large economies ($5K, $10K, $20K, $50K, $100K, $500K, $1M). Each has its own artwork, converts into its neighbours in a crafting grid, and is placeable as a decorative block.
• Configurable allowed-items list prevents the bank from being used as infinite storage.

Bank Terminal

• Deposit and withdraw money and items from a single screen.
• Full 3×3 crafting grid inside the terminal that can source missing ingredients from your bank account and auto-deposit the crafted output.
• JEI integration — the "+" button on any recipe fills the grid, and clicking any item in the bank list looks up its recipes and applies the best one your bank can satisfy.
• Item filter box narrows the balance list by name or tag.
• The terminal remembers your last-selected account across every terminal on the server.
• Interactive balance-history chart with zoom, pan, tag-based search, and per-item series filters that persist across sessions.

ATM & Automation

• ATM block — withdraw money as specific note denominations.
• Bank Upload and Bank Download blocks — redstone-powered automation that connects to hoppers, pipes, and modded item conduits on a configurable interval.
• Coin-variant deposits are routed to the account's money slot at the currency mod's live face value — no per-variant sub-accounts are created.

Companies

• Found a company with /company create <name> <maxSupply> — it gets its own shared bank account with you as founder.
• Company Management screen with seven tabs — Overview, Workers, Payouts, Shares, Market, Statistics and a founder-only Danger Zone.
• Hire workers straight from the Workers tab with per-user Deposit / Withdraw / Manage toggles; founders can never be locked out of their own company.
• Recurring wages and one-time payouts — pick a target, an amount, a currency (money or any item) and an interval. Missed runs are listed with a per-row retry.
• Dividends — pay every shareholder a per-share amount in one all-or-nothing run; the run is refused outright if the company can't cover it.
• Statistics dashboard — cashflow chart over 24 h / 7 d / 30 d / 90 d / all-time, balance, net cashflow, days-to-insolvency estimate, missed payouts, and a live shareholder table.
• Transfer the founder role or dissolve the company from the Danger Zone, both behind typed confirmation.

Shares

• Blank Share item (paper + leather) and the Share Stamper block that turns blanks into Stamped Shares of a specific company.
• Share Stamper runs continuously until you stop it, the input runs out, the output fills, or the company hits its maximum supply — with optional hopper auto-input and auto-output, each behind its own permission-gated toggle.
• REDEEM mode runs the stamper backwards, burning shares and freeing supply again.
• Share Visual editor — design your company's share card from a card colour plus a two-layer symbol design, with a live preview. 45 bundled pixel-art symbols, and server operators can drop in their own PNGs, which reach clients without a resource-pack reload.
• Stamped shares render their full card art everywhere — inventory, hand, on the ground and in item frames — and their tooltip shows the company, its description and a live issued / max supply count.
• Shares of different companies never stack together; shares of the same company do.
• With StockMarket installed, the Market tab opens a real tradeable market for your company's shares.

Bank Displays

• Configurable in-world display showing a live balance overview grid or a balance-history line chart for any account.
• Adjacent displays automatically link into a multi-block screen and inherit configuration from neighbors on placement.
• Chart colors are derived per item from the item's own texture for a distinct look per market.

Currency Mod Bindings

• Bind any bank slot to an external currency mod's account. Supported are:
  • Numismatics
  • Lightman's Currency.
• Every deposit, withdrawal, and StockMarket trade routes through the bound account transparently.
• Coin variants auto-convert at the mod's live face value — Numismatics spurs / bevels / sprockets / cogs / crowns / suns and Lightman's copper / iron / gold / emerald / diamond / netherite coins.
• Locked-balance protocol keeps pending StockMarket orders intact across bind and unbind.
• Unbind offers a three-way choice — keep funds on BankSystem, keep them on the external provider, or cancel.
• Public ExternalCurrencyProvider SPI lets third-party mod authors add more providers via Architectury service loader.

Administration

• In-game Mod Settings screen for server admins (master only) — every settings.json value editable with validation, no more manual file edits.
• Dedicated BankSystem-admin permission flag gates settings, allowed-item list, and slave-trust access.
• Transaction ledger records every deposit, withdrawal, transfer, payout, dividend and share stamp — the data behind the statistics dashboard and the payout history.
• /banksystem symbols admin commands to add, remove, list and reload the server's share-symbol library.
• ItemID merge guard, monotonic short counter, and world-format versioning protect world data against silent corruption from mod updates or downgrades.
• TerraFirmaCraft-compatible item identity — banked food no longer spoils inside the account, and spoiled items can't be laundered into fresh ones.

Multi-Server

• Master/slave architecture for server networks — one master holds authoritative balances, slave servers forward requests.
• Trust-based access control — untrusted slaves are read-only, trusted slaves can write. Admins toggle trust with /banksystem trust <slaveID>.
• Master is the sole ItemID minter so mixed-mod setups can never desynchronise item identities.
• Mixed-mod slaves hide items they can't resolve — no more broken "air" rows in the terminal or chart.

API for Developers

• Sync and async interfaces for bank accounts, banks, and the bank manager, exposed through BankSystemAPI for other mods.
• ItemPriceProvider API — external mods can supply market prices for total-wealth tracking.
• ExternalCurrencyProvider SPI — third-party currency mods plug in via Architectury service loader.
• Company APIs — payout manager, dividend payer, share-visual lookup and share-icon renderer, all exposed through BankSystemAPI.
• Full event and signal system for dependent mods — user, account, ItemID-merge, and multi-server lifecycle events, documented in documentation/developer-guide/EventsAndSignals.md.

What's new since 1.4.1

The 1.4.1 → 2.1.0 window spans the entire 2.0.x line plus the company update. Highlights, grouped by area:

Companies & Shares (new in 2.1.0)

• /company create, /company info and /company manage — companies with their own bound bank account and an immortal-founder rule.
• Company Management screen with Overview, Workers, Payouts, Shares, Market, Statistics and Danger Zone tabs.
• Recurring and one-time payouts in money or any item, with a live countdown, failure reasons, payout history and a Pay Missed retry popup.
• Dividends to every shareholder in one atomic, all-or-nothing run, in any currency the company holds.
• Blank Share and Stamped Share items, plus the Share Stamper block with continuous stamping, redeem mode and optional hopper automation.
• Share Visual editor — card colour, two symbol layers, display name and description, with a live preview and a 45-symbol bundled library that server operators can extend with their own PNGs.
• Statistics dashboard — cashflow chart, headline metrics, solvency estimate and a shareholder ranking.
• Transaction ledger behind it all — every deposit, withdrawal, transfer, payout, dividend, stamp and share trade is recorded.
• StockMarket bridge — open, pause and close a real market for your company's shares from the Market tab.
• Autosave interval is now seconds-based (default 5 s), closing an item-duplication window on server crashes. Servers with a custom SAVE_INTERVAL_MINUTES must re-set it as SAVE_INTERVAL_SECONDS.

Bank Terminal & UI

• Balance-history chart with zoom, pan, tag-based search, and per-item series filters.
• 3×3 crafting grid inside the Bank Terminal with full JEI recipe-transfer support on Fabric, NeoForge, and Quilt.
• Filter box above the item list; JEI's item panel now sits beside the terminal instead of overlapping it.
• Bank Terminal remembers your last-selected account across every terminal on the server.
• Account picker can list accounts you lack rights on as grayed-out with an exact "missing rights" tooltip.
• Shared accounts can no longer be orphaned by removing the last managing user.

Blocks & Displays

• Bank Display block with live balance-overview and history-chart modes, auto-linking multi-block screens.
• Money items are now placeable as decorative stockpile blocks.
• Refreshed pixel-art textures for every block and item.

Currency Mod Support

• Numismatics adapter — bind personal (PLAYER) and shared (BLAZE_BANKER) accounts to BankSystem slots.
• Lightman's Currency adapter — bind personal and team accounts with primary-chain routing for LC's multi-chain MoneyValue model.
• Coin-variant auto-conversion at deposit time — every denomination in the currency mod's chain credits the bound money slot at its live face value.
• Bindings screen reachable from account management, with a full picker for provider → account → confirmation flow.
• Fresh accounts auto-seed a slot for every registered currency provider's base currency.
• Public ExternalCurrencyProvider SPI with Architectury service-loader discovery for third-party adapters.

Administration

• In-game Mod Settings screen on the master server — every setting editable with typed inputs, server-side validation, and "⟳ Restart required" markers.
• BankSystem-admin permission flag gates settings and management access instead of relying on operator level alone.
• Trust-based writes for slave servers — untrusted slaves are locked to reads; deposit, withdraw, and account edits are rejected at the master.

Multi-Server Hardening

• Master is now the sole ItemID minter — slave servers never assign shorts locally, closing every cross-server ID divergence class for mixed-mod setups.
• Items shared between master and slave travel by stable resource name instead of per-startup registry slots — first-time slave connections no longer render wrong item names.
• Mixed-mod setups hide items the local server can't resolve — no broken "air" rows.
• Rejected operations now tell the affected player why instead of failing silently in the master's log.
• New lifecycle events for dependent mods — slave-connected, slave-disconnected, and trusted-slaves-changed.

World-Data Safety

• World-format versioning — newer-mod saves are refused by older builds before anything is loaded or mutated.
• ItemID merge guard — identity-set changes that would collapse distinct bank items now require admin confirmation at startup with a full merge report.
• Monotonic ItemID counter — dropped shorts stay reserved for the lifetime of the world so downstream data can never be silently rebound to an unrelated item.
• Corrupted-world detection and one-shot repair path for the pre-2.0.3 ItemID load-order bug, with a full audit trail.
• Alias-table auto-heal at load; alias insertions guarded at write time with a stack-trace-annotated ERROR log on violation.

Item Identity

• Volatile item components — datapack tag and config list strip components from bank item identity, so mods like TerraFirmaCraft can rewrite food creation dates without corrupting bank entries.
• Deposit-gated components — spoiled items can no longer be laundered into fresh ones; the deposit check uses the game's own component-aware stack equality.

API

• ItemPriceProvider API and setPriceCurrencyItem for total-wealth tracking.
• Per-user custom data field on the User object with sync via ARRS.
• ExternalCurrencyProvider SPI and unregisterCurrencyProvider primitive.
• IBankSystemEvents.getItemIDsMergedEvent() for dependent mods to reconcile after a merge.
• Slave-connection, disconnect, and trust-change events, plus a full developer guide in documentation/developer-guide/EventsAndSignals.md.
• AND-permission account picker for dependent mods (hasAllPermissions + requireAllPermissions).

Full per-version changelog: changelog/.

Please visit the repository for full documentation

Bank System Mod Repository

Dependencies

• Architectury
• Fabric API (Fabric only)
• Mod Utilities (Quilt only — bundled inside the jar on Fabric and NeoForge)
• Quilted Fabric API (Quilt only)

Bank Terminal — deposit, withdraw, and craft in one screen.

Create a bank account and deposit into your own account.

Account management — permissions, users, and settings per account.

ATM Block — withdraw money as specific note denominations.

Bank Displays — live balance overview or history chart, in-world.

Money Stockpile — place money items as decorative blocks.

Bank Upload / Download blocks — redstone-powered automation.

Currency Mod Bindings — one balance across BankSystem, StockMarket, and the currency mod.

Pick a provider, then pick an account — personal or shared.

Bound slots and unbind flow — three-way choice on where funds stay.

Coin-variant auto-conversion at the deposit terminal.

In-game Mod Settings — edit every server setting from the bank management window (master only).

Companies — overview, workers and payouts in one control centre.

Share Stamper — turn blank shares into your company's shares.

Share Visuals — design the card, pick two symbol layers, see it live.

Multi-Server — share bank accounts across a network of connected servers.