Skip to content

Repository files navigation

Bank System Mod

About

BankSystem is a Minecraft mod that adds a full banking system to the game. Players get a bank account that can hold money and items. Create shared accounts with permissions, automate item transfers with redstone, and monitor balances on in-world displays. Connect multiple servers to share bank accounts across your network.

You want to support me?
"Buy Me A Coffee"


Chapters


Features

  • Bank accounts for money and items with deposit, withdrawal, and transfer support
  • Built-in crafting grid in the Bank Terminal that can pull missing ingredients from the bank and deposit crafted items back automatically
  • Shared bank accounts with per-player permissions (deposit, withdraw, manage)
  • ATM block for withdrawing specific bank note denominations
  • Bank Upload / Download blocks for redstone-powered automation with hoppers and pipes
  • Bank Display blocks that show live balance overviews or history charts
  • Money system with coins and bills that can be placed as decorative blocks
  • Companies — found a company with its own bank account and workers, mint physical shares with the Share Stamper, design the share card, and pay dividends or recurring wages on a timer
  • Multi-server support to share bank accounts across connected servers
  • Currency mod bindings — link a bank slot to an external currency mod's account (Numismatics, Lightman's Currency) so BankSystem, StockMarket, and the currency mod share one balance
  • Mod API for developers to integrate with the banking system

Installation

  1. Install Architectury API and the mod loader API for your platform:
  2. Download the BankSystem jar for your Minecraft version and mod loader from CurseForge or the Downloads table below.
  3. Place the jar in your mods/ folder and launch the game.

Downloads

CurseForge

Minecraft Fabric Forge Quilt Neoforge
Minecraft Version Version Version Version Version
Minecraft Version Version Version
Minecraft Version Version Version
Minecraft Version Version Version Version
Minecraft Version Version Version Version
Minecraft Version Version Version Version
Minecraft Version Version Version
Minecraft Version Version Version Version
Minecraft Version Version Version Version

Usage

Bank Terminal Block

The Bank Terminal Block is used to deposit/withdraw items to/from the bank account. A Filter box above the bank item list helps you find items quickly.

The terminal also features a built-in 3×3 crafting grid that supports all standard crafting recipes. Enable Use Bank Items to pull missing ingredients straight from the selected bank account, and Auto-deposit output to send crafted items directly back into the bank. With JEI installed, recipes can be filled into the grid with one click. See Block Usage for details.

Note

The block contains an inventory which is unique for every player. Like an ender chest, but when the block gets destroyed, items not stored in the bank account will be dropped.


ATM Block

The ATM Block lets you withdraw money as specific bank notes.


Automation Blocks

The Bank Upload Block and Bank Download Block connect to your bank account and allow automated item transfers via redstone signals. They can be connected to pipes and hoppers.

For detailed usage of all blocks, bank accounts, and administration, see the Documentation section.


Money Stockpile

Money items can be placed in the world as decorative blocks. Each denomination has its own block model. The blocks can also be used for physical storage of money outside the banking system.


Bank Displays

The Bank Display block shows live bank account data on its screen. Right-click to open the configuration screen, where you select a bank account and one of two display modes:

Display Mode Description
Balance History A line chart tracking balance changes over time for all items in the account. Each item is color-coded with a legend on the right. Updates every 60 seconds.
Balance Overview A compact grid showing the current balances of the highest-value items in the account. Displays item icons with their amounts. Updates every second.

Currency Mod Bindings

BankSystem can link an item slot on a bank account to an external currency mod's account. Once bound, every deposit, withdrawal, or StockMarket trade routed through BankSystem moves the same balance on the other mod's side — no manual migration needed.

Supported currency mods out of the box:

Currency mod Fabric NeoForge Quilt
Numismatics
Lightman's Currency

Open a bank account's management screen and press Bindings to pick a slot, choose a provider, and select which of your external accounts to link. Personal BankSystem accounts bind to personal external accounts; shared BankSystem accounts bind to co-owned external accounts (Numismatics Blaze Bankers, Lightman's teams). Every coin denomination in the chain deposits into the same bound slot.

See the Currency Bindings guide for the full walkthrough, per-provider notes, and troubleshooting. Currency-mod authors who want their mod to appear in the picker can consult the Currency Integration developer guide.


Mod Settings Screen

Server admins can edit the mod's settings.json in-game, without touching the file:

  1. Run /banksystem manage (admin only) to open the banking settings window.
  2. Click Mod Settings.

The screen lists every setting of the mod, grouped by category (Utilities, Player, Bank, TAB Placeholders), with a matching editor per setting type (checkboxes, number fields, text fields). Apply validates and saves the values on the server (out-of-range values are clamped and the corrected values are shown), Reload re-fetches the current server state and Defaults resets the fields to the built-in defaults (nothing is saved until Apply is pressed).

Notes:

  • Master-only: the button is only shown when you are connected to the master server (or a regular single server). Only the master's settings.json can be edited; the server additionally rejects requests from non-admins regardless of the UI.
  • Permission: requires BankSystem admin status (the same permission as the other /banksystem admin commands).
  • Restart markers: settings that are only read once at server startup show an orange "⟳ Restart required" marker — the change is saved immediately but only takes effect after a server restart. This includes the volatile/deposit-gated component lists and the one-shot CONFIRM_ITEMID_MERGE / CONFIRM_ITEMID_REPAIR flags, which can be armed from this screen to approve a pending ItemID merge or world repair on the next restart.

Blocks

Block Description
Metal Case Block Casing for the Terminal block.
Terminal Block Unprogrammed terminal. Can be programmed using a software item.
Bank Terminal Block Used to access the bank account. Right click on a Terminal Block using a Banking Software to create this block.
ATM Block Used to withdraw money. Right click on a Terminal Block using an ATM Software to create this block.
Bank Upload Block Sends items to a bank account. Can be connected to pipes and hoppers. Needs redstone power.
Bank Download Block Receives items from a bank account. Can be connected to pipes and hoppers. Needs redstone power.
Bank Display Displays bank account information on its screen. Can show a balance overview or balance history chart. Right-click to configure.
Share Stamper Mints a company's physical shares. Right-click it once to bind it to a company, then it converts Blank Shares into Stamped Shares — or back again in Redeem mode. Auto-input / auto-output make it hopper- and pipe-friendly.

Items

Item Description
Circuit Board Electronics component for other items.
Display Display for the Terminal Block.
Empty Software Base software, used to create specific software variants.
Banking Software Programs a Terminal Block into a Bank Terminal Block.
ATM Software Programs a Terminal Block into an ATM Block.
Bank Transmitter Module Component for the Bank Upload Block.
Bank Receiver Module Component for the Bank Download Block.
Blank Share Unstamped share certificate. Feed it to a Share Stamper to turn it into a share of that stamper's company.
Stamped Share A physical share of a company. Carries the company's name, card design and live issued/max supply in its tooltip, can be deposited like any other item, and right-clicking it opens that company's management screen.

Money

Money includes cent coins (1¢, 5¢, 10¢, 20¢, 50¢), a $1 coin, everyday notes ($5–$1000) and a high-value tier for large economies ($5K, $10K, $20K, $50K, $100K, $500K, $1M) — 21 denominations in all. Each has its own colour and artwork, as shown above. All denominations can be converted between each other using the crafting table. Money can also be placed in the world as decorative blocks. The server administrator controls how money enters circulation. See Money Conversions for crafting recipes.


Commands

Key commands for players and admins:

Command Description
/money Show your money balance
/money send <user> <amount> Send money to another player
/bank Show your full bank balance (money and items)
/bank manage Open the bank account management GUI
/bank create <accountname> Create a new bank account
/banksystem manage Open the banking settings (admin only)
/company create <name> <maxSupply> Found a company and its bank account
/company info <name> Print a company's details to chat
/company manage <name> Open the Company Management screen
/banksystem symbols list|add|remove|reload Manage the share symbol library (admin only)

For the full command reference, see Commands.


Documentation

Detailed guides are available in the documentation folder:

For Mod Users:

  • Block Usage — How to use the Bank Terminal (including its crafting grid), ATM, automation blocks, bank displays, and money stockpiles
  • Bank Accounts — Shared accounts, creating accounts, permissions
  • Companies — Found a company, hire workers, mint shares with the Share Stamper, pay dividends and recurring payouts
  • Currency Bindings — Link a bank slot to a Numismatics or Lightman's Currency account
  • Administration — Managing banking items, player accounts, locked amounts
  • Configuration — Per-world settings.json reference; volatile & deposit-gated item components
  • Multi-Server Setup — Master-slave architecture for cross-server banking
  • Commands — Full command reference

For Mod Developers:


Crafting Recipes

Components

Empty Software Circuit Board Display

Software

Banking Software ATM Software

Modules

Bank Transmitter Module Bank Receiver Module

Blocks

Metal Case Block Terminal Block
BankSystem Display Block Bank Upload Block
Bank Download Block

Company

Share Stamper Blank Share

Money Conversions

Every denomination converts into its neighbours in an ordinary crafting grid, in both directions, all the way from 1¢ up to $1,000,000. Two recipes stand for the whole chain:

Combine — 5 × $1 into $5 Split — $5 back into 5 × $1

Every other denomination follows the same idea. There are over a hundred conversion recipes in total, so they are not all reproduced here — look an item up in the in-game recipe book, or in JEI if you have it installed, to see every way to craft it.


Changelog

All notable changes are documented in version-specific files under changelog/.

Current

  • 2.1.1 — In Development · Bugfix development
  • 2.1.0 — Released 2026-08-15 · Company system — found companies, hire workers, mint physical shares, pay dividends and recurring payouts, track it all on a live statistics dashboard

Previous

  • 2.0.7 — Released 2026-07-29 · Balance history overhaul (timescale toolbar, tiered retention, chart polish), ATM Money Converter tab, 5k–1M banknote tier, backup subcommands
  • 2.0.6 — Released 2026-07-27 · Ecosystem polish — Bank Terminal live updates, pipe/hopper integration, JEI dev-runtime fix, allow-all-items setting
  • 2.0.5 — Released 2026-07-25 · External currency bindings (Numismatics + Lightman's Currency)
  • 2.0.4 — Released 2026-07-21
  • 2.0.3 — Released 2026-07-14
  • 2.0.2 — Released 2026-06-07
  • 2.0.1 — Released 2026-05-21
  • 1.5.0_ALPHA_3 — Security & stability: 50 fixes across permissions, async, concurrency, block entities
  • 1.5.0_ALPHA_2 — Trusted slave servers, package reorganization, UI improvements
  • 1.5.0_ALPHA_1 — Initial alpha

Stable

  • 1.4.1 — Stable (CurseForge)
  • 1.4.0
  • 1.3.0
  • 1.2.0
  • 1.1.0
  • 1.0.0 — Initial release

About

No description, website, or topics provided.

Resources

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages