适用源码：
9da0beb8e8fdad85f50d7039408c3d98494e91c7本页依据项目源码、默认配置、仓库文档及人工审核意见整理。已完成源码与资料核对，尚未完成本文所述功能的逐项实服验收；本文编写期间未执行自动测试。
CradleMC 是什么
CradleMC 是一个正在开发的 Minecraft Java 服务器项目，当前功能围绕城镇建设、资源生产、物品交易、驿站运输和装备制造展开。
玩家可以通过城镇设施参与生产、仓储、交易和制造。开发者和维护人员通过自研插件、服务端配置及客户端资源共同维护这些功能。
本页介绍适用源码版本已经具备的系统及其主要限制。实际开放范围、费用和权限仍需结合服务器运行配置确认，不能仅凭源码存在就认定功能已经上线或通过验收。
当前主要系统
城镇与设施
项目通过 Towny 集成城镇、地块和设施归属。
当前设施包括：
| 设施 | 主要用途 |
|---|---|
| 城镇中心 | 创建城镇、查看城镇资金和资源汇总 |
| 矿场 | 按配置的产出表生产资源，保存到虚拟库存 |
| 银行 | 分页物品仓库和按物品数量记录的质押 |
| 交易所 | 浏览市场、创建订单、查看自己的订单和领取暂存 |
| 驿站 | 玩家出行、车辆管理和手动寄货 |
| 铁匠铺 | 材料存储、装备订单、图纸及相关装备服务 |
建筑与工事总入口为 /fac menu。不同功能还会检查城镇归属、设施状态和具体操作资格。
能够打开某个界面，不代表拥有其中全部管理权限。镇长、助手、管理员和普通玩家的权限需要按具体操作区分；完整权限矩阵尚待专题核对和发布。
矿场与银行
矿场按照配置的产出表和时间规则生产，资源进入设施虚拟库存。当前生产没有输入消耗，设施维护费未启用。
矿场等通用虚拟库存按“原版物品材质与数量”记录，不保存附魔、改名或自定义模型等完整物品信息。银行分页仓库是独立的物品存储机制，不应与通用虚拟库存混用。
银行质押目前也是按物品种类和数量记录的存储功能，其含义以现有存储和取回规则为限。
虚拟市场
虚拟市场提供玩家买卖单、物品或资金托管、成交结算、配送费和暂存领取。
普通玩家可通过交易所使用市场，也有独立的出售窗口入口。市场命令与设施入口具有不同的权限要求，管理员命令并非普通玩家的通用操作方式。
当前市场只接受普通原版物品，不支持带附魔、改名、自定义模型等复杂信息的物品。交易所界面尚未提供取消订单、修改价格和取回剩余托管物品的完整操作入口。
驿站
驿站提供同世界范围内的玩家出行、可选车辆和手动寄货。
当前出行方式包括仅玩家出行、人车同行，以及仅发车、玩家留在原地。普通出行和手动寄货不要求拥有车辆。
出行、手动寄货和市场配送分别采用各自规则。市场配送费不能直接套用于驿站出行，车辆运输也不等于自动物流。
固定路线自动发车、从设施库存循环发货，以及与市场订单自动衔接，目前尚未完成。
装备制造与战斗
铁匠铺已经具备材料仓、配方与图纸、订单队列、工艺品质、大师装备及维护等相关能力。可制造的装备受运行配置、设施条件和图纸解锁情况影响。
制造结果通过订单和物品数据保存，重新打开预览、领取或重登不会成为重新抽取制造结果的入口。
装备系统还包括动作分派、枪弩弹仓、被动、套装和换肤等能力。高级弹丸效果、部分跨区域命中和兼容场景仍有待完善或验证。
工事
项目已有床弩和固定火炮相关实现。
固定火炮当前采用单体直击伤害，不产生地形爆破。具体建造条件、操作、材料消耗和权限将由工事指南说明。
当前限制与开发状态
适用源码版本仍在开发，以下限制尤其需要注意：
| 范围 | 已知限制 |
|---|---|
| 设施 | 多区块设施及部分城镇中心管理能力尚未完成 |
| 虚拟库存 | 通用库存缺少分页，物品种类较多时可能无法完整展示 |
| 市场 | 复杂物品交易不受支持，部分订单管理缺少普通玩家界面入口 |
| 驿站 | 新路线限同世界，自动物流及市场订单联动尚未完成 |
| 装备与战斗 | 高级效果、跨区域处理和部分兼容场景仍有缺口 |
| 验证 | 源码核对不能替代真实客户端及完整插件环境下的验收 |
战争系统目前定位为“开发中的测试功能”。源码已有 TestWar，用于城镇中心临时生命、交战判定及结束处理等测试。它不代表正式围城、占领或国战玩法已经完成，相关内容仅在开发者测试文档中说明。
如何理解状态标记
本 Wiki 分别记录三个维度：
| 维度 | 回答的问题 |
|---|---|
| 设计状态 | 规则是否已有明确批准，哪些细节仍待确认 |
| 开发状态 | 哪些能力已有实现，哪些正在开发或缺少实现证据 |
| 验证状态 | 是否有对应版本的自动测试或实服验收记录 |
上述主要系统已有源码或启动接线证据，但仍包含未完成的子功能。各项业务细则的批准依据和验证结果需要分别记录，不能统一标记为“全部完成”。
本页不作“全部通过自动测试”或“全部通过实服验收”的结论。
使用时需要注意什么
- 提交交易、制造或运输前，核对界面显示的材料、物品、费用和目标。
- 不同库存保存的信息不同，不要把带特殊信息的装备当作普通材料存入或交易。
- 交接被冻结或结果无法确认时，保留原记录，按界面提示核对并联系管理人员；不要反复提交、删除数据或猜测补发。
- 配置、功能开放情况和文档可能随版本变化，请同时检查文档适用版本。
从哪里继续阅读
已发布专题提供下列入口。市场与工事专题尚未发布，不提供跳转链接。
| 读者 | 推荐内容 |
|---|---|
| 玩家 | 玩家入门、城镇与设施、矿场、银行与资产存储 |
| 玩家 | 驿站出行与寄货、装备制造、维护与换肤、常见问题与资产安全 |
| 开发者 | 架构与依赖、设施入口与生命周期、权限矩阵 |
| 开发者 | 数据库与交接一致性、Folia 调度、驿站实现、装备实现、TestWar 开发测试 |
| 管理与维护人员 | 构建部署、运行环境、客户端资源、配置管理 |
| 管理与维护人员 | 备份与恢复、测试与验收、异常排查、管理员边界 |
技术简介
核心业务由 FoliaPlugin 提供，使用 Java 开发、Maven 构建，并通过 SQLite 保存相关业务数据。Towny、Vault 和 CraftEngine 等组件分别参与城镇、经济和资源接入。
详细版本、模块关系、接口、数据库结构及 Folia 调度约束留在开发者文档中说明。编译依赖版本不作为实服运行版本的证明。
版本与资料来源
本页适用源码：
9da0beb8e8fdad85f50d7039408c3d98494e91c7
以下文件路径均相对项目仓库根目录：
- 已审核的《CradleMC Wiki 第一阶段人工审核修订报告 v2》及后续人工审核意见：项目名称、文档范围、读者分工、战争测试定位及状态标记。
README.md、docs/README.md：仓库结构、资料分类与维护入口。docs/玩家与设施指南.md：设施、市场、驿站、装备操作及当前限制。docs/装备设计与制造.md、docs/装备战斗与被动.md：制造和战斗能力及边界。docs/开发待办.md：实现缺口与实服验收事项。docs/固定火炮工事.md：固定火炮行为与验证入口。folia_plugin/pom.xml、folia_plugin/src/main/resources/plugin.yml：构建及插件声明。folia_plugin/src/main/java/com/flrv/下的logic/facility/core/FacilityType.java、event/command/FacilityCommand.java、bootstrap/PluginBootstrap.java、bootstrap/StationBootstrap.java、logic/war/WarService.java、logic/war/TestWar.java：设施类型、入口、服务接线和测试战争。
Git 保留与代码密切相关的配置、接口、构建、测试和关键运维资料；Wiki 维护系统解释、玩家指南、业务规则、架构介绍和设计决策。两者通过来源引用关联，避免重复维护完整业务规则。