? MC-Banking
一款功能全面的 Minecraft 银行、经济与金融模组。创建银行、开设账户、使用自动取款机(ATM)、投资股票、申请贷款、经营企业等——所有操作均配备沉浸式像素艺术界面与拟真机制。
✨ 特性
? 自动取款机 (ATMs)
- 在任何位置放置 ATM——使用网络配置器将其链接至银行网络
- 插入借记卡(按住并右键点击)以访问您的账户
- 使用面额选择器提取现金——可选择特定面额($1、$5、$10、$20、$50、$100)
- 查询余额、转账、存款支票、查看交易记录、打印收据
- 位于银行区域内的 ATM 提供全套服务(存款、支票、贷款、股票)
- 位于银行区域外的 ATM(如火车站)仅提供取款、转账和余额查询功能
- 银行品牌标识——ATM 头部显示银行颜色及 Emoji 徽标
- 跨行使用其他银行的 ATM 将收取跨行手续费
?? 银行柜员
- 位于银行区域内的 NPC 柜员提供完整的银行业务服务
- 开设账户、获取借记卡、设置 PIN 码、存取款、转账
- 各银行相互独立——您需要在每家银行分别开设账户
- 出于安全考虑,PIN 码以圆点字符掩码显示
?️ 银行仪表板
- 使用“银行仪表板”物品来管理您的银行业帝国
- 在实时世界地图上通过点击放置角落来划定银行区域
- 设定银行颜色、Emoji 徽标及 ATM 手续费
- 创建分行,其名称将根据附近的 MTR 车站自动生成
- 查看所有客户及其账户统计信息(余额、储蓄、贷款、股票)
- 分行编号系统(例如 ENB-B1, ENB-B2)
? 银行电脑
- 放置在银行区域内供员工和管理者使用
- “概览”标签页:显示网络 ID、评级、ATM 手续费、银行资金、账户数及员工数量
- 雇佣/解雇员工、打卡上下班系统、分发 ATM 和电脑
- 查看您网络中的所有 ATM,包括坐标和位置名称
- 所有用户均可访问股票市场
- 员工职位:柜员、ATM 技术员、分行经理、所有者
? 借记卡
- 三种卡片样式:经典蓝、黄金尊享版、午夜黑
- 手持时 HUD 叠加层显示卡片详情(银行名称、卡号、有效期、持卡人、账户 ID)
- 卡片按银行绑定——每家银行一张
- 在 ATM 上使用时需输入 PIN 码
? 企业账户
- 在任何柜员处开设企业账户
- 为员工发放带有每日消费限额(或无限额)的员工卡
- 预生成的 PIN 码将展示给所有者以便分发
- 停用/重新激活卡片而不必注销它们
- 员工收到拒绝提示:“卡片被拒——已停用。请联系 [企业]。”
- 完整的企业总览屏幕,显示员工卡、PIN 码及交易记录
- 存入现金、支票或从个人账户转账
- 重命名企业、关闭账户(将开具剩余全额的支票)
? 股票市场
- 股票现在基于玩家的企业账户定价,例如:
- MINE (MineCorp) — 价格受开采方块数量驱动
- SLAY (SlayerInc) — 价格受击杀怪物数量驱动
- CRFT (CraftWorks) — 价格受制作物品数量驱动
- POP (PopIndex) — 价格受在线玩家数量驱动
- 从柜员、ATM(银行区域内)或银行电脑买卖股票
- 投资组合追踪,实时显示价格变动
- 价格每游戏日内一个季度更新一次
? 贷款
- 根据信用评分(300–850)申请贷款
- 还清贷款可提高信用评分,逾期付款会降低信用评分
- 每游戏日利息为 5%,最低还款额为 10%
- 连续 3 次未还款将冻结账户
- 随时可查看贷款状态、剩余余额及信用评分
? 储蓄与利息
- 在活期账户和储蓄账户之间转移资金
- 储蓄账户每游戏日赚取 0.1% 的利息(最低余额 $10)
? 支票
- 从支票簿中向其他玩家开具支票(在柜员处以 $5 购买)
- 在柜员处存款即时到账,或在 ATM 处存款(大额款项立即到账 30%,其余 70% 保留 5 天)
- 手持时 HUD 叠加层显示收款人、金额及签署人
- 账户关闭时发行包含全部剩余余额的支票
? 跨网络转账
- 在不同银行间转账需支付 3% + $2 的手续费
- 自动检测——同一网络免费,不同网络则收取手续费
? 实体现金
- 硬币:5¢、10¢、25¢
- 纸币:$1、$5、$10、$20、$50、$100
- 在柜员或银行区域内的 ATM 存入现金
- 使用面额选择器提取特定面额的现金
? 银行健康度与评级
- 银行根据运营资金、员工、账户及贷款违约情况评为 A+ 至 F 级
- 陷入困境的银行会在 ATM 上显示警告及取款限制
- 破产的银行将冻结所有账户——玩家将获得保险赔付(最高 $500 的 80%)
- 其他银行可以收购破产银行
? 工资单
- 员工在打卡上班时自动获得工资
- 柜员:$5,ATM 技术员:$7.50,分行经理:$10(每半游戏日)
- 工资从银行运营资金中支付
?️ 税收
- 每 7 个游戏日对超过 $50 的账户征收 2% 的税
- 低于阈值的账户免税
- 税收收入归入服务器金库
? ATM 抢劫
- 尝试抢劫 ATM(成功率 35%)
- 成功:窃取 $50–$500 现金,并获得加速效果以逃脱
- 失败:罚款 $100,并受到减速和发光效果影响 30 秒
- 冷却时间为 3 个游戏日,会通知附近玩家及银行所有者
? MTR 集成
- 售票机覆盖——使用现金或银行账户余额而非绿宝石购买火车票
- 分行名称根据最近的 MTR 车站自动生成
- ATM 位置名称基于银行计算机中的 MTR 车站
?️ Squaremap 集成
- 银行区域在网页地图上显示为彩色矩形
- 区域中心显示银行图标,悬停时显示工具提示
- 显示分行编号
## ? 依赖项
| 模组 | 是否必需? |
|-----|-----------|
| [Fabric API](https://modrinth.com/mod/fabric-api) | ✅ 必需 |
| [Special Model Loader](https://modrinth.com/mod/special-model-loader) | ✅ 必需(OBJ 方块模型) |
| [MTR](https://modrinth.com/mod/mtr) | ❌ 可选(售票机 + 车站名称) |
| [Squaremap](https://modrinth.com/mod/squaremap) | ❌ 可选(网页地图标记) |
| Decocraft | ❌ 可选(ATM 方块兼容性,默认禁用) |
---
## ⚙️ 配置
配置文件:`config/mc-banking.json`
```json
{
"ticketMachineOverride": true,
"decocraftAtmCompat": false,
"decocraftAtmBlockIds": ["decocraft:atm", "decocraft:atm_machine"]
}
| 选项 |
默认值 |
描述 |
ticketMachineOverride |
true |
将 MTR 的售票机界面替换为 MC-Banking 的支付屏幕 |
decocraftAtmCompat |
false |
右键点击 Decocraft ATM 方块可打开 MC-Banking ATM |
decocraftAtmBlockIds |
["decocraft:atm", ...] |
启用兼容时作为 ATM 使用的方块 ID |
? 入门指南
- 创建银行 — 使用银行仪表盘物品在地图上定义一个银行区域
- 放置柜员 — 在你的银行区域内生成一个银行柜员 NPC
- 开设账户 — 右键点击柜员并选择“开设账户”
- 获取借记卡 — 选择你的卡片样式并设置 PIN 码
- 放置 ATM — 使用银行计算机分发 ATM,然后使用网络配置器将它们链接起来
- 开始银行业务! — 手持你的卡片并右键点击任意 ATM
? 开发者 API
MC-Banking 提供了完整的 API,供其他模组与经济系统集成。
入门指南
import com.banking.mod.api.BankingAPI;
BankingAPI api = BankingAPI.getInstance();
个人银行业务
// 检查余额(以分为单位 — $5.00 = 500)
long balance = api.getBalance(playerUuid);
long savings = api.getSavings(playerUuid);
// 存款 / 取款
api.deposit(playerUuid, 500, "MyMod", "任务奖励");
api.withdraw(playerUuid, 250, "MyMod", "商店购买");
// 扣费(withdraw 的别名,意图更明确)
api.charge(player, 200, "TollMod", "过桥费");
// 灵活扣费 — 优先尝试现金,不足时扣除银行存款
api.chargeFlexible(player, 500, "MarketMod", "摊位费", true);
// 用实体纸币支付
api.payCash(player, 13700, "WageMod", "周薪");
// 玩家间转账
api.transfer(fromUuid, toUuid, 1000, "TradePlugin");
商业卡
// 对商业卡扣费 — 成功返回 null,否则返回拒绝原因
String error = api.chargeBusinessCard(playerUuid, 2500, "办公用品");
if (error != null) {
// “卡片被拒 — 已停用。请联系 Acme Corp。”
// “卡片被拒 — 达到每日消费限额。”
// “卡片被拒 — 商业资金不足。”
player.sendMessage(Text.literal(error), true);
}
// 检查卡片状态
boolean hasCard = api.hasActiveBusinessCard(playerUuid);
long remaining = api.getBusinessCardRemaining(playerUuid);
String bizName = api.getBusinessName(playerUuid);
现金与物品栏
// 统计玩家物品栏中的实体现金数量
long cash = api.getCashInInventory(player);
// 从物品栏中移除现金物品
long removed = api.takeCashFromInventory(player, 1000);
交易历史与钩子
// 读取历史记录
List<TransactionEntry> history = api.getHistory(playerUuid);
// 发布备注(不移动金钱)
api.postNote(playerUuid, "LoanMod", "贷款申请已批准");
// 监听每笔交易
api.onTransaction((uuid, entry) -> {
if (entry.type.equals("WITHDRAW") && entry.amountCents >= 1000) {
System.out.println(uuid + " 提取了 " + entry.getFormattedAmount());
}
});
依赖设置
dependencies {
modImplementation fileTree(dir: 'libs', include: ['mc-banking-*.jar'])
}
// fabric.mod.json
{ "suggests": { "mc-banking": "*" } }
所有 API 方法必须在服务器线程上调用。完整文档请参阅 DEBIT_API.md。
? 数据存储
所有银行数据按世界存储在 world/mc-banking/ 文件夹中。如果从旧版本升级,首次加载时会自动从服务器根目录迁移文件。
? Minecraft 版本
- Minecraft: 1.20.4
- 加载器: Fabric
- Java: 17+
## ? 许可证
© 2025 MC-Banking. All rights reserved.
- ✅ 你可以在任何 Minecraft 服务器上使用此模组(商业或非商业均可)
- ✅ 你可以在整合包中包含此模组,但需注明出处
- ✅ 你可以使用 API 构建集成
- ❌ 未经许可以外,你不得在 Modrinth 之外重新分发此模组
- ❌ 你不得反编译、修改或重新品牌化此模组并声称是你自己的作品
- ❌ 你不得出售此模组或其任何修改版本
**必须注明出处:** 如果你在整合包中包含 MC-Banking 或在公共服务器上使用该模组,请注明“MC-Banking by RecklessMetro”,并提供指向 Modrinth 页面的链接。
? MC-Banking
A full-featured banking, economy, and finance mod for Minecraft. Create banks, open accounts, use ATMs, invest in stocks, take out loans, run businesses, and more — all with immersive pixel-art UIs and realistic mechanics.
✨ Features
? ATMs
- Place ATMs anywhere — link them to a bank network with the Network Configurator
- Insert your debit card (hold it and right-click) to access your account
- Withdraw cash with a bill selector — choose exact denominations ($1, $5, $10, $20, $50, $100)
- Check balance, transfer funds, deposit cheques, view transaction history, print receipts
- ATMs inside bank zones offer full services (deposits, cheques, loans, stocks)
- ATMs outside bank zones (e.g. train stations) offer withdrawals, transfers, and balance only
- Bank branding — ATM header shows bank color and emoji logo
- Out-of-network fees when using another bank's ATM
?? Bank Tellers
- NPC tellers inside bank zones provide full banking services
- Open accounts, get debit cards, set PINs, deposit/withdraw, transfer funds
- Each bank is independent — you need a separate account at each bank
- PIN is masked with bullet characters for security
?️ Bank Dashboard
- Use the Bank Dashboard item to manage your banking empire
- Create bank areas on a live world map with click-to-place corners
- Set bank colors, emoji logos, ATM fees
- Create branches that auto-name from nearby MTR stations
- View all clients and their account statistics (balance, savings, loans, stocks)
- Branch numbering system (e.g. ENB-B1, ENB-B2)
? Bank Computer
- Place inside a bank zone for staff and owner management
- Overview tab: network ID, rating, ATM fee, bank funds, accounts, staff count
- Hire/fire staff, clock in/out system, dispense ATMs and computers
- View all ATMs on your network with coordinates and location names
- Stock market access for all users
- Staff roles: Teller, ATM Technician, Branch Manager, Owner
? Debit Cards
- Three card styles: Classic Blue, Gold Premium, Midnight Black
- HUD overlay shows card details when held (bank name, card number, expiry, holder, account ID)
- Cards are bank-specific — one per bank
- PIN required at ATMs
? Business Accounts
- Open a business account at any teller
- Issue employee cards with daily spending limits (or unlimited)
- Pre-generated PINs shown to the owner for distribution
- Deactivate/reactivate cards without revoking them
- Employees get decline messages: "Card declined — deactivated. Please contact [Business]."
- Full business overview screen with employee cards, PINs, and transaction history
- Deposit cash, cheques, or transfer from personal account
- Rename business, close account (issues cheque for remaining balance)
? Stock Market
- Stocks now based on player business accounts like:
- MINE (MineCorp) — price driven by blocks mined
- SLAY (SlayerInc) — price driven by mob kills
- CRFT (CraftWorks) — price driven by items crafted
- POP (PopIndex) — price driven by players online
- Buy and sell shares from the teller, ATM (bank zone), or bank computer
- Portfolio tracking with real-time price changes
- Prices update every quarter in-game day
? Loans
- Apply for loans based on your credit score (300–850)
- Credit score improves with paid-off loans, drops with missed payments
- 5% interest per in-game day, 10% minimum payment
- Account freezes after 3 missed payments
- Check loan status, remaining balance, and credit score at any time
? Savings & Interest
- Move money between checking and savings accounts
- Savings earn 0.1% interest per in-game day (minimum $10 balance)
? Cheques
- Write cheques to other players from a cheque book ($5 at the teller)
- Deposit at teller (instant) or ATM (30% immediate, 70% on 5-day hold for large amounts)
- Cheque HUD overlay shows recipient, amount, and signer when held
- Issued on account closure with full remaining balance
? Cross-Network Transfers
- Transfer between different banks with a 3% + $2 conversion fee
- Automatic detection — same network = free, different network = fee applied
? Physical Cash
- Coins: 5¢, 10¢, 25¢
- Bills: $1, $5, $10, $20, $50, $100
- Deposit cash at tellers or bank-zone ATMs
- Withdraw as specific bill denominations with the bill selector
? Bank Health & Ratings
- Banks are rated A+ to F based on operating funds, staff, accounts, and loan defaults
- Distressed banks show warnings at ATMs with withdrawal limits
- Bankrupt banks freeze all accounts — players receive insurance payouts (80% up to $500)
- Other banks can acquire bankrupt banks
? Payroll
- Staff get paid automatically when clocked in
- Teller: $5, ATM Tech: $7.50, Branch Manager: $10 per half in-game day
- Paid from bank operating funds
?️ Taxes
- 2% tax every 7 in-game days on accounts over $50
- Exempt accounts below threshold
- Tax revenue goes to server treasury
? ATM Robberies
- Attempt to rob ATMs (35% success rate)
- Success: steal $50–$500 in cash, speed boost to escape
- Failure: $100 fine, slowness, glowing for 30 seconds
- 3 in-game day cooldown, alerts nearby players and bank owner
? MTR Integration
- Ticket machine override — pay for train tickets with cash or bank balance instead of emeralds
- Branch auto-naming from nearest MTR station
- ATM location names from MTR stations in the bank computer
?️ Squaremap Integration
- Bank areas shown as colored rectangles on the web map
- Bank icons at area centers with hover tooltips
- Branch numbers displayed
## ? Dependencies
| Mod | Required? |
|-----|-----------|
| [Fabric API](https://modrinth.com/mod/fabric-api) | ✅ Required |
| [Special Model Loader](https://modrinth.com/mod/special-model-loader) | ✅ Required (OBJ block models) |
| [MTR](https://modrinth.com/mod/mtr) | ❌ Optional (ticket machine + station names) |
| [Squaremap](https://modrinth.com/mod/squaremap) | ❌ Optional (web map markers) |
| Decocraft | ❌ Optional (ATM block compatibility, disabled by default) |
---
## ⚙️ Configuration
Config file: `config/mc-banking.json`
```json
{
"ticketMachineOverride": true,
"decocraftAtmCompat": false,
"decocraftAtmBlockIds": ["decocraft:atm", "decocraft:atm_machine"]
}
| Option |
Default |
Description |
ticketMachineOverride |
true |
Replaces MTR's ticket machine UI with MC-Banking's payment screen |
decocraftAtmCompat |
false |
Right-clicking Decocraft ATM blocks opens MC-Banking ATM |
decocraftAtmBlockIds |
["decocraft:atm", ...] |
Block IDs that act as ATMs when compat is enabled |
? Getting Started
- Create a bank — Use the Bank Dashboard item to define a bank area on the map
- Place a teller — Spawn a Bank Teller NPC inside your bank area
- Open an account — Right-click the teller and choose "Open an account"
- Get a debit card — Choose your card style and set a PIN
- Place ATMs — Use the bank computer to dispense ATMs, then link them with the Network Configurator
- Start banking! — Hold your card and right-click any ATM
? Developer API
MC-Banking provides a full API for other mods to integrate with the economy system.
Getting Started
import com.banking.mod.api.BankingAPI;
BankingAPI api = BankingAPI.getInstance();
Personal Banking
// Check balance (in cents — $5.00 = 500)
long balance = api.getBalance(playerUuid);
long savings = api.getSavings(playerUuid);
// Deposit / Withdraw
api.deposit(playerUuid, 500, "MyMod", "Quest reward");
api.withdraw(playerUuid, 250, "MyMod", "Shop purchase");
// Charge (alias for withdraw with clearer intent)
api.charge(player, 200, "TollMod", "Bridge toll");
// Flexible charge — tries cash first, then bank balance
api.chargeFlexible(player, 500, "MarketMod", "Stall fee", true);
// Pay in physical cash notes
api.payCash(player, 13700, "WageMod", "Weekly wage");
// Transfer between players
api.transfer(fromUuid, toUuid, 1000, "TradePlugin");
Business Cards
// Charge a business card — returns null on success, or decline reason
String error = api.chargeBusinessCard(playerUuid, 2500, "Office supplies");
if (error != null) {
// "Card declined — deactivated. Please contact Acme Corp."
// "Card declined — daily spending limit reached."
// "Card declined — insufficient business funds."
player.sendMessage(Text.literal(error), true);
}
// Check card status
boolean hasCard = api.hasActiveBusinessCard(playerUuid);
long remaining = api.getBusinessCardRemaining(playerUuid);
String bizName = api.getBusinessName(playerUuid);
Cash & Inventory
// Count physical cash in player's inventory
long cash = api.getCashInInventory(player);
// Remove cash items from inventory
long removed = api.takeCashFromInventory(player, 1000);
Transaction History & Hooks
// Read history
List<TransactionEntry> history = api.getHistory(playerUuid);
// Post a note (no money moved)
api.postNote(playerUuid, "LoanMod", "Loan application approved");
// Hook into every transaction
api.onTransaction((uuid, entry) -> {
if (entry.type.equals("WITHDRAW") && entry.amountCents >= 1000) {
System.out.println(uuid + " withdrew " + entry.getFormattedAmount());
}
});
Dependency Setup
dependencies {
modImplementation fileTree(dir: 'libs', include: ['mc-banking-*.jar'])
}
// fabric.mod.json
{ "suggests": { "mc-banking": "*" } }
All API methods must be called on the server thread. Full documentation in DEBIT_API.md.
? Data Storage
All banking data is stored per-world in the world/mc-banking/ folder. Files are automatically migrated from the server root on first load if upgrading from an older version.
? Minecraft Version
- Minecraft: 1.20.4
- Mod Loader: Fabric
- Java: 17+
## ? License
© 2025 MC-Banking. All rights reserved.
- ✅ You may use this mod on any Minecraft server (commercial or non-commercial)
- ✅ You may include this mod in modpacks with credit
- ✅ You may use the API to build integrations
- ❌ You may NOT redistribute this mod outside of Modrinth without permission
- ❌ You may NOT decompile, modify, or rebrand this mod and claim it as your own
- ❌ You may NOT sell this mod or any modified version of it
**Credit required:** If you include MC-Banking in a modpack or use it on a public server, please credit "MC-Banking by RecklessMetro" with a link to the Modrinth page.
评论 0
登录后参与评分
还没有评论,来抢沙发吧