FS25 Perf Profiler V1.0.0.0

FS25 Perf Profiler V1.0.0.0

This is an early development mod, not standalone software. Perf Profiler measures the game’s main Lua thread from inside the game and writes a ranking to log.txt every 20 seconds.

It can help identify whether performance issues come from scripts or the engine before removing mods.

In a real example from a 2,489-mod savegame, scripts were only ~4 ms of a ~19 ms frame. The expensive part was somewhere else, and the profiler showed that in 20 minutes instead of a week of trial and error.

Features

• Identifies which MOD costs the most milliseconds per frame.
• Identifies which FUNCTION inside it is responsible, including hooks, listeners, vehicle and placeable specializations, and game systems.
• Shows how much of the frame is Lua and how much is the engine, including render, physics, and loading.
• Records every SPIKE, defined as a frame over 40 ms, with its top contributors, marked as LUA or ENGINE.
• Measures hooks, including Utils.appendedFunction, prependedFunction, and overwrittenFunction.
• Measures functions overwritten by specializations, listed by name.
• Measures update() and draw() of mod event listeners.
• Measures onUpdate, onUpdateTick, onPostUpdate, and onDraw of vehicle, placeable, and hand-tool specializations.
• Measures the total update of each vehicle and placeable.
• Measures game systems, including environment, AI, traffic, water, and economy.
• Measures total Lua per frame to show the scripts versus engine split.
• Every entry shows “self” time, with no double counting, and “incl” time, including everything nested.
• Measuring costs about 0.5 ms per frame.
• It changes nothing in the savegame or gameplay. It only times functions and logs the results.
• Measures main-thread Lua. The engine side, including render and physics, appears as “engine” time and ENGINE spikes.
• Multiplayer is supported. Every player needs the same file if the host has it active.
• Full documentation, README.md, with an explanation of every log line is inside the zip.

HOW TO USE
1. Put AAA_PerfProfiler.zip into your mods folder and activate it in the savegame.
Keep the name, because “AAA_” makes it load first, which it needs to catch other mods’ hooks.
2. Play normally. The first 20 seconds after loading are skipped.
3. Read the [PerfProfiler] lines in log.txt at Documents/My Games/FarmingSimulator2025/log.txt.

CONSOLE COMMANDS (~)
ppReport – write a report now
ppReset – reset statistics, to measure night, rain, and fieldwork separately
ppStart / ppStop – resume or pause measuring
ppSpike <ms> – spike threshold, default 40
ppTop <n> – ranking length, default 35
ppInterval <s> – report interval, default 20

Changelog

• 1.2.2.0