适用源码:
9da0beb8e8fdad85f50d7039408c3d98494e91c7。本文记录源码行为,默认配置不等于实服配置。
设计状态:按现状编写,具体业务批准记录未逐项核定;开发状态:下述能力有实现证据,限制单列;验证状态:完成定向源码核对,未执行自动测试或实服验收。
三种版本信息
构建依赖、plugin.yml API 声明和生产实际加载版本必须分开记录。编译成功不能证明服务器可启动;启动成功也不能证明玩家交接、跨区运输和客户端模型可用。
当前 Java release 25、Folia API 26.2.build.7-beta 及其他编译依赖见开发架构页。plugin.yml 的 api-version 1.21 不是推荐给玩家连接的精确版本。本文未读取实服插件列表,不编造部署版本或安装状态。
启动检查
- 记录服务器实际 Java、Folia、Towny、Vault 提供者、CraftEngine/BetterModel 等版本。
- 核对配置能被加载,默认资源与历史规格存在。
- 确认共享 SQLite 初始化及驿站当前结构核验成功。
- 观察服务注册及恢复任务就绪,而不只看插件名称为绿色。
- 对新建实例、已有资产、离线恢复分别做测试。
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。仅公开依赖类别及构建版本,不包含生产网络与凭据。
相关:架构、构建部署。