轻量级扩展世界客户端同步修复：为多人客户端（对等主机和专用服务器）提供自定义生物群系音乐和环境。

同步

针对自定义生物群系音乐和环境的客户端同步修复，专为Expand World模组套件设计。

修复内容

当玩家加入多人服务器（点对点或专用服务器）时，Expand World Data 会同步 生物群系数据 给他们的客户。然而，如果客户收到这些数据 之前 他们的世界地点已加载完毕，模组会悄然跳过应用自定义生物群系音乐和环境权重。

最重要的是， 它从不重试。 客户端只会听到一片死寂或原版音乐，而非你自定义的音乐；看到的也是原版天气，而非你自定义的环境。EWSync 会强制正确应用这些数据、进行验证，并在玩家生成时实施延迟安全重试，以确保服务器与客户端之间完美同步。

为什么需要这个？

轻量级服务器可能永远不会注意到这个问题。然而，重度模组化的服务器（如MMOHeim）会大幅增加客户端的加载时间，从而产生一种“竞态条件”——服务器数据早已到达，而客户端实际上还未准备好处理这些数据。默认情况下，如果EWD首次执行失败，它会完全跳过该应用。

如果你运行一个使用了自定义 .ogg 通过Expand World添加音乐文件和自定义天气环境，这个模组确保加入的玩家能真正体验到它们。

优化

EWSync在构建时采用了严格的性能保障机制，完全由事件驱动，绝不依赖高负载的逐帧轮询。当自定义数据在玩家首次加载世界时成功同步后，该模组将在本次游戏会话的剩余时间内永久休眠，确保在战斗、传送门跳跃或重生期间对帧率零影响。

为确保设置不会延续到下一次游戏会话，该模组会在登出和主菜单切换时主动清除其会话状态，而不是仅依赖 Valheim 原生的 ZNet 清理机制，从而防止多人游戏配置渗入你的单人世界。

安装

• 所有游戏客户端必需： 每个加入服务器的玩家都必须安装此内容。
• 专用服务器可选： 在服务器机器上安装是无害的，但补丁将保持休眠状态（无头服务器不会渲染音频或天气）。
• 单人 / 主持人： 补丁仍处于未激活状态。游戏将自动使用原版 Expand World Data 的加载路径，该路径对主机端来说已经运行得非常完美。

控制台命令

按 F5 和类型 同步检查 打印即时诊断报告。它将验证客户端同步状态、当前音乐曲目、活动天气，以及自定义音频池是否成功加载。

配置与验证（仅供诊断）

⚠️ 重要提示： 本模组的核心修复（强制应用生物群系数据）会自动生效，适用于 全部 开箱即用的整合包。你无需为模组配置任何内容即可修复你的服务器。

默认情况下， rdmods.ewsync.cfg 文件附带针对以下内容定制的验证规则： MMO之家 模组包。如果你使用的是其他模组包，该模组仍能完美修复你的游戏，但运行该 同步检查 控制台命令会显示“失败”结果，因为它寻找的是MMOHeim特有的音乐文件。

如果你想使用 同步检查 你自己的自定义整合包的诊断命令，你必须手动替换配置文件中的MMOHeim值。（你也可以完全删除这些规则，模组在没有它们的情况下依然能完美运行）。

如何设置你自己的诊断规则

这 规则 配置文件中的字符串告诉诊断工具要查找什么。

• 用分号分隔不同的生物群系（;）。
• 生物群系内的条件请用竖线（|）。

格式： 生物群系名称|白天音乐=x|夜晚音乐=y|环境=a,b|池=p1,p2

• 生态群系名称： 来自您所在位置的准确生物群系名称 expand_biomes.yaml （例如， 黑森林）。
• 音乐日 / 夜之乐章：你想要验证的自定义音乐 ID。使用连字符（-) 若留空，则
• 环境 / 池：（可选）必须加载的自定义环境或音频池的逗号分隔列表。

自定义包示例： BlackForest|musicDay=my_custom_track|musicNight=-;Meadows|musicDay=meadows_track

通用设置

• 已启用： 总开关，用于开启或关闭模组修复。
• 启用诊断： 设置为 真 直接将应用/验证摘要打印到你的 日志输出.log 用于故障排除。否则请保留 假
• 生成安全重试： 如果初始数据同步因加载时间过长而失败，当玩家生成时，模组会再尝试一次。（强烈建议保留 真）
• 生成重试延迟秒数： （默认 1.5)。在玩家实际生成后，给游戏引擎一个短暂的喘息时间，然后再强制环境更新。如果使用非常慢的硬盘的玩家仍然遇到不同步问题，可以适当调高这个值。默认延迟对于99%的玩家来说已经绰绰有余了。

依赖

• 扩展世界数据
• 扩展世界音乐
• BepInEx