外观
🛡️ 兼容性与限制
本文依据 InvSync 2.5.31 仓库；支持范围与实测范围需要区分。
环境要求
| 项目 | 说明 |
|---|---|
| Minecraft | 主插件保留 1.12.2 等旧版本兼容路径，当前发布已适配至 26.3；不意味着每个版本、每个分支和每种组合均已实测 |
| 服务端 | Bukkit / Spigot / Paper 系；项目包含 Folia 调度适配，第三方插件也必须满足 Folia 要求 |
| 主插件 Java | 主项目目标 Java 8；服务端要求 Java 17/21/25 时按服务端要求运行，不要为了插件降低 Java |
| 预加载代理 Java | Velocity / Bungee 插件目标 Java 17，代理必须 Java 17+ |
| 数据服务 | Redis 必需；MySQL 与 MongoDB 选择一种持久化存储 |
| 模组与混合端 | 按特定模组、版本和服务端组合验证，不承诺任意模组通用兼容 |
跨版本不是降级工具
网络内优先统一 Minecraft、InvSync、序列化配置和自定义物品注册表。新版物品不保证能在旧服读取；尤其 1.20.5 前后以及后续装备结构变化，不能把 ViaVersion 等协议兼容当作数据兼容。
预加载的额外边界
子服没有因为代理构建目标而统一要求 Java 17，但离线预写仍受子服 NBT、玩家存档结构和服务端行为影响。建议使用经过验证的 Paper/Folia 环境；旧版本或混合端先确认支持再部署。
本地玩家档案不存在时会跳过离线写；自定义插件/模组数据仍需通过各自回调恢复。不能承诺所有字段都在出生前准备完毕。
不要误解这些功能
- Redis prefix 不是完整的玩法档案分组。 主表仍按 UUID 存储；要隔离两套玩家数据，使用不同持久化库，同时隔离 Redis 库/前缀。
- PDC 同步不等于插件外部数据库同步。 插件可能把技能、任务存到独立数据库。
- 位置同步只适合坐标具有相同意义的环境。 名字相同的不同世界不一定相同，盲目开启可能把玩家传送到危险位置。
- OP 同步默认关闭。 不建议作为权限系统跨服同步方案。
- Vault 余额不是跨服经济事务系统。 离线交易可能与保存的旧余额冲突。
- 物品过滤不是暂存仓库。 被过滤的物品不进入同步快照，不能保证回原服取回。
升级前怎么验证
在隔离测试环境使用数据库副本，测试普通物品、带 PDC/lore/附魔的自定义物品、装备、副手、容器嵌套物品、扩展数据和重复跨服。成功后仍保留完整备份。