EasyHUD

AI 生成声明：本模组由 AI 智能体（WorkBuddy）在用户的明确需求与逐项验收下编写； 功能设计、真机测试与发布决定均由用户主导。

在 HUD 上实时显示网络质量的纯客户端模组 —— 不用再按 F2 去看那一大堆调试信息。

面板贴在「Display Day & Time in HUD」面板的正左侧， 同一水平线、同一高度、同字体同字号同颜色同背景，看起来就像同一套 UI 的一部分。

                              ┌──────────────────────────┬──────────────────────────┐
                              │ Ping 42ms  99%  ↓3.4 ↑0.8 KB/s  P 3 │  第 128 天  14:32   │
                              └──────────────────────────┴──────────────────────────┘
                                        ↑ 本模组（EasyHUD）              ↑ 天数/时间面板

功能

每一项都能在配置里单独关掉。刷新间隔默认 0.5 秒（网络统计本身是低频采样的，刷太快只会让数字乱跳）。

⚠️ 关于「丢包率」—— 请先看这一段

Valheim 和 Steam 都没有暴露"丢包率"这个数字。 我把链路挖到了底：

ConnectPanel.Update                                  ← 原版 F2 面板
  → ZNet.GetNetStats(out localQuality, out remoteQuality, out ping, out outByteSec, out inByteSec)
      → ZSteamSocket.GetConnectionQuality(...)
          → Steamworks.SteamNetworkingSockets.GetConnectionRealTimeStatus(...)
              → SteamNetConnectionRealTimeStatus_t { m_nPing, m_flConnectionQualityLocal,
                                                     m_flConnectionQualityRemote,
                                                     m_flOut|InPacketsPerSec,
                                                     m_flOut|InBytesPerSec, ... }

这个结构体里只有"包速率"，没有"丢包率"。Steam 给出的最接近的指标就是 m_flConnectionQualityLocal / Remote（0~1 的连接质量，已经综合了丢包、延迟、抖动）。

所以本 HUD 用 连接质量 % 来反映网络好坏：丢包或延迟一恶化，它就会明显掉下来， 这也是原版 F2 面板显示的那两个百分比。若你更希望看到数字化的延迟波动， 可以关注 Ping 与带宽两项的变化。

（理论上还有一条路：Steamworks.NET 的 GetDetailedConnectionStatus 会返回一段人类可读的文本， 里面带 dropped 计数 —— 但它是给人看的字符串、格式随 Steam 版本变、且只在 Steam 后端有效， 做成正式功能太脆弱，本模组没有采用。）

位置与"风格统一"是怎么做到的

不是硬编码坐标，也不要求你去抄一遍配置：

1. 进游戏后，本模组会去找另一个模组创建的 DayTimePanel（挂在 Hud.m_rootObject 下）。
2. 找到后直接继承它的 UI 组件：字体、字号、字色、描边颜色与偏移、背景 sprite / 颜色、面板高度。
3. 位置按它的左边缘计算：本面板右边缘 = 它的左边缘 − Gap，y 与它完全相同。

所以：

• 你改那个模组的字号 / 颜色 / 背景，本 HUD 会自动跟着变（改完重启游戏）。
• 你把那个模组的「Display under minimap」打开（面板挪到小地图下方），本 HUD 也跟着挪到同一行。
• 卸载那个模组也没关系：本 HUD 会退回 [4 - Fallback Style] 里的内置样式， 默认值就是那个模组的默认外观（AveriaSansLibre-Bold / 16 / FFFFFFCA / 背景 00000064 / 高 30）。

面板宽度默认按文字自动收缩；想让两个面板一样宽，把 PanelWidth 填成 200 即可。

配置

BepInEx/config/easyhud.client.only.cfg

关于 NormalizeOnHost

游戏底层的 ZNet.GetNetStats 在主机模式下是把所有客户端的值累加的 （原版 F2 也这样，所以主机开 3 人时 F2 会显示 300% / 1500ms 这种数字，其实每个人都不差）。

• true（默认）：除以有效连接数，显示平均值，更容易看懂。
• false：和 F2 面板完全一致的累加值。

自己是客户端连别人时，这个开关没有任何影响。

为什么联机安全

• 只 patch 了 Hud.Awake（只是为了挂 UI），不碰任何网络/游戏逻辑。
• 无 Jotunn 依赖、无 NetworkCompatibility 声明、无内嵌 ServerSync / ConditionalConfigSync。
• 依赖只有：mscorlib / assembly_valheim / BepInEx / 0Harmony / UnityEngine.CoreModule / UnityEngine.UI / UnityEngine.TextRenderingModule。
• 纯读统计 + 本地画 UI，主机和队友不装也照样玩，不会让你连不上任何主机。

安装

• r2modman：Online → Install from file → 选 EasyHUD-1.0.0.zip
• 手动：把 EasyHUD.dll 放进 BepInEx/plugins/

排错

进游戏后看 BepInEx/LogOutput.log，应出现：

[Info : EasyHUD]  已挂载补丁类：HudAwakePatch
[Info : EasyHUD]   Hud.Awake()  prefix=0 postfix=1  OK
[Info : EasyHUD] Harmony 补丁挂载完成：1/1 成功。
[Info : EasyHUD] 网络面板已创建：父节点 Hud.m_rootObject，初始位置 (…)，字体 AveriaSansLibre-Bold。
[Info : EasyHUD] 已找到「DayTimePanel」面板并贴到其左侧：它的位置 (…) / 尺寸 (…) → 本面板 y=-25，样式来源=继承它的 UI 组件