超时扩展

超时扩展

已修复重型模组包中World.Load期间发生的"网络超时"和PeerNotFound断开问题(例如《湮灭时代》《避难所》《暗黑降临》《重生》等)。可配置的断开超时时间(默认30秒,原版为5秒)。这是7天杀敌2.6版本的社区重新编译。

实用工具

Network Timeout Extension — 7 Days to Die 2.6 Community Fix

一个小型 Harmony 补丁,将 LiteNetLib 的 DisconnectTimeout 从 5 秒(原版默认值)提升为一个可配置的值(默认 30 秒 — 通过 Config/TimeoutExtension.xml 选择适合你的模组包的值)。这为运行大型模组包的客户端在加载过程中提供了足够的时间来处理世界数据,而不会被服务器踢出。

这是 McTaco7 的原始 Network Timeout Extension 的非官方社区重新编译版,已更新以适用于 7 Days to Die 2.6 (b14+),并包含一个按安装实例配置的文件。

版本

  • v2.1.0.0 (当前版本):通过 Config/TimeoutExtension.xml 可配置超时时间
  • v2.0.0.0:硬编码的 30 秒超时(最初的 2.6 修复,仍然有效)
  • v1.x (McTaco7 原始版):硬编码的 30 秒,在 2.6 上失效

衷心感谢 McTaco7 🙏

整个想法、Harmony 模式、在 NetManager 构造时修补单个字段的精准方法——所有这些都出自 McTaco7 之手。此版本的发布仅仅是因为原始模组由于两次内部引擎更改(参见下方的发生了什么变化)而无法在 7d2d 2.6 上加载,而模组包社区需要立即能用的东西。

如果你是 McTaco7,并且希望将这个修复纳入你的官方版本,请随意——我很乐意删掉这个版本。请通过 Nexus DM 或你偏好的任何联系方式联系我。源代码已包含在内,以便任何人(包括你)都能在未来的 7d2d 更新中维护它。


此修复解决了什么问题?

当你加入一个模组化的 7d2d 服务器时,客户端会下载所有配置(方块、物品、配方等),然后在本地处理世界数据,再把你传送进游戏。大型模组包(如 Age of Oblivion、Asylum: Rise of the Wardens、Rebirth、Darkness Falls……)在此加载期间可能会占用客户端主线程 20–60+ 秒。

当主线程繁忙时,LiteNetLib 工作线程无法发送保活数据包。服务器的默认 DisconnectTimeout 是 5 秒。因此,即使一切技术上正常,服务器也会因为你“在 5 秒内未收到数据包”而将你踢出,你会看到:

NET: LiteNetLib: TimeSinceLastPacket: 5012 NET: LiteNetLib: Client disconnect ... (Timeout)

或者从客户端看到:

LOST CONNECTION TO SERVER — Network Timeout LOST CONNECTION TO SERVER — netLiteNetLibDisconnectReason_PeerNotFound

此模组提高了超时时间(默认 30 秒,可配置高达 600 秒),即使在最重的模组包和低端硬件上,也能给客户端足够的喘息空间来完成加载。


7d2d 2.6 发生了什么变化(以及原始模组为何失效)

原始 1.x 版本的目标是:

[HarmonyPatch(typeof(NetManager))] // ← 问题1 [HarmonyPatch(MethodType.Constructor)] [HarmonyPatch(new[] { typeof(INetEventListener), typeof(PacketLayerBase) })] // ← 问题2

在 7d2d 2.6 中,引擎团队做了两项修改,静默地破坏了它:

  1. LiteNetLib 被移到了自己的程序集中。 在 2.6 之前,LiteNetLib.NetManager 位于 Assembly-CSharp-firstpass.dll 中。在 2.6 中,它位于自己的 LiteNetLib.dll 中。旧的已编译模组将类型引用硬编码为 "LiteNetLib.NetManager, Assembly-CSharp-firstpass"——而该类型已不存在于那里。结果是: EXC Could not load type LiteNetLib.NetManager, Assembly-CSharp-firstpass, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null while decoding custom attribute: (null) ERR [MODS] Failed initializing ModAPI instance on mod 'TimeoutExtension' 模组加载了,但 Harmony 补丁从未注册。你的服务器仍然使用默认的 5 秒超时。

  2. NetManager 的构造函数增加了一个第三个参数。 在 2.5 中是 NetManager(INetEventListener, PacketLayerBase)。在 2.6 中是 NetManager(INetEventListener, PacketLayerBase, bool useSocketFix = true)。即使你修复了问题 #1,原始补丁仍然找不到构造函数,因为签名不再匹配。

此版本修复了这两点:项目现在直接引用 LiteNetLib.dll,并且 HarmonyPatch 构造函数签名匹配 2.6 的三参数形式。补丁行为在其他方面与 McTaco7 的原始版本相同——再加上从 XML 配置超时时间的新功能。


安装

服务器和每个客户端都需要安装此模组。 安装不匹配会导致 PeerNotFound 断开连接(服务器在 5 秒时踢出客户端,而客户端认为它仍然连接着)。

将 zzzzzzzzzzzzzzzzTimeoutExtension 文件夹放入:

  • 客户端: <7d2d 安装目录>/Mods/zzzzzzzzzzzzzzzzTimeoutExtension/
  • 专用服务器: <服务器根目录>/Mods/zzzzzzzzzzzzzzzzTimeoutExtension/

Windows 客户端(通过 Steam): C:\Program Files (x86)\Steam\steamapps\common\7 Days To Die\Mods\zzzzzzzzzzzzzzzzTimeoutExtension\

Linux 客户端(原生或 Proton): ~/.local/share/Steam/steamapps/common/7 Days To Die/Mods/zzzzzzzzzzzzzzzzTimeoutExtension/

zzzz... 前缀是有意为之——7d2d 按字母顺序加载模组,此补丁需要最后**加载,以便其对 NetManager 的 Harmony 补丁能覆盖任何可能触及同一构造函数的其他模组。请保持文件夹名称不变。如果你之前在这个文件夹中安装了 McTaco7 的原始 1.x 版本,你可以直接替换其中的 DLL——文件夹名称完全相同。

安装后,重启服务器。每个客户端也需要重启游戏。

配置超时时间

编辑 zzzzzzzzzzzzzzzzTimeoutExtension/Config/TimeoutExtension.xml:

<?xml version="1.0" encoding="UTF-8"?> <TimeoutExtension> <TimeoutMs>30000</TimeoutMs> <!-- 以毫秒为单位的值 --> </TimeoutExtension>

根据模组包重量推荐的值:

  • 30000(30 秒)— 轻量/中量模组包(Rebirth lite、原版 + 小型模组)
  • 45000(45 秒)— 重量模组包(Age of Oblivion 典型会话)
  • 60000(60 秒)— 非常重(Asylum: Rise of the Wardens、Darkness Falls、Undead Legacy)
  • 90000(90 秒)— 极端(重型模组包 + 慢速磁盘 + 多名并发玩家)

最小 5000 毫秒,最大 600000 毫秒——超出此范围的值会被钳制。

重要提示: 服务器和客户端应使用相同的值,以避免不对称的超时行为。服务器的值是实际踢出客户端所用的值;客户端的值影响它自身认为连接断开所需的时间。不匹配的值可能导致 PeerNotFound 断开连接(服务器在其较短的超时时间踢出了客户端,但客户端在其较长的超时时间内仍认为连接存在)。

如果配置文件缺失、格式错误或无法读取,补丁将回退到 30000 毫秒(30 秒)——与 v2.0 相同的行为。因此,完全省略文件是安全的,会重现 v2.0 的行为。

如何确认它已加载

在 output_log_*.txt(客户端)或服务器的 output_log_*.txt 中,查找:

[MODS] Loaded Mod: TimeoutExtension (2.1.0.0) [TimeoutExtension] Loaded TimeoutMs=30000 from config (或:Config not found, using default 30000ms) [TimeoutExtension] Loading patch — DisconnectTimeout will be set to 30000ms (30s) [TimeoutExtension] Patch applied [TimeoutExtension] NetManager constructed — DisconnectTimeout set to 30000ms

第二行告诉你加载的是哪个值(来自配置文件或默认值)。第三行确认 Harmony 已注册了补丁。第五行确认补丁在 NetManager 实际实例化时触发了——这是它正常工作的真正证明。

如果你在日志中看到此错误,说明旧的已损坏的 v1.x 版本仍未删除: EXC Could not load type LiteNetLib.NetManager, Assembly-CSharp-firstpass 将此 DLL 替换掉。


从源代码构建

如果 7d2d 2.7(或更高版本)再次重新组织程序集,相同的补丁模式仍然适用:更新引用,可能调整 HarmonyPatch 属性中的构造函数签名,然后重新编译。

# 需要 .NET SDK(已在 .NET 10 上测试)——针对 net48 以实现 Unity/Mono 兼容性 cd source mkdir -p refs # 从你的 7d2d 2.6 安装目录 <Managed/> 文件夹中复制以下文件: # LiteNetLib.dll # Assembly-CSharp.dll # Assembly-CSharp-firstpass.dll # UnityEngine.CoreModule.dll # 以及从任何包含它的已安装模组(例如 0_TFP_Harmony)中复制 0Harmony.dll cp /path/to/7d2d/7DaysToDie_Data/Managed/{LiteNetLib,Assembly-CSharp,Assembly-CSharp-firstpass,UnityEngine.CoreModule}.dll refs/ cp /path/to/some/mod/0_TFP_Harmony/0Harmony.dll refs/ dotnet build -c Release # 输出:bin/Release/TacoTimeoutExtention.dll`

源代码已包含在 zip 文件的 source/ 目录中。总共约 70 行。


许可证 / 鸣谢

  • 原始创意、设计和实现: McTaco7
  • 2.6 重新编译和错误调查: Sr Bilbo Baggins(社区贡献)
  • Harmony 库: Andreas Pardeike (MIT)
  • LiteNetLib: RevenantX (MIT)

你可以随意使用。唯一重要的是对 McTaco7 的署名。


已知限制

  • 将所有对等连接的超时时间全局增加为配置的值(默认 30 秒)。这意味着一个连接确实断开的玩家需要那么长时间才会被踢出,而不是 5 秒。对于模组包服务器来说,这是正确的权衡;对于原版 PvP 服务器来说,可能并非如此——在那里请设置较低的 TimeoutMs 值,或者跳过此模组。
  • 每个 NetManager 实例触发一次补丁。7d2d 在典型会话期间会创建多个 NetManager 实例(大厅 + 游戏会话),所以你会看到日志消息多次触发。这是预期的行为。
  • 此 DLL 的哈希/校验和与原始版本不匹配——如果你的服务器强制执行严格的模组哈希匹配,则双方都需要使用此确切版本。