原创 付费 InvSync- 快速数据同步 2.5.2

[MD] # InvSync｜跨服背包与玩家数据同步 **让玩家切换子服后，继续使用自己的背包、末影箱、经验和状态。** 适合生存群组服、资源服，以及有插件扩展或模组数据同步需求的服务器。 > **原帖与最新文档：** > https://halo.xbaimiao.com/invsync/ > > 本页面不保证及时更新。**支持版本、价格、购买权益与部署说明均以原帖为准。** --- ## ✨ 你可以用 InvSync 做什么？ - **跨服延续玩家数据**：同步背包、末影箱、经验、血量、药水效果、进度等，按需开启。 - **减少切服后的同步等待**：使用可选启用的预加载功能，在切服交接阶段提前准备玩家数据。 - **管理玩家历史备份**：游戏内查看备份记录，预览背包与末影箱，并按需恢复。 - **编辑离线玩家物品**：内置离线背包与末影箱编辑功能。 - **接入插件与模组数据**：提供已有适配和开发者 API，支持开发自定义同步扩展。 **购买方案：128 元，包含主插件与跨服预加载组件。** 预加载功能按需启用，不使用预加载也可以正常进行跨服同步。 --- ## 📋 使用环境 | 项目 | 说明 | |---|---| | Minecraft | 1.12.2 – 26.3，具体服务端及功能兼容范围以原帖为准 | | 服务端 | 支持 Spigot / Paper / Folia；模组混合端需确认具体版本与适配 | | 持久化存储 | MySQL 或 MongoDB，二选一 | | Redis | 必需，用于玩家数据缓存及跨服协调 | | 主插件 Java | 最低 Java 8，同时需满足当前 Minecraft 和服务端自身要求 | | 预加载代理端 | Velocity 或 BungeeCord，代理端插件要求 Java 17+ | > 主插件与预加载的支持范围并不完全相同。 > **预加载子服的兼容范围、具体部署要求请先查看文档。** > > 使用特殊服务端、模组或自定义物品插件时，建议购买前联系作者确认环境，并在测试服验证。 --- ## 🎒 跨服同步能力 ### 原版玩家数据 | 数据 | 默认同步 | |---|---| | 背包、装备与副手 | ✅ | | 末影箱 | ✅ | | 经验与等级 | ✅ | | 血量、饥饿值 | ✅ | | 药水效果 | ✅ | | 成就进度、统计数据 | ✅ | | 最大血量 | ❌ 按需开启 | | 玩家 PDC 持久化数据 | ❌ 按需开启，需对应版本支持 | | 游戏模式 | ❌ 按需开启 | | 玩家位置 | ❌ 按需开启 | | OP 状态 | ❌ 按需开启 | 同步项可以按服务器需求配置。 > 位置同步适用于确实需要共享位置的场景，不建议在不同地图的子服之间盲目开启。 > OP 状态等权限相关功能请谨慎配置。 ### 插件与模组适配 已有适配包括： - CMI 飞行能量 - Vault 经济余额 - LibsDisguises 相关集成 - 指定版本的 Pixelmon 宝可梦数据 - 指定版本的时装工坊、FTB Quests、神秘时代数据 具体版本与支持范围请查看原帖，不代表任意版本均可直接使用。 以下第三方扩展需要另行购买，**不包含在 InvSync 完整包中**： - 精妙背包同步扩展 - 1.16.5 宝可梦同步扩展 > **Vault 经济同步的重要限制：** > > InvSync 的余额同步不等同于完整的跨服经济系统。 > 玩家离线期间由商店、奖励指令或其他插件产生的余额变动，不保证被正确跨服合并，可能被同步记录覆盖。 > > 有离线交易、跨服拍卖等需求时，建议使用自身具备跨服能力的经济方案，并避免两套系统同时管理余额。 --- ## 🚀 跨服预加载｜完整包内含 普通同步需要在玩家进入目标子服后读取并应用数据。 启用预加载后，InvSync 会利用代理端的切服交接阶段： 1. 通知源服提前保存玩家数据。 2. 通知目标服提前读取并准备数据。 3. 对支持的玩家基础字段提前写入存档，减少进服后集中应用数据的开销。 **目标是减少切服后的同步等待，而不是承诺所有环境都达到固定延迟。** 实际效果取决于服务器性能、网络、数据库位置、玩家数据量和其他插件。 ### 支持的部署方式 | 项目 | 支持情况 | |---|---| | Velocity | ✅ | | BungeeCord | ✅ | | Redis 通信 | ✅ 推荐，复用现有 Redis | | 多代理部署 | ✅ 使用 Redis 通信 | | WebSocket 通信 | ✅ 保留兼容方式 | 预加载未命中或准备失败时，会按流程回退到普通同步路径。 **回退不代表可以绕过数据库、Redis 或数据有效性检查。** > **Java 要求针对代理端：** > Velocity/BungeeCord 的预加载插件要求 Java 17+。 > 子服按主插件、当前服务端及预加载兼容范围确认运行环境。 部署前请阅读： https://halo.xbaimiao.com/invsync/ --- ## 🛟 玩家历史备份与恢复 玩家数据出现误操作或异常时，管理员可以检查历史备份并选择恢复。 - 支持手动创建备份。 - 可配置退出、自动保存、世界保存时创建备份。 - 游戏内浏览备份列表。 - 预览备份中的背包与末影箱。 - 支持最近、每日、每周、每月分层保留策略。 > **历史备份默认关闭，需要在配置中主动启用。** > > 恢复会覆盖备份所包含的玩家数据，请先核对备份内容。 > 插件内历史备份不能代替独立的数据库备份。 --- ## 📝 玩家物品编辑 - **离线玩家**：可使用 InvSync 内置功能编辑背包与末影箱。 - **在线玩家**：请使用 CMI 等适用于当前玩家所在服务器的管理工具。 - 玩家在线或数据被锁定时，内置离线编辑功能会拒绝打开。 内置命令与操作说明以原帖为准。 --- ## 🔄 从其他插件迁移 InvSync 提供多种数据迁移工具，已包含的迁移器有： - PlayerDataSQL - KnapsackToGo4 - MysqlPlayerDataBridge - MySqlPlayerBridge - HuskSync - PlayerSync **迁移兼容性与源插件版本、数据格式有关，不能只凭插件名称判断。** 建议流程： 1. 备份源数据库、配置和玩家存档。 2. 停止参与同步的子服，按文档保留迁移所需的源插件或配置。 3. 在指定服务器执行迁移。 4. 检查处理结果，抽样验证关键玩家数据及特殊物品。 5. 确认无误后，再切换正式环境。 > 不建议在玩家正常游玩期间直接迁移。 > 迁移完成前不要删除源数据，具体命令和注意事项请查阅原帖。 --- ## 🔌 开发者 API 提供玩家数据接口、同步与保存事件，以及 Addon 扩展机制。 第三方开发者可以接入自定义数据；具体数据格式、线程要求和兼容性由扩展实现负责。 开发者文档： https://halo.xbaimiao.com/invsync/developer/ --- ## 💰 购买与更新 ### InvSync 完整包：128 RMB 包含： - InvSync 主插件 - Velocity / BungeeCord 预加载组件 - 内置备份与恢复功能 - 内置离线编辑功能 - 开发者 API **预加载不再单独收费，第三方扩展不包含在完整包内。** ### 已购用户 已购买 InvSync 主插件的用户可免费获得预加载组件。 已购买过预加载的用户，老用户权益安排请查看原帖公告或联系作者确认。 ### 联系方式 **购买与咨询 QQ：3104026189** 无在线授权验证系统。购买后可通过售后网站下载最新版；使用与分发仍需遵守购买授权规则。 反馈问题时，请提供： - InvSync 版本 - Minecraft、服务端及 Java 版本 - 相关插件或模组版本 - 完整错误日志与发生时间 - 操作步骤及涉及的子服 --- ## 📖 完整文档与原帖 **最新支持范围、配置文件、迁移命令、预加载部署和购买公告：** https://halo.xbaimiao.com/invsync/ **本页更新可能滞后，请以原帖为准。** [/MD]