当前项目版本为 2.2.0-snapshot，需要 JDK 21 或更高版本和 Maven。
先在 MapManager v4 源码目录执行：
mvn -pl api -am install再在 BuilderCore 项目目录执行：
mvn clean package产物为 target/BuilderCore-2.2.0-snapshot.jar。mapmanager-api:4.0.0-SNAPSHOT 为 provided 依赖，不打入 JAR；运行时 MapManager-Core 可选。
命令应同时核对 plugin.yml、BuilderCore.registerCommands() 和执行器内部权限；菜单命令和额外 WorldEdit 快捷命令由 BuilderTools.register() 注册。权限包或命令声明改变后需重启服务端。
python3 src/test/check_teleport_access.py权限矩阵脚本要求已缓存 Maven 依赖，会离线编译并运行 SelectedFixesCheck（名称保存/重载、传送点删除、只读预览、速度、时间/天气、元数据与龙蛋开关）及 TeleportAccessCheck 的 Java 断言，覆盖角色、开关、服务未就绪/撤销、未登记世界和无 MMC API 的路径。脚本也运行 CushionPlacementCheck，覆盖右键放置、方块交互单独禁止、完整事件取消、样式与放置事件拦截；并运行 CushionToolsCheck，检查选区边界、地面搜索顺序、权限和背包备份/恢复（含损坏文件及保存失败）；换用已缓存的 Paper 26.3 API 及对应 Adventure 运行库，以 java -ea 运行并传入 26.3 参数，可额外检查三轴移动、左右键事件去重及 Paper 拆除事件拦截。坐垫实现集中在 features/cushiontools/，原 CushionListener 已替换。mvn test 不会自动执行这些 *Check 主方法。以上检查不替代真实 Paper 服务端上的命令、事件与其他插件集成验证。
家保存到 plugins/BuilderCore/userdata/<UUID>.yml 的 Home 节点，公共传送点保存到 plugins/BuilderCore/warps.yml 的 Warps、Aliases 节点。返回历史、传送屏蔽和能力开关等只保存在内存中；备份位置数据时需包含上述 YAML 文件。名称中的点号作为字面键保存，已有正常 YAML 结构保持兼容；旧版本已按点号拆坏的数据不会自动修复。
以下问题尚未修复，修改前应明确兼容要求：
- 家数量：在加载玩家数据和设置自己的家之前重新计算，数量节点变更无需重新登录；取多个数字节点的最大值。当前遍历有效权限记录时没有检查记录的布尔值，不宜用否定数量节点来限制配额；没有节点时配额为 0，管理员包也不自动获得无限家。
- 传送点别名：写入时为“别名 → 名称”，加载及列表查询存在方向不一致。创建后可用别名传送，但列表展示、重启/重载后的解析和删除清理不能保证一致，建议使用正式名称。
重启投票 RestartVoteCommand 和卸下鹦鹉 DismountParrotCommand 只有源码，未在 plugin.yml 声明或启动时注册，不能作为可用命令使用。背包和位置数据库方法尚未接入玩家保存/恢复事件。
JAR 内包含 MySQL Connector/J 9.6.0 和 SQLite JDBC 3.53.0.0，合并 META-INF/services/java.sql.Driver 服务声明。驱动通过本插件类加载器初始化，原有连接参数、表结构和读写流程保持不变。驱动打包方式参考 SQLite JDBC 和 MySQL 驱动初始化。
打包后可运行以下检查，验证两个驱动的服务声明，以及 SQLite 原生库的内存读写；该检查不连接 MySQL 实例：
java -ea -cp target/test-classes:target/BuilderCore-2.2.0-snapshot.jar work.alsace.buildercore.JdbcPackagingCheck