安装与升级

环境要求

• Java 17 或更高版本；
• Paper / Folia 1.20+；
• Dominion 4.7.3+；
• MySQL 8.0+ 或 MariaDB 10.6+；
• Vault 1.7+，可选，仅在启用付费订阅时需要。

插件是 Dominion 的附属插件，plugin.yml 声明了 Dominion 为硬依赖、Vault 为软依赖。服务器启动后应先加载 Dominion，再加载 DominionProtect。

安装步骤

1. 停止服务器并备份世界、数据库和 plugins/DominionProtect/；
2. 将购买后获得的 DominionProtect-<version>.jar 放入 plugins/；
3. 启动服务器，确认日志出现插件启用和数据库初始化成功；
4. 停服检查 config.yml，至少填写 database.host、database.database、database.username 和 database.password；
5. 再次启动，使用 /domp admin status <领地名> 检查订阅与记录状态；
6. 用非 OP 测试账号完成一次查询和一次小范围回滚。

数据库账号

数据库账号至少需要建表、临时表、删表、插入、查询、更新、删除和 ALTER 权限，因为插件会为领地创建独立记录表，并可能在线优化旧表。不要直接使用数据库 root 账号。

如果使用 MySQL / MariaDB，建议为本插件创建独立数据库和独立用户，并将数据库连接限制在服务器所在网络。

升级注意事项

升级前：

• 阅读当前版本的变更说明；
• 备份数据库，尤其是最大的 dp_records_<id> 表；
• 确认磁盘有额外空间，因为表结构优化可能临时复制数据；
• 选择低峰期执行升级。

启用 database.optimizeStorageOnStartup: true 后，插件会等待 storageOptimizationDelaySeconds，再在异步线程分批迁移旧记录。迁移期间会继续接收新记录；如果中途停服，下一次启动会继续安全流程。