Este é um mod em fase inicial de desenvolvimento, não um software autónomo
FPS baixos ou instáveis com uma lista grande de mods? Antes de começar a apagar mods aleatoriamente, faça medições.
O Perf Profiler cronometra a thread Lua principal do jogo a partir do interior e escreve uma classificação clara no log.txt a cada 20 segundos:
- Qual MOD consome mais milissegundos por fotograma
- Qual FUNÇÃO dentro dele (hooks, listeners, especializações de veículos/placeables, sistemas do jogo)
- Quanto do fotograma corresponde ao Lua e quanto ao motor (renderização, física, carregamento)
- Cada PICO (fotograma acima de 40 ms) com os seus principais responsáveis, marcado como LUA ou ENGINE
Exemplo real de um jogo guardado com 2.489 mods: os scripts ocupavam apenas cerca de 4 ms de um fotograma de cerca de 19 ms. A parte dispendiosa estava noutro local, e o profiler mostrou isso em 20 minutos, em vez de uma semana de tentativa e erro.
O QUE MEDE
- hook: funções adicionadas pelos mods (Utils.appendedFunction / prependedFunction / overwrittenFunction)
- ovr: funções substituídas por especializações, por nome
- mod: update()/draw() dos listeners de eventos dos mods
- spec: onUpdate / onUpdateTick / onPostUpdate / onDraw das especializações de veículos, placeables e ferramentas manuais
- veh: / plc: atualização total de cada veículo e placeable
- sys: sistemas do jogo (ambiente, IA, trânsito, água, economia...)
- frame: Lua total por fotograma - divisão entre scripts e motor
Cada entrada mostra o tempo «self» (sem contagem dupla) e o tempo «incl» (com tudo o que está aninhado).
COMO UTILIZAR
1. Coloque AAA_PerfProfiler.zip na sua pasta de mods e ative-o no jogo guardado.
Mantenha o nome - «AAA_» faz com que seja carregado primeiro, o que é necessário para capturar os hooks de outros mods.
2. Jogue normalmente. Os primeiros 20 segundos após o carregamento são ignorados.
3. Leia as linhas [PerfProfiler] no log.txt (Documents/My Games/FarmingSimulator2025/log.txt).
COMANDOS DA CONSOLA (~)
ppReport - escrever um relatório agora
ppReset - repor as estatísticas (medir separadamente a noite, a chuva e o trabalho no campo)
ppStart / ppStop - retomar / pausar a medição
ppSpike <ms> - limite do pico (predefinição: 40)
ppTop <n> - tamanho da classificação (predefinição: 35)
ppInterval <s> - intervalo dos relatórios (predefinição: 20)
BOM SABER
- Esta é uma ferramenta de teste. A medição custa cerca de 0,5 ms por fotograma, por isso remova-a quando terminar.
- Não altera nada no seu jogo guardado nem na jogabilidade. Apenas cronometra funções e regista os resultados.
- Mede o Lua da thread principal. A parte do motor (renderização, física) aparece como tempo «engine» e picos ENGINE.
- Multijogador: suportado. Tal como acontece com qualquer mod, todos os jogadores precisam do mesmo ficheiro se o anfitrião o tiver ativo.
- A documentação completa (README.md), com uma explicação de cada linha do registo, encontra-se dentro do zip.
VERSÃO
1.2.2.0
AUTOR
Siemanek
LICENÇA
MIT - livre para utilizar, modificar e partilhar. A atribuição é apreciada.
