MC-Banking

模组

· 作者 recklessmetro

此模组为 Minecraft 添加了一个银行系统,支持 Minecraft Transit Railways 模组,包含 ATM、管理计算机、借记卡、现金和商业账户。此外还提供 API,可让其他模组接入该系统以进行购买等操作!

0 本站下载 0 关注 更新于 4 个月前

最新 5.7.1 · 1.20.6 · Fabric

一键开服(送7天)

? 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

? 入门指南

  1. 创建银行 — 使用银行仪表盘物品在地图上定义一个银行区域
  2. 放置柜员 — 在你的银行区域内生成一个银行柜员 NPC
  3. 开设账户 — 右键点击柜员并选择“开设账户”
  4. 获取借记卡 — 选择你的卡片样式并设置 PIN 码
  5. 放置 ATM — 使用银行计算机分发 ATM,然后使用网络配置器将它们链接起来
  6. 开始银行业务! — 手持你的卡片并右键点击任意 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 页面的链接。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源