管理员文档 · 总览
面向服主与运维人员的 Dominion 部署、配置、备份和排障入口。
管理职责
管理员不需要替玩家逐个管理领地，但需要保证插件有一个稳定、可解释的运行边界：
- 选择服务器核心与 Java 运行环境；
- 保管
plugins/Dominion/下的数据库与配置； - 定义默认 flag、玩家限制和未认领区域规则；
- 决定使用 SQLite 还是外部数据库，设置多服开关；
- 在升级、迁移和导入之前完成备份；
- 用普通账号验证访客行为，而不是只用 OP 账号测试。
一次完整的部署顺序
- 启动服务端，确认 Java 运行环境与服务端核心本身稳定；
- 把 Dominion 发行版 JAR 放进
plugins/，启动一次让插件生成文件； - 核对启动日志中的数据库连接和
Plugin Enabled!； - 停服备份
plugins/Dominion/，再修改config.yml、flags.yml、limitations/和world-wide/； - 用
/dominion reload config重载配置，或在维护窗口重启； - 用普通玩家账号创建一个测试领地，依次验证访客、成员、权限组和环境 flag；
- 通过常见问题与日志确认没有隐性回退，再开放给全体玩家。
配置文件地图
| 文件 | 管理内容 | 修改方式 |
|---|---|---|
config.yml | 数据库、语言、UI、自动创建、消息、边界显示、跨服和集成开关 | 可改；version 不要改 |
flags.yml | flag 的启用状态、默认值、UI 图标物品 | 可改；改动会影响可选项与数据库字段 |
languages/*.yml | 提示、菜单文本和 flag 名称描述 | 可改；也可用 update_language 重建 |
limitations/*.yml | 领地数量、尺寸、经济、传送和垂直范围 | 可按玩家组新增文件 |
world-wide/*.yml | 未认领区域的环境与访客规则 | 可按世界新增文件 |
dominion.db 或外部数据库 | 领地、成员、组、模板和玩家偏好 | 不要手工改表；先备份并用插件命令操作 |
生产环境的最小安全基线
database:
type: sqlite
ui:
default: CHEST
auto-create-radius: 10
server-spawn-protection-radius: 10
admin-bypass: true
check-update: true这是生成配置的默认基线，不是适合所有服务器的最终策略。生产服应先用普通账号验证 container、place、break、爆炸和传送规则，再开放更多权限。
管理员文档导航
- 功能清单：按玩家、领地、权限、环境和运维归类当前能力。
- 安装与升级：安装、文件生成、日志确认、升级和备份顺序。
- 配置文件总览：修改顺序和四类配置的关系。
- config.yml 参考：主配置所有当前键的解释。
- flags.yml 参考：环境 flag、权限 flag 和配置格式。
- limitations 参考：数量、尺寸、经济、传送和玩家分组限制。
- world-wide 参考：未认领区域的世界规则。
- 管理员命令：重载、备份、导入导出、迁移和普通管理命令。
- 权限节点与权限模型：
dominion.default、dominion.admin与 flag 的分工。 - 集成总览：数据库、Vault、WorldGuard、Residence 和服务端平台集成。
- PlaceholderAPI：完整占位符参考、显示示例和排错方法。
- 跨服务器功能：共享数据库、服务器 ID、缓存同步与跨服传送。
- 扩展与 API：API、事件和扩展开发注意事项。
- 社区附属插件：社区开发的 Dominion 附属插件目录。
- 常见问题：按现象定位配置、启动或权限问题。
- 赞助支持：赞助权益与实现边界。