
BSP库存同步
一个专为在代理后运行Forge的多网络服务器配合使用的物品栏同步模组。

BSP-InventorySync
你的物品栏会跟随你穿越 Build Secure Protect 网络。 从一台 BSP 服务器迁移到另一台,你所携带的一切以及角色的所有信息都已就位:物品栏、盔甲、末影箱、经验、生命值、药水效果,以及整合包中各个模组的玩家个人数据。专为 BSP 网络打造——在该网络中,BSP-Core 的碎裂图腾绝不能重复或丢失。
仅服务端安装:玩家无需安装任何内容。适用于 Minecraft 1.20.1、Forge 47.4。需要 BSP-Core。采用 MIT 许可证,源码见 GitHub。
面向玩家
无需学习任何内容。切换服务器时,你会在原地短暂停留,等待物品送达——通常短得察觉不到——然后从上次离开的地方继续。如果来源服务器响应较慢,你最多等待十秒,并且会被告知是否有内容可能已过期。

随你一同迁移的内容
- 物品栏、盔甲、副手、当前选中的快捷栏槽位以及光标上的物品。
- 末影箱。
- 经验、等级进度和分数。
- 生命值、饥饿值、饱和度、氧气和药水效果。
- 游戏模式、飞行状态和重生点。
- 进度,且不会重复领取其奖励。
- Curios 槽位、精妙背包(Sophisticated Backpacks)内容(包括背包中的背包)、Dank Storage 内容、你已解锁的传送石碑、Mekanism 辐射,以及任何其他模组的玩家个人数据。
保留在各服务器上的内容
你的碎裂图腾(由 BSP-Core 以其自身方式携带,详见下文);统计数据和配方书。
服务器缺少对应模组的物品

如果你到达的服务器缺少你某个物品所属的模组,该物品会变成一张以其名称命名的纸。不会丢失任何东西:这张纸保留了原始的全部数据,并在拥有该模组的服务器上变回原物品。
面向服务器管理员:安装
- 将 jar 放入每台后端服务器的
mods/目录,与 BSP-Core 1.1.0 或更新版本并列。客户端无需任何操作。 - 每台服务器启动一次。配置文件会出现在
<world>/serverconfig/bsp_inventorysync-server.toml。 - 设置
storage.mode = "mysql"。默认情况下,数据库设置和本服务器的名称从 BSP-Core 自身的storage配置中读取,因此已在 MySQL 上运行 BSP-Core 的网络无需额外配置。设置storage.useBspCoreDatabase = false可为该模组单独指定主机、用户名和密码。 - 可选但推荐:设置
redis.enabled = true并填写 Redis 主机和密码。Redis 让切换即时完成;若不使用,切换仅需等待来源服务器的存档写入 MySQL。 - 重启,或运行
/invsync reload。日志会显示 “tables ready on mysql …”,若启用 Redis 则还会显示 “redis host:port connected”。/invsync status会显示相同信息。
每台后端服务器都必须指向同一个数据库和同一个 Redis,并且各自拥有不同的服务器名称,且必须与 Velocity 服务器名称一致。
服务器切换的工作方式

你离开的服务器会生成一份快照,将其写入 MySQL 并缓存到 Redis,然后将你标记为已释放。你到达的服务器会在登录时冻结你,每 tick 轮询该释放标记,一旦看到便立即应用快照。在冻结期间,你做的任何事都无法复制该服务器持有的过期副本:无法移动、点击、拾取或丢弃、受到伤害。
如果释放标记在超时时间内(arrival.timeoutSeconds,默认 10 秒)未到达,服务器会应用它能找到的最新快照,并告知你可能已过期。偏好严格行为的管理员可设置 arrival.kickOnTimeout = true,此时会拒绝登录,让玩家可以重试。
在数据到达前断线的玩家,其数据绝不会被覆盖保存。以死亡状态到达的玩家会在重生时获得其数据。
为 BSP-Core 的碎裂图腾而打造

BSP-Core 已在图腾主人离开时进行处理:普通登出时将其放置在世界中,或在 BSP-Teleport 将玩家送往另一服务器时将其保存以供旅程使用。无论登出事件的触发顺序如何,BSP-InventorySync 绝不会将活跃图腾写入快照,因此同步绝不会复制图腾。到达时,BSP-Core 会在登录后几 tick 交还图腾;同步会保留它,围绕它应用快照,并通过 BSP-Core 归还,因此它绝不会掉落或被覆盖。随后 BSP-Core 才投递待处理物品并执行赛季金币检查。
管理员命令
该模组没有图形界面;操作员所需的一切都在聊天栏中,位于 /invsync 下(权限等级 2)。

| 命令 | 作用 |
|---|---|
/invsync status |
本服务器的名称、数据库和 Redis 状态、正在等待数据的玩家数量、自动保存计数器、数据模块,以及一次数据库 ping 检测。 |
/invsync snapshots <player> |
该玩家的快照,最新的在前:版本、原因(登出、转移、死亡、自动保存、世界保存、管理员)、由哪台服务器保存、多久之前、大小、是否固定。对服务器已知的离线玩家同样有效。 |
/invsync restore <player> <version> |
将该快照恢复到在线玩家身上。用于撤销丢失。 |
/invsync resync <player> |
再次应用最新快照。 |
/invsync pin <player> <version> / unpin |
固定的快照绝不会被轮替删除。 |
/invsync save <player> |
立即生成一份快照。 |
/invsync dump <player> |
显示玩家数据各部分的大小,并将完整内容以可读文本写入 world/bsp_inventorysync/dumps/,用于提交 bug 报告。 |
/invsync reload |
重新读取配置并重新连接数据库和 Redis,不影响在线玩家。 |
快照与回滚

每次保存都会以带编号的快照及其原因保留。每位玩家保留最近 16 份(storage.snapshotsKept);被固定的快照永久保留。当玩家因 bug 或恶意破坏丢失物品栏时,用 snapshots 找到事发前的快照,再用 restore 恢复。
保存、性能与容错
- 保存会在以下时机发生:登出、服务器转移、死亡(在重生时,此时掉落物已离开物品栏)、世界保存,以及每 60 秒(
storage.autosaveSeconds)对自上次保存以来数据发生变化的玩家。未变化的玩家不产生数据库写入;空闲玩家也不会触及任何文件。 - 每份快照为一条压缩记录。每个数据模块独立运行,因此某个集成失败绝不会让玩家失去其余数据。
- 通过纯 JDBC 连接 MySQL;不捆绑数据库驱动,因此不会与服务器自带的驱动冲突。通过该模组自带的轻量客户端连接 Redis;同样不捆绑任何内容。
- 看门狗(
storage.timeoutSeconds,5 秒)会放弃任何无响应的数据库或 Redis 调用,因此冻结的数据库绝不会让玩家冻结或让服务器在关闭时卡住。Redis 中断只记录一次日志,MySQL 单独继续运行。
兼容性
BSP-Core(必需)。BSP-Core 的碎裂图腾正是本模组存在而非采用通用同步方案的原因:上述图腾规则、到达时的交还,以及 BSP-Core 的投递和赛季金币检查等待恢复完成。数据库设置和服务器 ID 默认与 BSP-Core 的配置共享,因此网络只需配置一次。
BSP-Teleport(可选)。BSP-Teleport 的跨服务器传送与任何其他服务器切换一样,通过握手处理,无需配置:BSP-Teleport 的落地先生效,恢复随后进行,此时玩家仍冻结在落地点。API 还提供 beginTransfer,传送模组可在代理切换前调用,以便玩家离开时保存已在执行中。
Curios、Sophisticated Backpacks、Dank Storage(可选)。每个模组都有自己的适配器,仅在模组存在时注册。任何其他模组的玩家个人数据通过通用模块传输,无需适配器。
面向模组开发者
包 com.mrgregles.bsp_inventorysync.api:注册 DataModule 以将你自己的玩家个人数据随快照携带,将物品排除在快照之外,在信任玩家物品栏前调用 isSyncing(uuid),或宣告一次转移。服务端线程上的两个 Forge 事件:InventorySavedEvent(快照已落入存储时)和 InventoryRestoredEvent(每次恢复时,在数据模块运行后触发一次)。详情见 docs/API.md。
属于 Build Secure Protect 系列:BSP-Core、BSP-Teleport、BSP-Region Guard 和 BSP-InventorySync。设计参考 PlayerSync、PlayerSync Performance Plus 和 HuskSync;在 MIT 许可证下从零编写。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。