CradleMC官方WIKI

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

三种版本信息

构建依赖、plugin.yml API 声明和生产实际加载版本必须分开记录。编译成功不能证明服务器可启动;启动成功也不能证明玩家交接、跨区运输和客户端模型可用。

当前 Java release 25、Folia API 26.2.build.7-beta 及其他编译依赖见开发架构页。plugin.yml 的 api-version 1.21 不是推荐给玩家连接的精确版本。本文未读取实服插件列表,不编造部署版本或安装状态。

启动检查

  1. 记录服务器实际 Java、Folia、Towny、Vault 提供者、CraftEngine/BetterModel 等版本。
  2. 核对配置能被加载,默认资源与历史规格存在。
  3. 确认共享 SQLite 初始化及驿站当前结构核验成功。
  4. 观察服务注册及恢复任务就绪,而不只看插件名称为绿色。
  5. 对新建实例、已有资产、离线恢复分别做测试。
    Vault 是经济接口,不等于某个具体账户提供者;余额精度、扣款失败与未知结果需按实际提供者验收。

启停次序

PluginBootstrap 先迁移配置、初始化依赖与存储,再装配和注册,最后启动任务。ResourceScope 逆序回收;不能用热重载替代所有关闭/恢复流程。配置或数据库初始化失败时保留原资料,先查日志,不清库强行启动。

内容与客户端

模型缺失可能来自 ZIP、CE 合并、物品引用或客户端缓存;不代表可以重发装备或改属性。服务端行为、物品数据和外观资源分别确认。

来源

folia_plugin/pom.xml、folia_plugin/src/main/resources/plugin.yml;folia_plugin/src/main/java/com/flrv/bootstrap/PluginBootstrap.java、ResourceScope.java(同 bootstrap);docs/部署与资源维护.md。仅公开依赖类别及构建版本,不包含生产网络与凭据。
相关:架构、构建部署。