PZ服务器网络稳定性补丁｜同步、Lua 降峰与兼容保护 [B42.2]

[h1]PZ服务器网络稳定性补丁 B42.2[/h1] 当前版本：0.3.13 本项目是根据多人服逐 Tick、Lua 热点、网络包和真实客户端异常日志制作的定点兼容补丁。它只处理已经确认的重复计算、无效同步和兼容缺陷，不是全局网络拦截器，也不能单独消除所有 Server is too busy、地图黑边或网络波动。 [h2]0.3.13：New Music 单轮候选优化[/h2] [list] [*]基于当前启用的0.3.12补丁和已核验的New Music源码，减少僵尸外观目标发布时多个玩家的重复全列表遍历。 [*]单轮建立临时空间候选，最终按原列表顺序选择；保留设备选择、标记写入、同步条件、数量上限、TTL和已有节流。 [*]少量玩家、密集候选、无效数据及未知源版本使用原扫描路径，不修改第三方订阅文件或存档格式。 [*]隔离服务器启动、源版本安装、正常保存退出与离线对照测试通过；实际收益受负载影响，不承诺固定TPS。 [/list] [h2]0.3.8：修复从属鸡舍 def 为空的二次回归[/h2] [list] [*]原版根因：Build 42.21 的 AnimalUpdatePacket 与 NetworkPlayerAI 会在客户端 IsoHutch.animalInside 中留下 null 槽位；IsoHutch.removeFromWorld() 却直接遍历全部值并调用 removeFromUpdateLists()，没有判断 null，玩家跨区块时可能连续报错甚至退出主菜单。 [*]0.3.7 的问题：0.3.7 已移除未暴露的 HashMap.entrySet():iterator()，但为了确定扫描上限又调用了 IsoHutch:getMaxAnimals()。最新 Build 25485538 字节码确认，从属鸡舍组件在 IsoHutch.load() 中会于 def 初始化前直接返回；getMaxAnimals() 随后读取 def.rawgetInt()，因此产生 this.def is null。 [*]0.3.8 修复：彻底取消 getMaxAnimals()。空 animalInside 直接安全通过；非空 Map 按 AnimalPacket.hutchPosition 的非负字节范围 0..127 调用 IsoHutch:getAnimal(Integer)，覆盖原版所有可表示槽位，不依赖鸡舍定义、贴图定义或主从组件状态。 [*]卸载顺序：先完整读取全部槽位并按动物对象身份去重；读取全部成功后，再让每只真实动物执行一次原版 removeFromUpdateLists()，最后清空即将废弃的客户端 Map。相同动物异常重复挂在多个槽位时也只处理一次。 [*]安全边界：纯客户端 Lua 保护；不发网络包，不回传清理后的 Map，不修改服务器权威动物、蛋箱、饲养结果、存档或 ModData。仍在任一本地 ChunkMap 范围内的鸡舍完全不动；读取失败时不会清空对象。 [*]验证：126 项补丁检查、23 个 Lua 文件语法、空从属鸡舍、非空 def-null 鸡舍、边界槽位 127、重复动物、空槽、读取失败、共享 ChunkMap、远距离跳转和全部模块行为测试通过；上游 Computer、DAMN、New Music、抗体、BuildingCraft、Better Hutches、Area Tasks/Lifestyle 与橙子交易关键文件哈希核验通过。 [/list] [h2]橙子交易原生性能适配[/h2] [list] [*]检测到完整 NativePerformanceRevision=1 能力集且 NativePerformanceEnabled 未关闭时，本补丁不再重复安装旧 Web Bridge 与供水包装器，避免双层调度、双层缓存和重复包装。 [*]能力缺失、不完整或明确关闭时，既有 Web 与供水实现仍作为兼容回退；服务端 Java FastBridgeJsonCodec 继续由性能 Agent 提供。 [*]不修改余额、股票、国库、工程价格、供水数据、客户端协议或存档结构。 [/list] [h2]其他同步与兼容模块[/h2] [list] [*]快捷栏：槽位数量、类型和顺序未变化时，不重复发送整份 IsoPlayer ModData；新增、删除、换位仍立即同步。 [*]Area Tasks + Lifestyle：区域砍树前复核目标树仍有效，失效目标安全结束动作；有效砍树奖励、经验、工具损耗和产物不变。 [*]Computer Mod：保护搬运恢复、界面和右键菜单的世界对象发送入口；普通方格不再被四个 LoadGridsquare 回调重复扫描，识别异常时完整回退上游。 [*]鸡舍相关：Better Hutches 相同 ModData 不重复广播、同帧多字段合并一次；原版取蛋前复核蛋槽，避免多人竞态 removeEgg(0) 与 AddItem(nil)。 [*]抗体与音乐：医疗文件按来源和接收玩家去重；Talis New Music 的重复僵尸分配与可视目标扫描分别降至原频率的 1/6 和 1/3。 [*]建造与其他：包含 BuildingCraft、Slow Gas Mask Filters、Open All Containers、Vanilla Foods Expanded、DAMN Library、五种医疗动作返回值和失效对象日志限流。 [/list] [h2]安装与回滚[/h2] [code]ComputerModkum;SlowGasMaskFiltersB42;LifestyleHobbies;AreaTasks;NewMusic;VanillaFoodsExpanded;OpenAllContainers;BuildingCraft;lgd_antibodies;STA_BetterHutches;damnlib;OrangeCommunityEconomy;PZServerNetworkStabilityPatch[/code] WorkshopItems 加入 3783018961，Mods 加入 PZServerNetworkStabilityPatch，并让本补丁位于上述目标 Mod 之后。停服后从 Mods 移除并重启即可回滚，不需要迁移存档。玩家与服务器必须通过同一工坊项目更新，禁止手工覆盖正式工坊缓存。 [h2]关键生效日志[/h2] [code][PZNetworkStability] 42.21 hutch pre-unload guard active (client-only, grid=true, add=true, remove=true, byte-slots=0..127, no-map-views)[/code] [code][PZNetworkStability] Orange native performance revision 1 detected; runtime performance wrappers disabled[/code] 目标 Mod 或游戏更新后若关键函数变化，应先重新核验兼容性，不应直接沿用旧补丁。