适用源码：
9da0beb8e8fdad85f50d7039408c3d98494e91c7。本文记录源码行为，默认配置不等于实服配置。
设计状态：按现状编写，具体业务批准记录未逐项核定；开发状态：下述能力有实现证据，限制单列；验证状态：完成定向源码核对，未执行自动测试或实服验收。
工程与版本
自研业务为单个 Maven 工程 folia_plugin，坐标 com.flrv:folia_plugin:1.0-SNAPSHOT，不是多项独立部署服务。
| 依赖 | 当前构建声明 |
|---|---|
| Java release | 25 |
| Folia API | 26.2.build.7-beta |
| Towny | 0.103.2.0 |
| VaultAPI | 1.7 |
| CraftEngine core/bukkit | 26.9.1 |
| BetterModel API | 3.5.1 |
| SQLite JDBC | 3.46.1.0 |
plugin.yml 声明 api-version 1.21、folia-supported=true，软依赖 Vault、CMI、Towny、CraftEngine、BetterModel；SQLite 同时列为 libraries。provided 依赖和编译成功不证明生产运行环境已满足，也不证明所有软依赖缺失时每项玩法仍可用。
责任边界
| 目录（com.flrv 下） | 职责 |
|---|---|
| bootstrap | 装配、注册、启动与关闭 |
| logic | 模型、规则、业务编排 |
| event | 命令和平台事件输入 |
| ui | 箱子、Dialog、交互协调 |
| infrastructure | 配置、数据库、调度、平台和外部集成 |
| behavior/factory/registry | 行为、正式物品创建、注册 |
Main 是稳定 Bukkit 入口，将启停交给 PluginBootstrap。不要把依赖接口类的存在当作实际启动接线证据；例如自动物流接口没有完整执行链。
启动与关闭
start 顺序为配置迁移→依赖/目录→共享存储→驿站存储→服务装配→绑定回调→注册事件命令→启动周期任务。StationBootstrap 受主入口分阶段调用；制造、归档、驿站交接锁之间有绑定。
ResourceScope 创建资源后立即登记释放，关闭按逆序执行且重复关闭安全；单项失败继续释放。配置或数据库初始化失败会停止插件，不清空资产“修复”。
数据流
命令/事件→领域服务→仓储/外部适配→玩家或区域续接→UI。设施→Towny 地块；市场/驿站→经济接口与账本；制造→设施和装备规格；TestWar→城镇中心临时状态。
Maven、SQLite、Vault 与服务器世界不组成一个跨系统事务；代码分层不自动带来线程安全。
来源
folia_plugin/pom.xml、folia_plugin/src/main/resources/plugin.yml；代码根 folia_plugin/src/main/java/com/flrv/：Main.java、bootstrap/PluginBootstrap.java#start、StationBootstrap.java、ResourceScope.java（同 bootstrap）、infrastructure/package-info.java；docs/部署与资源维护.md启动关闭章节。完整构建、配置不在 Wiki 复制，按同提交的 Git 资料维护。
相关：项目总览。