Skip to content

Player Guide

Jump to bottom
NadirKhoulali edited this page Jun 3, 2026 · 11 revisions

Player Guide

Getting Started

  1. Create an account:
    • /account open checking "Central Bank" - Creates a checking account at the named bank. Replace checking with another supported account type when available, and replace Central Bank with the exact bank name you want to join.
  2. Open an ATM block.
  3. Select an account.
  4. Complete PIN flow:
    • first-time account: set + confirm a 4-digit PIN
    • existing account: enter PIN

ATM Features

  • Balance inquiry
  • Cash withdrawal (whole dollars)
  • Cash deposit (bills + coins, exact inventory match)
  • Transfer funds
  • Transaction history
  • Account settings
  • Pay requests (inbox + create)

Pay Requests

Send request:

  • /account payrequest <player> <amount> [destinationAccountId] - Sends a payment request to another online player. If destinationAccountId is provided, the payment is routed to that account; otherwise UBS uses your default receiving account.

Receive request:

  • If you have a primary account, chat offers Accept, Decline, Choose Account.
  • If you do not have a primary account, UBS provides clickable account options with balances.

ATM side:

  • open Pay Requests
  • review incoming requests
  • accept/decline or choose a specific paying account
  • create outgoing requests from the same menu

Physical Cash Rules

Withdraw:

  • ATM dispenses bills only ($1, $2, $5, $10, $20, $50, $100).
  • Overflow follows normal item-drop behavior.

Deposit:

  • UBS scans inventory/offhand for legal tender cash items (bills + coins).
  • Deposit requires exact denomination fit for requested amount.

Bank Teller:

  • Teller cash-out can dispense bills + coins.
  • Teller withdrawal limit can be configured per bank (teller bank limit type).

Legal tender list with textures:

Payment Terminal

  • Place payment_terminal block for merchant checkout.
  • Right-click to pay.
  • Shift + right-click opens config (owner/OP only).
  • Terminal payment source:
    • held valid credit card account, else primary account.
  • Result feedback:
    • success/denied display state with temporary interaction lock.
  • Optional redstone output for success/failure/idle.

Handheld mode:

  • Use handheld_payment_terminal to charge players directly.
  • While aiming at a player with handheld equipped, HUD panel shows amount + target.
  • Right-click player to charge that player.
  • Shift + right-click to open handheld terminal config.
  • Handheld has no redstone output controls.

Full guide:

Retail and Shop Systems

New retail surfaces include shelves, display tables, coolers, modular displays, shopping baskets/bags, pallets, and cashier NPC workflows.

High-level loop:

  1. Browse shelf/display stock.
  2. Add/remove items with basket flow.
  3. Checkout via cashier/terminal.
  4. Funds settle through UBS account/payment systems.

The desktop shop app also supports stockroom claims, pallet assignment, order flows, permissions, lighting/hours controls, and webshop/courier workflows.

See:

Pickpocket

  • Client keybind defaults to Shift + F (rebindable key + Shift safety modifier).
  • Players can opt in/out:
    • /account pickpocket toggle - Switches your pickpocket participation on or off. If disabled, you cannot be pickpocketed and cannot pickpocket others.
    • /account pickpocket status - Shows whether your pickpocket participation is currently enabled or disabled.

If disabled, you are immune and also cannot pickpocket others.

HUD and Safe Box

  • /account hud toggle - Turns the on-screen UBS balance HUD on or off for your client.
  • /account hud primary - Makes the HUD follow your current primary account balance.
  • /account hud account <accountId> - Makes the HUD follow one specific account UUID. Use this if you manage multiple accounts and want one account shown at all times.
  • /account safebox list - Shows the items currently stored in your UBS safe box.
  • /account safebox deposit - Deposits the item you are holding into the next available safe box slot.
  • /account safebox withdraw <slot> - Withdraws the item stored in the selected safe box slot back to your inventory.

World Cash Economy

Depending on server config, UBS can add:

  • structure chest cash loot
  • cash drops from mobs/villagers
  • forced percentage cash drop on player death

Limits and Security

  • PIN must be exactly 4 digits.
  • per-transaction ATM limit applies
  • daily ATM withdrawal limits apply
  • frozen accounts cannot withdraw, deposit, or transfer

Useful Commands

  • /account info - Shows details for your primary account, including bank, account ID, type, balance, creation date, and clickable shortcuts.
  • /account info list - Lists all accounts you own, marks the primary account, and provides copy/open actions for account IDs.
  • /account transfer <senderAccountUUID> <receiverAccountUUID> <amount> - Moves money from one account UUID to another. You must be allowed to use the sending account, the amount must be positive, and frozen accounts cannot transfer.
  • /account transaction list <accountUUID> - Shows the transaction history for the selected account. Entries can be clicked to open the full transaction details.
  • /account shop pay <amount> [shop] - Pays a shop or merchant from your held valid credit-card account, or from your primary account if no usable card is held. If [shop] is a UUID, UBS treats it as a merchant account ID; otherwise it is used as a shop label.
  • /bank reserve - Shows reserve, deposits, minimum reserve, reserve ratio, daily cap, daily used amount, and remaining daily capacity for your owned bank or current bank context.
  • /bank dashboard - Shows a bank-owner liquidity dashboard with status, risk level, reserve shortfall, lending capacity, queued withdrawals, and Federal Funds Rate.
  • /bank heist start <bankName> - Placeholder command for the future heist system. It currently reports that heists are coming soon.

Clone this wiki locally