BankMOD|银行模组/支付模组

Project Title: BankMOD

Summary: A fully-featured banking and payment system for Minecraft. Manage your money with bank cards, ATMs, POS machines, and a mobile wallet app.

Description:

What does BankMOD do?

BankMOD adds a complete financial system to your Minecraft server. Players can:

· Get bank cards and manage multiple cards per account · Use ATMs to deposit (Emerald → balance) and withdraw (balance → Emerald) · Pay at POS machines with merchant-set prices · Use a Mobile Wallet App to check balances, transfer money, bind cards, and pay with NFC · Set a wallet password and enable small-amount no-PIN payments · Auto-create accounts on first use

Why download BankMOD?

· Realistic banking experience – Designed to mimic real-world banking with cards, ATMs, POS machines, and mobile payments. · Convenient and flexible – Transfer money by player name or card number. Set a default card for quick payments. · Secure – Wallet password protection, PIN verification, and a three-strike lockout for ATM operations. · Admin-friendly – Full set of admin commands for balance management, card issuance, and account lock/unlock.

Important information before downloading:

· Server-side mod only – This mod runs on the server. Clients do not need to install it. · OP required for card issuance – Players cannot create cards themselves; admins must issue cards via /bankadmin newcard. · Data storage – All data is stored in config/bankmod/ as JSON files. Data is world-specific and does not cross servers. · Compatibility – Currently supports Fabric 1.20.1. Forge support is planned. · MTR integration – Planned for future releases. · No client-side rendering – The wallet app and ATM interfaces are server-side GUI screens.

License: MIT Support: Niu_Roubing

BankMOD Banking Mod — Player Guide

1. Item & Block Functions

Bank Card: Right-click to check balance and card status. Hold the card and right-click an ATM or POS terminal to perform financial operations. Each card has an independent 16-digit card number and a 6-digit payment PIN.

Mobile Phone: Right-click to open the wallet APP, supporting card list viewing, fund transfers, card binding, default card setup, small-amount password-free payment toggle, and wallet password modification.

ATM Machine: Insert card → Verify PIN → Main Menu (Withdraw / Deposit / Check Balance / Eject Card / Terminate Card). Sneak + right-click to claim ownership (you will gain full management access to this ATM after binding).

POS Terminal: Merchants bind their own bank card first → Customers hold a bank card or mobile phone and right-click to pay. Merchants can set product names and fixed prices; customers may pay the set price or enter a custom amount.

Card Dispenser: Right-click to instantly obtain a new bank card, with a prompt to set a 6-digit payment PIN (this step can be skipped and configured later at an ATM). Each player may hold a maximum of 10 bank cards.

2. Crafting Recipes

Mobile Phone [Iron Ingot] [Redstone] [Iron Ingot] [Iron Ingot] [Glass Pane] [Iron Ingot] [Iron Ingot] [Redstone] [Iron Ingot]

ATM Machine [Iron Block] [Observer] [Iron Block] [Iron Block] [Redstone Comparator] [Iron Block] [Iron Block] [Iron Bars] [Iron Block]

POS Terminal [Iron Ingot] [Redstone] [Iron Ingot] [Iron Ingot] [Comparator] [Iron Ingot] [ ] [Iron Ingot] [ ]

Card Dispenser [Iron Ingot] [Gold Ingot] [Iron Ingot] [Iron Ingot] [Crafting Table] [Iron Ingot] [Iron Ingot] [Iron Bars] [Iron Ingot]

3. Gameplay Instructions

Card Application

Right-click the Card Dispenser to get a new bank card directly, and a PIN setup window will pop up (this step can be skipped). Each player can hold up to 10 bank cards in total. Admins may also issue new cards via the command /bankadmin newcard.

ATM Operation Process

1. Hold a bank card and right-click the ATM → The card will be inserted automatically 2. Enter your 6-digit payment PIN (new cards require PIN setup before use) 3. Enter the main menu: Withdraw: Withdraw preset amounts (100/500/1000/5000) or custom values (must be multiples of 100), physical Emeralds will be dispensed (1 Emerald = 100 coins) Deposit: Place physical Emeralds into the machine, which will be converted to account balance at a 1:100 exchange ratio Check Balance: Refresh and display current balance Eject Card: Retrieve your bank card Terminate Card: Confirm with PIN; all balance will be cleared and all data permanently deleted

POS Terminal Operation Process

Merchant Binding: Hold your own bank card and right-click an unbound POS terminal → Binding completed successfully Merchant Settings: Right-click the bound POS terminal with your bank card → Open merchant setting panel to set product names and prices (0 = allow custom payment amount input) Customer Payment (Bank Card): Hold your bank card and right-click → Enter amount and PIN → Complete payment Customer Payment (Mobile Wallet): Hold your mobile phone and right-click → Your default card will be selected automatically → A payment confirmation window pops up → Enter PIN → Funds deducted

Mobile Wallet (APP)

Right-click the mobile phone to open the wallet APP First launch: Set a 6-digit wallet password; Subsequent launches: Enter your 6-digit password to log in Homepage: Displays all bank cards under your account, click any card to view details Card Details Page: Check balance and recent transaction records; initiate transfers or terminate the card Bind Card: Enter another player’s card number and payment PIN to link their card to your wallet More Settings: Set default payment card, toggle small-amount password-free payment, modify wallet password Transfer Funds: Send funds from the currently selected card; recipients can be located via 16-digit card number or player username

Commands

/balance [Check balances of all your bank cards] /pay [Transfer coins to an online player (no PIN required for amounts ≤ 500)] /pay [Complete transfer with PIN verification] /pay confirm [Confirm large transactions exceeding 50000 coins] /bankadmin help [Display help information for administrator commands]

Password & Security

The 6-digit payment PIN for bank cards can be set at ATMs or Card Dispensers, stored as salted SHA-256 hash values After 3 consecutive incorrect PIN entries, the corresponding card will be locked for 5 minutes Small-amount password-free payment (enabled by default): No PIN required for transactions ≤ 50 coins; PIN verification mandatory for payments over 500 coins The mobile wallet uses an independent 6-digit access password to protect APP entry All balance will be cleared and unrecoverable after card termination; please operate with caution

3. Important Notes

When inserting a card into the ATM, the system directly reads the NBT card number stored on the held item instead of matching player identity, eliminating confusion for players with multiple cards Data is isolated per save file: Each world stores independent banking data that cannot be shared across different saves, stored under the directory config/bankmod/world_xxx/ If you lose your physical bank card item, server admins can reissue a new one via the command /bankadmin newcard All withdrawal values must be multiples of 100 (consistent with the exchange rate 1 Emerald = 100 coins)

---

项目名称: BankMOD

简介: 为Minecraft添加完整的银行与支付系统。使用银行卡、ATM、POS机和手机钱包管理你的财富。

模组功能:

BankMOD在游戏中模拟了真实的银行与支付体验：

· 银行卡系统，支持一人多卡 · ATM存取款、查询余额、修改密码 · POS机商家定价与刷卡支付 · 手机钱包APP，支持绑卡、转账、NFC支付 · 钱包密码保护与小额免密 · 首次使用自动开户

为什么下载BankMOD？

· 真实银行体验 – 模拟现实中的银行卡、ATM、POS机和移动支付 · 便捷灵活 – 支持按玩家名或卡号转账，可设置默认卡 · 安全可靠 – 钱包密码、PIN验证、ATM三错误锁定 · 管理员友好 – 完整的管理指令，轻松管理玩家账户

下载前须知:

· 仅服务端模组 – 仅在服务器运行，客户端无需安装 · OP发卡 – 普通玩家无法自行开户，需管理员发卡 · 数据存储 – 数据保存在 config/bankmod/ 目录，绑定当前存档 · 兼容性 – 目前支持 Fabric 1.20.1，Forge支持即将推出 · MTR联动 – 计划未来版本支持

开源协议：MIT开源协议 维护作者：Niu_Roubing

BankMOD 银行模组 — 玩家指南

1. 物品/方块用途

银行卡：右键查看余额和卡状态。持卡右击 ATM / POS 机进行金融操作。每张卡有独立的 16 位卡号和 6 位支付密码。

手机：右键打开钱包 APP，支持查看卡片列表、转账、绑卡、设置默认卡、小额免密开关、修改钱包密码。

ATM机：插卡 → 验证密码 → 主菜单（取款 / 存款 / 查余额 / 退卡 / 注销此卡）。
潜行+右键绑定到你的名下（绑定后该 ATM 归你管理）。

POS 机：商家绑定自己的银行卡 → 客户手持银行卡或手机右击付款。
商家可设置商品名和定价，客户按定价或自由输入金额付款。

发卡机：右键直接获得一张新银行卡，并提示设置 6 位支付密码（可跳过，以后在 ATM 设置）。每人最多持 10 张卡。

2.合成配方 手机 [铁锭] [红石] [铁锭] [铁锭] [玻璃板] [铁锭] [铁锭] [红石] [铁锭] ATM 机 [铁块] [观察者] [铁块] [铁块] [红石比较器] [铁块] [铁块] [铁栏杆] [铁块] POS 机 [铁锭] [红石] [铁锭] [铁锭] [比较器] [铁锭] [ ] [铁锭] [ ] 发卡机 [铁锭] [金锭] [铁锭] [铁锭] [工作台] [铁锭] [铁锭] [铁栏杆] [铁锭] 4. 玩法说明

开卡

右击发卡机直接获得一张新银行卡，并弹出密码设置界面（可跳过）. 每人最多 10 张卡。 也可通过 /bankadmin newcard 指令（管理员）获得新卡。

ATM 使用流程

1.手持银行卡右击 ATM → 自动插入卡片 2.输入 6 位支付密码（新卡需先设置密码） 3.进入主菜单： 取款：按预设金额（100/500/1000/5000）或自定义金额（需整百）取款，取出实物绿（1绿宝石 = 100 币） 存款：放入实物绿宝石，按 1:100 兑换为余额 查询余额：刷新显示 退卡：退出卡片 注销此卡：需输入密码确认，余额归零、数据永久删除

POS 机使用流程

商家绑定：手持自己的银行卡右击未绑定的 POS 机 → 绑定成功 商家设置：手持绑定的银行卡右击 POS 机 → 进入商家设置界面，可设置商品名和价格（0=自由输入） 客户支付（银行卡）：手持银行卡右击 → 输入金额和密码 → 付款 客户支付（手机）：手持手机右击 → 自动使用默认卡 → 弹出支付确认界面 → 输入密码 → 扣款

手机钱包（APP）

右键手机打开钱包 APP 首次使用：设置 6 位钱包密码;非首次使用：输入 6 位密码 首页：列出名下所有银行卡，点击进入卡片详情 卡片详情：查看余额、最近交易记录、可转账或注销 绑卡：输入他人卡号 + 密码可绑定别人的卡到自己名下 更多：设置默认卡、小额免密开关、修改钱包密码 转账：从当前卡片转出，目标可输入 16 位卡号或玩家名

指令

/balance [查看名下所有银行卡的余额] /pay <玩家> <金额> [向在线玩家转账（≤500 免密）] /pay <玩家> <金额> <密码> [带密码转账] /pay confirm [确认大额（>50000）转账] /bankadmin help [管理员指令帮助]

密码与安全

银行卡的 6 位支付密码在 ATM 或发卡机设置，SHA-256 加盐存储 密码连续错 3 次，该卡锁定 5 分钟 小额免密（默认开启）：≤50 币无需密码；>500 币必须输入密码 手机钱包有独立 6 位钱包密码，保护 APP 访问 注销卡后余额归零且不可恢复，请谨慎操作

1. 注意事项 ATM 插卡时直接读取手中物品的 NBT 卡号，不再通过玩家身份匹配，一人多卡时不再混乱 数据按存档隔离：每个世界（存档）有独立的银行数据，不跨存档通用，存放在config/bankmod/world_xxx/ 下 物品形式的银行卡如果丢失，可用 /bankadmin newcard 补办（管理员） 取款金额必须为整百（因为 1 绿宝石 = 100 币）