Ultimate Banking System (UBS)

A complete in-game banking ecosystem for Minecraft: ATM workflows, real currency, bank ownership, and central regulation.

!!COMING SOON!!

UBS Banner

Overview Getting Started ATM Flow Bank Owner PC Commands Configuration Migration FAQ

UBS delivers a full economy loop:

PIN-protected ATM banking with multi-account support.
Physical money system with USD bills, cheques, and bank notes.
Player-owned banks with governance, staffing, lending, and compliance.
Central-bank style reserve/rate policy mechanics and operational controls.
In-game desktop Bank Owner PC for GUI-first bank management.

Getting Started (Player)

Create an account, for example: /account create CheckingAccount Central Bank
Open an ATM block.
Select account, then complete PIN flow (set/confirm for first use, enter for existing).
Use ATM actions: balance, withdraw, deposit, transfer, history, settings, pay requests.

Security: PIN must be exactly 4 digits, and account limits/freeze checks are enforced.

ATM Flow

Access sequence:

Open ATM.
Select account (primary is preselected when available).
PIN phase (set if missing, authenticate if set).
Main ATM menu opens.

Withdraw checks:

Ownership, freeze state, per-transaction limit, daily limit, available balance.
Bill denomination dispense feasibility.

Deposit checks:

Ownership + account state checks.
Exact amount representation with bills found in inventory.

Pay Requests

Create from command or ATM UI:

/payrequest <player> <amount> [destinationAccountId]

Incoming requests support Accept, Decline, and Choose Account.
If no primary account is set, payer gets clickable account choices with balance context.
ATM Pay Request UI includes searchable player picker and destination account selection.

Currency & Items

Physical USD bills: $1 $2 $5 $10 $20 $50 $100
Cheque flow for targeted player payment and teller redemption.
Bank Note support for itemized money handling.
Transaction recording for cash and account-side actions.

Bank Owner PC (GUI)

A fullscreen desktop-style interface for owners (OP can access Central Bank app).

Main sections:

Overview, Branding, Limits, Governance, Staffing, Lending, Compliance
Scrollable/clipped layout for reliable GUI behavior
Overview tool cards with deeper subviews (including account profile cards)

Lending market mode:

Sort by Amount, APR, Term, Lender, or Offer ID
Offer cards with Accept Offer confirmation
Copy ID copies full offer UUID

Desktop utilities:

Calculator, Notepad, Paint, File Explorer, System Monitor
Per-PC local storage with limits + app visibility controls
Password-protected desktop session flow

Bank Teller NPC

Teller can process cheque flows to cash or direct account deposit.
Paged account selection (up to 5 per page with navigation).
Owner/op protected removal flow and controlled interaction lifecycle.

Commands (Player + Admin)

Player examples

/account info • /account info list • /account transfer <sender> <receiver> <amount> • /account transaction list <accountUUID> • /bank safebox list • /bank heist start <bankName>

Admin examples (permission level 3)

/ubs admin view <player> • /ubs admin freeze <player> [reason] • /ubs admin applications • /ubs admin appeals • /ubs admin audit <bankName>

Central bank policy examples

/centralbank rate • /centralbank rate set <rate> • /centralbank opm inject <amount> • /centralbank opm withdraw <amount> • /centralbank ledger

Configuration Highlights

UBS exposes config controls for:

ATM limits, per-account daily limits, transaction throttling
Interest intervals, payment schedules, tax/license timing
Federal funds range + savings/money-market rate constraints
Reserve requirements, liquidity behavior, bank-run controls
Player bank creation gates, fees, cooldowns, ownership caps
HUD display options and currency symbols

Migration / Import

Supported import sources:

CSV
EssentialsX userdata
CMI userdata
iConomy exports

Commands:

/ubs admin import csv <path> • /ubs admin import essentialsx <path> • /ubs admin import cmi <path> • /ubs admin import iconomy <path>

FAQ / Troubleshooting

Q: Why are some systems tick-based?
A: Daily resets and lifecycle jobs are server-side scheduled systems; tune intervals in config for your economy scale.

Q: Why does market accept fail?
A: Offer may be expired/not open, or access/eligibility checks failed. Use copied full offer UUID.

Q: Why no apps on Bank Owner PC?
A: App visibility is tied to ownership/roles and current config. OPs can access Central Bank app.

Q: Can players run multiple banks?
A: Yes, up to your configured per-player maximum.