故障处理

插件没有启用

检查：

• Java 是否为 17+；
• Dominion 是否已安装且版本满足要求；
• JAR 是否放在正确的 plugins/ 目录；
• 启动日志中是否有依赖加载或 plugin.yml 错误。

DominionProtect 不能脱离 Dominion 单独运行。

数据库连接失败

检查 config.yml 中的 host、port、database、username 和 password，并确认数据库用户具备安装文档列出的权限。若连接池初始化失败，先暂停玩家订阅和记录，再查看完整服务器日志。

查询没有结果

依次确认：

1. 你在目标 Dominion 领地内；
2. 领地存在有效订阅；
3. 你拥有 dominion_protect_view flag；
4. 时间、动作、玩家和方块名称使用了正确格式；
5. 对应动作没有被 recording.disabledActions 禁用；
6. 记录没有超过保留期，或已被配额策略淘汰。

订阅失败

• Vault 未安装或经济插件未提供有效 Economy；
• 余额不足；
• 方案 ID 不存在；
• 当前领地已有活跃订阅；
• vaultUnavailableStrategy 禁止无 Vault 订阅。

使用 /domp plans、/domp status 和服务器日志逐项确认。

回滚被拒绝或没有预览

缩小 t:、p:、a:、b: 或 r: 范围。记录数超过 rollback.maxRecords 会被拒绝；超过 rollback.previewMaxBlocks 时，插件会改走确认提示而不是幽灵方块预览。确认窗口默认只有 30 秒。

数据库写入失败

检查 plugins/DominionProtect/failed-records/ 是否出现失败文件，并保留文件和服务器日志交给维护者。不要直接删除失败记录来掩盖问题；确认数据库恢复后再按项目支持的流程重试或清理。