创建

Valheim Profiler — 性能分析和诊断工具

  • Valheim — Valheim Profiler — 性能分析和诊断工具
作者:
shudnal
大小:
281.89 kB
日期:
今天, 11:01
下载:
0
0.0 / 10
还没有人评价这个文件

这是一个专为 Valheim 的模组开发者和服务器管理员设计的游戏内诊断工具包。该模组允许实时监测由模组和脚本引起的性能下降,测量 Harmony 补丁的延迟、MonoBehaviour 的生命周期方法、引擎更新包、ZDO/RPC 网络流量和日志,通过一个方便的图形覆盖层 (IMGUI)。该工具专门用于诊断会话和问题查找,而不是用于常规游戏,因为对热点代码的深度分析会增加额外的计算负担。

主要诊断模块:

  • 主启动器 (Launcher) — 一个紧凑的菜单,用于在一个窗口中快速启动和切换所有分析器。
  • 补丁分析器 (Patch Profiler) — 测量 Harmony 钩子的执行延迟:前缀 (Prefix)、后缀 (Postfix)、终结器 (Finalizer),以及转译后的方法和代码注入点。
  • MonoBehaviour 帧分析器 (MonoBehaviour Frame Profiler) — 测量 Update、FixedUpdate、LateUpdate 和 OnGUI 的常规调用,并按特定模组和组件进行直观分组。
  • 调用分析器 (MonoBehaviour Call Profiler) — 详细跟踪对象的初始化和销毁,通过生命周期方法:Awake、Start、OnEnable、OnDisable 和 OnDestroy。
  • Valheim 更新分析器 (Valheim Update Profiler) — 测量游戏内部的循环:实体的批量更新、MonoUpdaters 区域和建筑物的破坏/磨损调度器的工作 (WearNTear)。
  • 客户端日志监视器 (Client Log Monitor) — 将 LogOutput.log 文件直接输出到游戏屏幕:按类别过滤、自动检测关键错误、加载历史记录和复制选定行。
  • 服务器日志监视器 (Server Log Monitor) — 通过 Valheim RPC 协议将指定服务器的控制台日志流式传输给授权管理员。
  • 网络分析器 (Network Profiler) — 详细分析指定服务器的网络活动:RPC 调用、路由 RPC、ZDO 对象的同步和传输层负载。
  • 输入控制禁用 (Input Helpers) — 禁用键盘输入和鼠标捕获的选项,以便在诊断表格中舒适导航,而不必担心意外移动角色。

默认快捷键:

  • F7 — 打开启动器主菜单 / 覆盖层。
  • F8 — 补丁分析器 (Patch Profiler)。
  • F9 — 客户端日志监视器 (Client Log Monitor)。
  • F10 — 服务器日志监视器 (Server Log Monitor)。
  • F11 — 网络分析器 (Network Profiler)。
  • MonoBehaviour 帧/调用分析器和更新分析器可以通过启动器窗口的 F7 键打开。

安装说明:

  1. 确保您已安装 BepInExPack Valheim 基本包。
  2. 将插件文件放入文件夹:
    <Valheim 路径>\BepInEx\plugins\。
  3. 对于本地客户端调试:只需将模组安装到游戏客户端文件夹中即可。
  4. 对于专用服务器的诊断:模组的相同版本必须在无头服务器和具有访问权限的管理员客户端上安装。
文件的名称和描述已被翻译 显示原文 (RU)显示翻译 (ZH-CN)
Valheim Profiler — инструмент профилирования и диагностики производительности

Специализированный внутриигровой набор диагностических инструментов для разработчиков модификаций и администраторов серверов Valheim. Мод позволяет в реальном времени отслеживать просадки производительности, вызванные модами и скриптами, замерять задержки Harmony-патчей, методы жизненного цикла MonoBehaviour, пакеты обновлений движка, сетевой трафик ZDO/RPC и логи через удобный графический оверлей (IMGUI). Инструмент предназначен строго для диагностических сессий и поиска проблем, а не для постоянной игры, так как глубокое профилирование горячих участков кода создаёт дополнительную вычислительную нагрузку.

Основные диагностические модули:

  • Главный лаунчер (Launcher) — компактное меню для быстрого запуска и переключения всех профилировщиков в одном окне.
  • Профилировщик патчей (Patch Profiler) — замеряет задержки выполнения хуков Harmony: префиксов (Prefix), постфиксов (Postfix), финализаторов (Finalizer), а также методов после транспиляции и мест инъекций кода.
  • Кадровый профилировщик MonoBehaviour (MonoBehaviour Frame Profiler) — замеряет регулярные вызовы Update, FixedUpdate, LateUpdate и OnGUI с наглядной группировкой по конкретным модам и компонентам.
  • Профилировщик вызовов (MonoBehaviour Call Profiler) — детально отслеживает инициализацию и уничтожение объектов через методы жизненного цикла: Awake, Start, OnEnable, OnDisable и OnDestroy.
  • Профилировщик обновлений Valheim (Valheim Update Profiler) — измеряет внутренние циклы самой игры: пакетные обновления сущностей, области MonoUpdaters и работу планировщика разрушения/износа построек (WearNTear).
  • Клиентский монитор логов (Client Log Monitor) — вывод файла LogOutput.log прямо на экран игры: фильтрация по категориям, автоматическое обнаружение критических ошибок, загрузка истории и копирование выделенных строк.
  • Серверный монитор логов (Server Log Monitor) — потоковая передача консольного лога выделенного сервера авторизованным администраторам через протокол Valheim RPC.
  • Сетевой профилировщик (Network Profiler) — детальный анализ сетевой активности выделенного сервера: вызовы RPC, routed RPC, синхронизация объектов ZDO и нагрузка на транспортный уровень.
  • Блокировка управления (Input Helpers) — опции отключения ввода с клавиатуры и захвата мыши для комфортной навигации по диагностическим таблицам без риска случайно сдвинуть персонажа.

Горячие клавиши по умолчанию:

  • F7 — Открыть главное меню лаунчера / оверлей.
  • F8 — Профилировщик патчей (Patch Profiler).
  • F9 — Клиентский монитор логов (Client Log Monitor).
  • F10 — Серверный монитор логов (Server Log Monitor).
  • F11 — Сетевой профилировщик (Network Profiler).
  • Модули MonoBehaviour Frame/Call Profiler и Update Profiler открываются из окна лаунчера по клавише F7.

Инструкция по установке:

  1. Убедитесь, что у вас установлен базовый набор BepInExPack Valheim.
  2. Поместите файлы плагина в папку:
    <Путь_к_Valheim>\BepInEx\plugins\.
  3. Для локальной отладки клиента: достаточно установить мод только в клиентскую папку игры.
  4. Для диагностики выделенного сервера: одинаковая версия мода должна быть установлена как на headless-сервере, так и на клиенте администратора с правами доступа.

相关文件:

有用的链接:

评论 0