Troubleshooting
Most questions can be answered from the game log. Start there, then find your symptom below.
First: read the log
- Current session:
%USERPROFILE%\AppData\LocalLow\Mechanistry\Timberborn\Player.log - Previous session:
Player-prev.login the same folder
Search for [LateGamePerformance]. These are the messages that matter:
| Message | Meaning |
|---|---|
0.4.31 loading. | The mod started. Normal. |
HaulCache: enabled (9/9 patches). and similar for RouteMaps, YielderSearch | A feature started. Normal. |
Simulation features: HaulCache on, RouteMaps on, YielderSearch on, TerrainMaps on, PlantWater on, DistrictCounts on, WaterMapCopy on, SoilScans on, TerrainSearch on, IdleEntities on, HomeSearch on, Reachability on. | All twelve features that affect the simulation are running. Normal, and the same for every player. |
Simulation features: … OFF … | A feature could not start. What to do. |
… required patch '…' failed … Feature disabled; the game runs unmodified for this part. | The reason a feature could not start. What to do. |
… failed and turned itself off for this session: … | A feature hit an unexpected error and switched itself off. What to do. |
Simulation features: … OFF … turned itself off during this session after an error … | The startup line, said again after a feature switched itself off, with that feature OFF. What to do. |
… could not be built on the first try; it was built again on the main thread … | A route or terrain map failed on a worker thread, and the main thread built it instead. The feature stays on. Report it. |
GC: incremental=True or False | Whether memory clean-ups are spread out. If False. |
Settings: '…' is ignored. It is no longer a setting… | An older settings file has a key the mod doesn't use. Harmless. |
Last 1000 ticks. Timing: …, HaulCache: …, RouteMaps: …, YielderSearch: … | Stats lines. Normal. What they show. |
Save: … ms total = … | One line per save, with the time of each stage. Normal. |
Find your symptom
The mod isn't in the Mods list
- Wrong folder depth. The game needs
Mods\LateGamePerformance\version-1.1\manifest.json. A doubledLateGamePerformance\LateGamePerformancefolder is the usual mistake. See the folder layout. - Wrong Mods folder. It must be the folder your other mods are in, normally
Documents\Timberborn\Mods. - Old game. The mod needs Timberborn 1.1.2.4 or newer.
- Fully quit and restart the game after copying files.
It won't enable, or the game complains about a missing mod
Late Game Performance needs Harmony (2.4.1 or newer) and Mod Settings, both from the Steam Workshop. Subscribe to Harmony and Mod Settings, enable them in the Mods menu, and restart.
It's enabled, but there is no [LateGamePerformance] line in the log
- Make sure you're reading the right session. The log is overwritten each launch, and the previous one is
Player-prev.log. - Check the mod list near the top of the log. If
Late Game Performanceisn't there, it wasn't enabled, or you didn't restart after enabling it. - If it's listed but the
loading.line is missing, look further down for an error loading the mod, and report it with the log.
The game crashes while loading
- Use the latest release. Version 0.4.3 crashes the game while loading, so replace it.
- Still crashing on 0.4.31? Try the game once with only Harmony, Mod Settings and this mod enabled.
- Report it with
Player.log.
The startup line says a feature is OFF
Something the feature needs is missing or changed in the game, usually after a game update. The feature didn't start, and this computer runs the game's own code for that part. The lines just above say which part failed.
- HaulCache or YielderSearch OFF: only the speed-up is lost. Both give the game's own results, so the simulation is the same.
- RouteMaps or TerrainSearch OFF on one computer: in multiplayer, that computer can pick a different route from the others. Check that every player has the same game and mod version, then compare everyone's startup line.
- Either way, report it with the log, so it can be fixed for that game version.
A log line says a feature "failed and turned itself off for this session"
The feature hit an unexpected error and switched itself off for the rest of the session. The game's own code runs instead, and a dialog says so.
- Single player: play on. Nothing is lost but speed.
- Multiplayer: every player quits and restarts the game before playing on together. The feature is back after a restart.
- Report it with the whole line, including the error text after it. In multiplayer, include everyone's log.
I don't notice any difference
- It targets large colonies. A small one has little repeated work to remove.
- Check the
Timing:line (what it shows). If everything else takes most of the main thread's time, that is mostly rendering and Unity itself, which this mod can't speed up. A frame-rate cap then gives the simulation more of each second. - Freezes of most of a second, about once a minute? Tick Incremental garbage collection, restart, and check the startup line says
GC: incremental=True.
The startup line says GC: incremental=False
- You haven't ticked it. Tick Incremental garbage collection in the mod's settings (how).
- You ticked it but haven't restarted. It takes effect the next time the game starts.
- The file couldn't be written. The log has a line starting
GC: could not changeorGC: … was not found. Close the game and add the linegc-max-time-slice=3toTimberborn_Data\boot.configin the game's install folder by hand. - A game update or Steam's file check restored the original file. If the box is ticked, the mod adds the line again at the next start and logs
Putting it back. Restart once more.
A message about garbage collection appears in the main menu
It says incremental collection is off and offers Turn it on or Not now. It asks only once. To turn it on later, tick Incremental garbage collection in the mod's settings (how).
The log says a setting "is ignored. It is no longer a setting"
Your LateGamePerformance.cfg is from an older version and has one of the keys HaulCache, HaulCacheFlushEveryTicks, RouteMaps or YielderSearch. It is ignored and harmless: those features are always on, the same for everyone. You can delete the line.
The game got slower after I changed a setting
- The verify settings (the Verify … boxes and the
…Verifykeys) run the game's own code as well, so they are slower than no mod. Untick the boxes, or set the keys back tofalse. RecordTimings = truemakes the game run a little slower. Set it back tofalseafter a profiling session.- The Diagnostics timers box (
Diagnostics = true) adds a little overhead. Untick it after collecting numbers.
Multiplayer: the players' startup lines or versions differ
- Every player must run the same version of the mod and the same game version. Nothing else has to match (why).
- Each player's
Simulation features:line should read the same. If one saysOFF, see above. - If games go out of step (a desync), keep every player's
Player.logand report it with each player's mod list. Say whether it also happens without this mod.
Reporting a problem
Open an issue on GitHub and include:
- The mod version and game version.
- Whether it happened in single-player or multiplayer, and the other mods you have enabled.
- The
[LateGamePerformance]lines fromPlayer.log, or the whole file. In multiplayer, every player's. Remove personal information before posting logs publicly. - What you were doing, and whether it stops when you disable the mod.