Uma sandbox de fantasia com elementos de sobrevivência. É possível jogar sozinho ou com outras pessoas, explorando o mundo e coletando recursos, encontrando e... Saiba mais
Valheim Profiler — ferramenta de perfilagem e diagnóstico de desempenho
-
Baixar (281.89 kB)18 de setembro de 2026, 11:01valheim-profiler-instrument_1789718517_840094.zip
Conjunto especializado de ferramentas de diagnóstico dentro do jogo para desenvolvedores de mods e administradores de servidores Valheim. O mod permite monitorar em tempo real quedas de desempenho causadas por mods e scripts, medir latências de patches Harmony, métodos do ciclo de vida MonoBehaviour, pacotes de atualização do motor, tráfego de rede ZDO/RPC e logs através de uma interface gráfica conveniente (IMGUI). A ferramenta é destinada estritamente a sessões de diagnóstico e identificação de problemas, e não para jogo contínuo, pois a perfilagem profunda de trechos críticos de código gera carga computacional adicional.
Módulos de diagnóstico principais:
- Lançador principal (Launcher) — menu compacto para iniciar rapidamente e alternar entre todos os perfiladores em uma única janela.
- Perfilador de patches (Patch Profiler) — mede as latências de execução dos hooks Harmony: prefixos (Prefix), sufixos (Postfix), finalizadores (Finalizer), bem como métodos após transpiração e locais de injeção de código.
- Perfilador de quadros MonoBehaviour (MonoBehaviour Frame Profiler) — mede chamadas regulares de Update, FixedUpdate, LateUpdate e OnGUI com agrupamento visual por mods e componentes específicos.
- Perfilador de chamadas (MonoBehaviour Call Profiler) — rastreia detalhadamente a inicialização e destruição de objetos através dos métodos do ciclo de vida: Awake, Start, OnEnable, OnDisable e OnDestroy.
- Perfilador de atualizações Valheim (Valheim Update Profiler) — mede os ciclos internos do próprio jogo: atualizações em lote de entidades, áreas de MonoUpdaters e funcionamento do planejador de destruição/desgaste de construções (WearNTear).
- Monitor de logs do cliente (Client Log Monitor) — exibe o arquivo LogOutput.log diretamente na tela do jogo: filtragem por categorias, detecção automática de erros críticos, carregamento de histórico e cópia de linhas selecionadas.
- Monitor de logs do servidor (Server Log Monitor) — transmissão em tempo real do log de console do servidor dedicado para administradores autorizados via protocolo Valheim RPC.
- Perfilador de rede (Network Profiler) — análise detalhada da atividade de rede do servidor dedicado: chamadas RPC, routed RPC, sincronização de objetos ZDO e carga no nível de transporte.
- Bloqueio de controle (Input Helpers) — opções para desativar a entrada do teclado e captura do mouse para navegação confortável nas tabelas de diagnóstico sem o risco de mover acidentalmente o personagem.
Atalhos padrão:
- F7 — Abrir o menu principal do lançador / overlay.
- F8 — Perfilador de patches (Patch Profiler).
- F9 — Monitor de logs do cliente (Client Log Monitor).
- F10 — Monitor de logs do servidor (Server Log Monitor).
- F11 — Perfilador de rede (Network Profiler).
- Os módulos MonoBehaviour Frame/Call Profiler e Update Profiler são abertos a partir da janela do lançador com a tecla F7.
Instruções de instalação:
- Certifique-se de que você tenha o conjunto básico BepInExPack Valheim instalado.
- Coloque os arquivos do plugin na pasta:
<Caminho_para_Valheim>\BepInEx\plugins\. - Para depuração local do cliente: basta instalar o mod apenas na pasta do cliente do jogo.
- Para diagnóstico do servidor dedicado: a mesma versão do mod deve estar instalada tanto no servidor headless quanto no cliente do administrador com permissões de acesso.
Специализированный внутриигровой набор диагностических инструментов для разработчиков модификаций и администраторов серверов 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.
Инструкция по установке:
- Убедитесь, что у вас установлен базовый набор BepInExPack Valheim.
- Поместите файлы плагина в папку:
<Путь_к_Valheim>\BepInEx\plugins\. - Для локальной отладки клиента: достаточно установить мод только в клиентскую папку игры.
- Для диагностики выделенного сервера: одинаковая версия мода должна быть установлена как на headless-сервере, так и на клиенте администратора с правами доступа.
Arquivos relacionados:
Links úteis:
