Valheim 1.0 性能分析器，具备实时 TPS 截止时间监控、卡顿溯源、安全模组归因、运行时上下文与客户端图表。

MagiCorp 英灵神殿性能分析器

TickProfiler 1.0 是一款 Valheim 专用服务器和客户端性能分析工具，专注于实时 tick 截止时间、主线程卡顿以及安全的 Mod 归因。

服务器性能分析器

专用服务器组件记录：

• 基于真实挂钟截止时间的高效50赫兹FixedUpdate速率。Unity的追赶突发永远无法弥补已经错过的截止时间。
• 当卡顿跨越报告边界时，修正待处理截止时间的统计。
• 主要更新吞吐量、p95/p99/最差间隔、卡顿次数、超出的墙钟时间以及累计卡顿区间。
• 与事件相关的卡顿归因及置信度。托管GC按卡顿期间实际观测情况报告，而非自动归咎。
• BepInEx插件的安全循环归属 更新, 固定更新 和 延迟更新.TickProfiler 不会对其他模组的 Harmony Prefix/Postfix/Finalizer 方法进行插桩。
• 用于游戏方法的 Harmony 补丁所有者上下文，报告为相关模组，而非假定原因。
• 运行时上下文，包括玩家、ZDO 数量、活动对象、已加载/生成的区域、线程数和 VM 网络吞吐量。
• 处理 RSS/私有内存、托管堆、GC 回收次数和 CPU 使用率。
• TickProfiler 自身开销、每秒定时调用次数、输出队列深度与异常栈恢复计数。
• 针对深层/高频游戏方法的可选1/N采样。聚合速率会被缩放，而最差调用值仍保持观测值。

前45秒默认忽略，以免场景或世界启动过程影响运行时卡顿统计。

搭便车取证

严重的卡顿可在以下位置生成 JSON 捕获文件：

BepInEx/tickprofiler-forensics/

每次捕获都包含卡顿持续时间、估计错过的固定截止时间、归因/置信度、运行时上下文以及之前的性能样本。文件输出在后台工作线程上序列化，因此慢速存储不会阻塞《英灵神殿》主线程。

输出

正常输出写入至：

• BepInEx/LogOutput.log
• BepInEx/tickprofiler-latest.txt
• BepInEx/tickprofiler-status.json
• BepInEx/tickprofiler-forensics/*.json 用于符合条件的连接

点击 BepInEx/tickprofiler.request 请求立即生成完整快照。请求文件的轮询频率可配置且较低，而不是每帧轮询一次。

客户端叠加界面

在Windows版《英灵神殿》客户端上安装相同的包，然后按下 F8 切换覆盖层。

客户端显示：

• 本地FPS/帧间隔时序、卡顿、CPU、RSS、托管内存和GC活动。
• 服务器有效刻速率和更新率。
• 服务器运行时上下文与TickProfiler自身开销。
• 服务器消耗排名。
• 五分钟滚动客户端与服务器图表。
• 发生卡顿时的精确服务器卡顿事件标记，而不仅仅是在下一个周期性快照时。
• 快照延迟、每个已连接玩家的服务端 Steam 传输 ping，以及服务器/客户端协议兼容性。

TickProfiler 1.0 使用协议 v2，同时尽可能保留与 0.x 客户端/服务器的旧版 v1 hello/snapshot 兼容性。覆盖层文本在刷新之间会进行缓存，以避免在每个渲染帧都分配新字符串。

重要服务器设置

创建于 BepInEx/配置/magicorp.valheim.tickprofiler.cfg:

• 报告间隔秒数 = 10
• 叠加间隔秒数 = 2
• 请求轮询秒数 = 1
• 启动预热秒数 = 45
• DeepGameProfiling = true
• ProfilePluginLoops = true
• 热采样方法每隔N次 = 4
• 前12名消费者
• 尖峰阈值毫秒 = 20
• 主线程卡顿阈值毫秒 = 75
• WriteHitchForensics = true
• 取证卡顿阈值毫秒 = 100
• 在聊天中公告卡顿 = true
• AnnounceHitchesInGame = false
• 挂钩播报阈值毫秒 = 250
• AnnounceHitchCooldownSeconds = 10

配置文件模组和谐方法 仅作为已弃用的0.x兼容键保留，并迁移至 配置插件循环.

验证

TickProfiler 1.0.0 基于 Valheim 构建 1.0.14 和BepInExPack Valheim 5.4.2350.

包含的核心测试验证了截止时间统计、Unity追赶行为、报告边界内待处理的遗漏、JSON转义、卡顿分桶以及统计数据重置。一台备用服务器烧机测试还验证了受控的100/250/500/1000毫秒卡顿、持续过载和异常栈恢复。

TickProfiler仅用于诊断，不会有意更改游戏状态。