适用源码:
9da0beb8e8fdad85f50d7039408c3d98494e91c7。本文记录源码行为,默认配置不等于实服配置。
设计状态:按现状编写,具体业务批准记录未逐项核定;开发状态:下述能力有实现证据,限制单列;验证状态:完成定向源码核对,未执行自动测试或实服验收。
入口与设施
使用 /fac menu 打开建设总入口,/fac open 打开当前区块建筑。六类建筑是城镇中心、矿场、银行、交易所、驿站、铁匠铺;它们使用不同的库存和专属界面,不能将所有存储视为普通箱子。
创建与摆放
- 从建设菜单选择设施。
- 当前
createFromMenu先检查资格和是否负担费用,再发放摆放道具,并非立即在脚下建成。已经持有摆放道具时拒绝重复发放。 - 使用摆放道具右键地面选择中心位置;
placeFromItem重新执行地块、空间、费用和归属检查。 - 非城镇中心要求玩家已有城镇,且为本镇镇长或持有设施管理员权限。即使是管理员,此标准创建路径仍要求有城镇。
- 标准设施必须在本镇地块,或通过 Towny 相邻、费用等检查后自动占领的荒野;不能在本镇 homeblock 或其他城镇地块创建,同区块不能重复登记。
城镇中心走独立建城/已有城镇处理路径;不能把其他建筑的限制全部套用。位置、空间不合格时以拒绝信息为准,不要重复扣费操作。
默认创建材料仅铁匠铺为石砖32、铁锭16,其余表内为空;Towny 占地费用是另一项费用,不能把“设施免费”解释为占地免费。
使用与管理不同
| 操作 | 当前代码检查 |
|---|---|
| 打开公共设施 | 系统启用、使用权限和原城镇归属仍有效;publicInteraction 可放宽成员限制 |
| 打开非公共设施 | 另受 TOWN/MAYOR 访问模式约束 |
| 通用升级、恢复、拆除、城镇账户取款 | 镇长或 flrv.facility.admin,并通过设施资格检查 |
| 通用物资图标存取 | 当前监听器走 canOpen;不能将其等同城镇账户取款 |
助手或国王头衔本身不等于通用管理权限。管理员权限也不绕过所有空间、资产、类型与运行状态检查。
异常和拆除
看到暂停、归属改变或核心损坏时,先确认原地块与核心,不直接破坏核心或删除记录。恢复入口为 /fac resume,是否恢复取决于服务校验。矿场、铁匠铺、驿站有各自正常拆除条件;银行、交易所、城镇中心不能假定都支持正常直接拆除。/fac remove 对 OP 可能走强制路径,不作为普通玩家日常清理方式。
文档差异与来源
仓库玩家指南仍描述菜单直接创建,而当前执行代码已使用摆放道具;本文按源码记录,不替团队批准新规则。费用和权限配置由维护者核对。
来源:docs/玩家与设施指南.md;folia_plugin/src/main/resources/config.yml;以下类均相对 folia_plugin/src/main/java/com/flrv/:event/command/FacilityCommand.java、logic/facility/service/FacilityPlacementService.java#createFromMenu/placeFromItem、FacilityAccessService.java(同 service 目录)、event/inventory/FacilityMenuListener.java、infrastructure/integration/towny/TownyService.java#canManage/canAccess。
相关:项目总览。