配置文件
分流端：plugins/CloudSync/config.yml；Bungee 端：plugins/CloudSync-Bungee/config.yml。改完请完整重启（不要用 /reload）。插件更新时会自动补上新增的配置项。
分流端
基本
| 配置项 | 默认值 | 说明 |
|---|---|---|
server.id | CHANGE_ME | 本分流的 ID，每个分流必须不同。未修改时插件会挡下所有登录 |
数据库
| 配置项 | 默认值 | 说明 |
|---|---|---|
storage.type | mysql | 只支持 MySQL / MariaDB |
storage.mysql.host / port / database | localhost / 3306 / cloudsync | 所有分流要连同一个数据库 |
storage.mysql.username / password | root / change_me | 数据库账号 |
storage.mysql.ssl | false | 跨机房 / 公网连接时设 true（要求 TLS） |
storage.mysql.pool-size | 10 | 连接池大小（2 – 32） |
storage.table-prefix | auto | 数据表前缀。auto = 自动；填自定义值（如 survival_）可让多组网络共用一个数据库，所有分流与 Bungee 端要一致 |
同步内容
| 配置项 | 默认值 | 说明 |
|---|---|---|
sync.interval | 30 | 自动存档间隔（秒，最少 10） |
sync.inventory | true | 背包、盔甲、副手、手持格 |
sync.ender-chest | true | 末影箱 |
sync.experience | true | 等级与经验 |
sync.health | true | 生命、最大生命基础值、着火 |
sync.hunger | true | 饥饿、饱和度 |
sync.potion-effects | true | 药水效果 |
sync.gamemode | false | 游戏模式 |
sync.flight | false | 是否允许飞行、飞行速度 |
sync.economy.mode | external | external：经济插件自己跨服（推荐）；managed：由云同步同步 Vault 余额；disabled：不处理 |
经济模式
经济插件本身已经用同一个数据库跨服共享余额时，不要使用 managed：两个系统同时管同一份余额会造成回档或重复入账。
切服与锁
| 配置项 | 默认值 | 说明 |
|---|---|---|
transfer.lease-seconds | 20 | 租约长度（秒），持有中会自动续约 |
transfer.wait-for-previous-server-seconds | 5 | 切服时上一个分流还没存完，最多等几秒（0 = 不等，直接提示稍后再试） |
transfer.reclaim-dead-owner-after-seconds | 30 | 分流停止心跳多久后视为崩溃、可被接管（自动调整为至少租约 + 8 秒） |
transfer.arrival-timeout-seconds | 30 | Bungee 转服准备好后，玩家多久没到达就在原分流恢复 |
存档保护
| 配置项 | 默认值 | 说明 |
|---|---|---|
snapshot-protection.enabled | true | 启用快照大小检查 |
snapshot-protection.warning-bytes | 1048576 | 超过就在控制台警告（压缩后大小） |
snapshot-protection.maximum-bytes | 4194304 | 超过就拒绝写入并取消切服 |
snapshot-protection.unclean-lease-grace-seconds | 45 | 异常断线后额外隔离的秒数；-1 = 永不自动解锁，需管理员 /cs unlock expired |
history.enabled | true | 保存历史快照 |
history.maximum-unpinned-snapshots | 10 | 每人保留几份 |
safety.block-logins-when-unavailable | true | 启动失败（配置错误、连不上数据库）时挡下所有登录 |
Redis（可选）
| 配置项 | 默认值 | 说明 |
|---|---|---|
redis.enabled | false | 开启转服快速通道；故障时自动回退 MySQL |
redis.host / port / username / password / database / ssl | — | 连接设置 |
redis.snapshot-ttl-seconds | 60 | 快照在 Redis 保留的秒数 |
维护与重启
| 配置项 | 默认值 | 说明 |
|---|---|---|
maintenance.enabled | false | 维护模式（用 /maintenance on/off 切换，重启后保留） |
maintenance.action | kick | kick 存档后踢出；transfer 送往大厅 |
maintenance.ready-timeout-seconds | 30 | 等待玩家完成同步的上限 |
maintenance.deny-message / transfer-message / kick-message | — | 提示文字 |
restart.enabled | true | 允许 /maintenance run |
restart.allowed-lobbies | [lobby] | 可送往的大厅（代理端的服务器名称） |
restart.stop-command | stop | 清空后执行的关服指令 |
restart.drain.empty-timeout-seconds | 30 | 等待清空的上限，逾时取消关服 |
其他
| 配置项 | 默认值 | 说明 |
|---|---|---|
heartbeat.interval-ticks | 40 | 心跳间隔 |
messages.* | — | 同步中、同步完成、资料被占用、同步失败、快照过大的提示 |
Bungee 端
| 配置项 | 默认值 | 说明 |
|---|---|---|
storage.mysql.* | — | 与分流端相同的数据库 |
storage.table-prefix | auto | 与分流端一致 |
transfer.timeout-seconds | 30 | 转服准备的超时 |
load-balancing.max-players / minimum-tps / maximum-memory-percent | 100 / 18.0 / 90.0 | 超过这些条件的分流不会被选中 |
load-balancing.weights.* | — | 评分权重：优先级、人数、TPS、内存 |
load-balancing.groups | — | 群组 → 分流 ID 列表（分流 ID = 各分流的 server.id = 代理端的服务器名称） |
load-balancing.priority | — | 分流优先顺序 |
messages.* | — | 转服相关提示 |