Repository navigation
Create: Distant Stock v0.3.64 — 加入提示反复出现 / 跨服库存空白修复
现象与修复
加入码输入正常,却反复提示“等待期间手持终端或其网络已改变”
原 0.3.63 的判断依赖 ItemStack 对象引用相同(held != pending.terminal())。Minecraft 可在同步手持物品时重新实例化 ItemStack,不代表玩家换了终端。现在终端第一次加入前写入独立的持久 DistantStockJoinIdentity UUID;收到跨服确认时核对 UUID + 原远仓网络身份,而不是 Java 对象地址。更换另一台终端或真正修改网络依然会取消旧请求。相同终端/代码在短窗口内合并请求,但 15 秒之后允许再次发起以便恢复异常排队。旧/重复确认不再重投或刷屏。
VL4 有真实仓库和物品,但 ES2 终端显示空
跨服库存以前会在被请求仓库冷缓存时立即回应 RETRY,从而触发持久队列重试而不一定及时得到库存第一页。现在最多缓存 32 条等待的库存查询,按原有限流的 StockScanner 节拍扫描本地仓库;缓存一旦准备好,回复本次查询,避免产生不必要的 RETRY 或对每次面板打开执行全库扫描。等待超过 30 秒才交还给 Transerver 重试。首次空快照仅保留约 5 秒(之前可保留 15 分钟),避免空仓状态掩盖后来加载到的库存。终端对远端无库存的提示改为“远端库存同步中,或对端暂无可用库存”,不再确定地宣称仓库为空。
/distantstock stock 增加“等待本地库存采样的跨服查询”数量,近期查询记录也标注“等待采样”或实际发送的页/行数。
不变的入网规则
- 加入码或网络 8 位 ID 只让终端加入远仓网络;不把 Create 仓库自动塞进去。
- 必须手持已加入远仓网络的便携终端,右键已绑定 Create 网络的远仓港,由 Create 管理员纳入该仓库。
- 仓库列表只显示属于当前远仓网络的仓库,不可直接点击未入网仓库来自动纳入。
- v0.3.62 已经误绑定的仓库不会擅自删除;请备份后由其 Create 管理员核查。
部署与验收
- ES2、VL4 服务端与配套客户端均更新 DistantStock 0.3.64。Transerver 保持 0.1.1,独立 Router 不变。关闭服并备份世界、网络目录、身份和持久消息队列,不要删除 inbox/outbox/dead-letter。
- ES2 用手持便携终端输入 VL4 的 8 位 ID 或加入码,保持手持直到收到确认;检查无反复的“终端变化”提示。切换终端应正确取消本次请求。
- VL4 先确保 Create 仓库通过右键远仓港合法入网,且 Create 原生仓管确实能看到库存。
- ES2 选择远程仓库并观察分页填充。ES2
/distantstock stock应能看到正在查询的网络、缓存条数和答复年龄;VL4/distantstock stock应记录最近收到的查询、采样等待数量和发出的库存页。 - 然后用少量物品测试 ES2 发请求、VL4 打包、跨服发送、ES2 收货。此最后环节需要真实线上验收。
验证范围
- 302/302 Minecraft GameTests 通过,含 ItemStack 重建后仍能成功绑定相同终端、真正替换终端仍拒绝、旧加入确认静默消费、冷缓存等待采样、空快照过期后可重新看到实际库存。
- Wire codec / AsyncSender / 包裹所有权 / 其它针对性资源检查通过。
- 真实 ES2↔VL4 物品交付尚未现场验证,不能将开发环境 GameTest 通过视为线上成功。