Questa è una mod in fase iniziale di sviluppo, non un software indipendente
FPS bassi o instabili con una lunga lista di mod? Prima di iniziare a eliminare mod a caso, misura.
Perf Profiler cronometra il thread Lua principale del gioco dall'interno e scrive una classifica chiara in log.txt ogni 20 secondi:
- Quale MOD costa più millisecondi per fotogramma
- Quale FUNZIONE al suo interno (hook, listener, specializzazioni di veicoli/placeable, sistemi di gioco)
- Quanta parte del fotogramma è dovuta a Lua e quanta al motore (rendering, fisica, caricamento)
- Ogni PICCO (fotogramma oltre 40 ms) con i principali responsabili, contrassegnato come LUA o ENGINE
Un esempio reale tratto da un salvataggio con 2.489 mod: gli script occupavano solo circa 4 ms di un fotogramma di circa 19 ms. La parte più pesante era altrove, e il profiler l'ha mostrato in 20 minuti invece che dopo una settimana di tentativi ed errori.
COSA MISURA
- hook: funzioni aggiunte dalle mod (Utils.appendedFunction / prependedFunction / overwrittenFunction)
- ovr: funzioni sovrascritte dalle specializzazioni, per nome
- mod: update()/draw() dei listener degli eventi delle mod
- spec: onUpdate / onUpdateTick / onPostUpdate / onDraw delle specializzazioni di veicoli, placeable e attrezzi manuali
- veh: / plc: aggiornamento totale di ogni veicolo e placeable
- sys: sistemi di gioco (ambiente, IA, traffico, acqua, economia...)
- frame: totale Lua per fotogramma - divisione tra script e motore
Ogni voce mostra il tempo «self» (senza doppio conteggio) e il tempo «incl» (con tutto ciò che è annidato).
COME USARLO
1. Inserisci AAA_PerfProfiler.zip nella cartella delle mod e attivalo nel salvataggio.
Mantieni il nome - «AAA_» fa sì che venga caricato per primo, cosa necessaria per intercettare gli hook delle altre mod.
2. Gioca normalmente. I primi 20 secondi dopo il caricamento vengono ignorati.
3. Leggi le righe [PerfProfiler] in log.txt (Documents/My Games/FarmingSimulator2025/log.txt).
COMANDI CONSOLE (~)
ppReport - scrivi subito un rapporto
ppReset - reimposta le statistiche (misura separatamente notte, pioggia e lavori nei campi)
ppStart / ppStop - riprendi / metti in pausa la misurazione
ppSpike <ms> - soglia del picco (predefinita: 40)
ppTop <n> - lunghezza della classifica (predefinita: 35)
ppInterval <s> - intervallo dei rapporti (predefinito: 20)
DA SAPERE
- Questo è uno strumento di test. La misurazione costa circa 0,5 ms per fotogramma, quindi rimuovilo quando hai finito.
- Non modifica il salvataggio né il gameplay. Cronometra solo le funzioni e registra i risultati.
- Misura il Lua del thread principale. La parte del motore (rendering, fisica) appare come tempo «engine» e picchi ENGINE.
- Multigiocatore: supportato. Come per qualsiasi mod, ogni giocatore deve avere lo stesso file se l'host lo ha attivato.
- La documentazione completa (README.md), con una spiegazione di ogni riga del log, si trova nello zip.
VERSIONE
1.2.2.0
AUTORE
Siemanek
LICENZA
MIT - libero da usare, modificare e condividere. È gradito citare l'autore.
