CradleMC官方WIKI

适用源码:9da0beb8e8fdad85f50d7039408c3d98494e91c7。本文记录源码行为,默认配置不等于实服配置。
设计状态:按现状编写,具体业务批准记录未逐项核定;开发状态:下述能力有实现证据,限制单列;验证状态:完成定向源码核对,未执行自动测试或实服验收。

两种存储

银行核心为木桶,可从设施入口打开。中间槽位是完整物品仓库;顶部与底部是按钮,不是存物区域。质押是独立的“物品材质→数量”记录,不占仓库槽位,不等于贷款或利息功能。

等级 默认页数 每页容量
1 1 36格
2 2 36格
3 3 36格
4 4 36格

默认银行升级材料为空,但仍须管理资格、等级及生命周期校验;实服可改配置。

使用步骤

  1. 打开银行,检查当前页数和等级。
  2. 在中间36格按原版库存方式移动物品。
  3. 通过翻页或关闭入口保存当前页;点击、拖拽亦安排保存。
  4. 特殊装备放入的是完整物品仓库,不要放进数值质押或普通设施材料库存。

仓库按设施 ID 保存,不是每位玩家的独立私人银行。能访问银行的成员可能操作同一设施仓库,请先与城镇管理者确认使用约定。

质押操作

在银行点击“质押”,选择物品种类,再选存入/取出1、10、100或全部。默认存入物为金锭,配置键 facility.types.bank.pledge-item;旧种类改配置后仍能取回。存入只计普通原版材料,特殊信息不能被完整保留。

质押列表、存入和取出通过 bank.canUse 重新检查访问资格,不是“只有镇长能取”的独立资金权限。通用 UPGRADE 则走管理权限。访问仍受系统开关、使用权限、地块城镇身份和访问模式控制。

保存与异常

仓库经页面序列化保存;它不是玩家背包与 SQL 之间全局原子事务。质押扣库后向背包发放,放不下会尝试退回数据库;退回失败有地面掉落分支。不要将“失败”理解为所有物品必然自动回到原位置。
看到保存失败,停止继续整理或多人操作,记录银行位置、时间、物品与数量,交管理员核对。不要强拆、重建或删库重置。

来源

docs/玩家与设施指南.md银行章节;folia_plugin/src/main/resources/config.yml银行等级。代码根为 folia_plugin/src/main/java/com/flrv/:ui/facility/BankMenuService.java#open/save/action、BankPledgeDialog.java、BankPledgeItemDialog.java(同目录)、event/inventory/BankMenuListener.java、logic/facility/service/FacilityPledgeService.java、FacilityAccessService.java(同目录)。
相关:设施指南。