✦ CloudSync 云同步
适用核心Paper | Purpur适用版本1.21.4 – 1.21.11前置MySQL 8 | MariaDB是否付费一次购买 · 永久包更购买价格68R最新版本v1.0.1代理端BungeeCord | Velocity 均可
玩家在哪个分流，资料就只属于那个分流；换分流时先存好、再交出去、对方验证完才载入。 不靠「延迟几秒再读」碰运气，用数据库层面的锁与版本号保证：不复制、不回档、不丢东西。
为什么选择云同步
跨服同步最怕的不是「慢」，而是同一份背包同时在两个分流被使用：切服太快读到旧存档就是回档，两边都存就是复制，分流一崩溃全服玩家被锁住。 云同步把每一位玩家的资料当成一笔需要「借出 / 归还」的交易来处理，所有关键判断都在 MySQL 的事务里完成，而不是靠时间差。
租约锁
同一位玩家同时只有一个分流持有资料。另一个分流想载入，必须等对方存好并归还，不会两边各拿一份。
版本号 + 校验码
每次存档版本号 +1，只有「持有者 + 版本号都对得上」才写得进去；载入前再验 SHA-256，旧资料永远盖不掉新资料。
分流崩溃自动接管
锁只在持有分流还有心跳时有效。分流崩溃后，玩家到别的分流可直接载入最后一份完整存档，不用 管理员一个一个解锁。
断线先冻结
数据库卡顿、续约失败时立刻冻结玩家（不能搬东西、丢东西、交易），保证「先冻结、后被接管」，卡顿也复制不了物品。
切服不被误踢
上一个分流还在存档时，新分流会冻结玩家最多 5 秒等它存完，再载入最新存档，不会出现「资料仍被占用」把人踢出去。
维护模式与安全重启
/maintenance run：先存档、冻结，再把玩家送到大厅或安全踢出，确认清空后才关服。任何一位玩家存档失败就自动取消。
0次依靠「延迟读取」
5秒切服等待（可调）
10份历史快照 / 人
4 MB单人快照上限（防塞爆）
1个 MySQL 搞定全网
和常见做法、HuskSync 的完整对比见 为什么选择云同步，原理见 工作原理。
功能一览
| 模块 | 能做什么 |
|---|---|
| 同步内容 | 背包、盔甲、副手、手持格、末影箱、经验、生命（含最大生命基础值）、着火、饥饿 / 饱和、药水效果；游戏模式与飞行可选；Vault 余额可选（managed 模式） |
| 防复制 / 防回档 | 租约锁 + 版本号条件写入 + SHA-256 校验，全部在 MySQL 事务中完成 |
| 崩 溃处理 | 分流心跳；无心跳的分流持有的锁自动失效；每 30 秒自动清理；分流重启时回收自己残留的锁 |
| 切服 | 一般 /server 切换自动等待上一个分流存完；Bungee 加强模块提供「先存档再转服」与负载均衡 |
| 防塞爆 | 压缩后的快照超过上限就拒绝写入并取消转服，提示玩家先清空潜影盒 |
| 历史快照 | 每人保留最近 N 份存档（默认 10），出问题可追溯 |
| 维护 | 维护模式（挡一般玩家登录、重启后仍保留）、安全排空重启、管理员可留服巡视 |
| 启动保护 | MySQL 连不上或配置错误时挡下所有登录，不让玩家用本地旧资料游玩 |
| 加速 | 可选 Redis 快速通道，Redis 故障自动回退 MySQL |
| 多网络 | 自定义数据表前缀，多组服务器可共用一个数据库 |
只装 Paper 端就能用
每个分流装 CloudSync，连到同一个 MySQL 就完成了，代理端用 BungeeCord、Waterfall 还是 Velocity 都可以。
Bungee 加强模块（附赠）是选用的：提供 /csp send 先存档再转服，以及按 TPS / 人数 / 内存 挑最健康的分流。