Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
HitchFix
Fewer stutters and hitches. Spreads world loading over several frames, trims rendering and garbage-collection pauses, caches the minimap and smooths saves. One slider from Performance to Quality.
| Date uploaded | 2 weeks ago |
| Version | 2.1.1 |
| Download link | OrdinaryJoe-HitchFix-2.1.1.zip |
| Downloads | 146 |
| Dependency string | OrdinaryJoe-HitchFix-2.1.1 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351README
HitchFix
Fewer stutters and hitches in Valheim, especially while exploring, joining a world, teleporting and saving.
HitchFix is one BepInEx plugin made of a few modules. Each one goes after a different cause of frame hitches. Nothing in it changes gameplay balance, and anything a player built still loads and unloads exactly like the unmodded game.
What it fixes
- Loading hitches while exploring (Spawn Budget). When you sail or run into new areas, the game builds many objects, locations and dungeons in a single frame. HitchFix spreads that work over several frames with one shared budget, so the game keeps moving instead of freezing for a moment. Dungeon rooms are paced, checked afterwards (missing rooms are built at once) and let go one at a time when you leave.
- Big locations learned per PC. Every world location is timed when it appears. The slow ones are remembered on your PC, their assets are loaded early behind loading screens and a hidden copy is made ready as you come near, so the next time it appears it costs almost nothing. A memory budget (based on your RAM) limits how many copies are kept, and they are let go first when memory runs low.
- Faster terrain. Ground colliders are cooked on a background thread, the game's terrain worker no longer pauses after every tile, unchanged terrain tiles keep their meshes, and the destination ground starts building during the teleport fade.
- Loading screens do the heavy lifting. Zones around you are set up back to back while the screen is black, memory clean-ups and first-time warm-ups (inventory, fonts, sounds, effects) run behind loading, teleport and respawn screens instead of while you play, and the screen stays black a moment longer when that hides a slow frame.
- Render and memory pauses (RenderTrim). Turns off shadows on tiny props, culls distant clutter and particles, trims distant tree shadows, lets finished fade effects rest, and keeps garbage collection out of the middle of a fight. Mod sound effects follow the in-game volume sliders.
- Small per-frame savings. Fewer temporary allocations, the object create/remove pass is skipped while nothing nearby changed, and noisy per-frame log lines are counted instead of written.
- Slow joins and save hitches (Minimap Cache + Save Hitch Fix). Keeps the generated minimap on disk so joining the same world again skips the long map rebuild. Map data is saved faster, repeated autosaves that change nothing are skipped or delayed, and a save right after sleeping or teleporting is hidden behind the black screen. Quitting and logging out always save.
Settings (F1)
Open the config with Configuration Manager (F1 by default) or BepInEx/config/vpf.ValheimPerformanceFixes.cfg.
- 0. Quick Setup: the Preset slider. Toward Performance = smoothest frames, toward Quality = more visual detail, 50 = balanced default. Moving it sets the detailed values for you.
- 0. Mod Overlap: HitchFix runs its own version of features that ValheimPerformanceOverhaul or FiresGhettoNetworkMod also offer. Tick a
Cede_<feature>box to hand that one job to the other mod instead (SpawnBudget, AutoScale, SceneLod, Grass, Particles, LayerCull, TreeShadows, Gc, OrphanPrune, RemovalCap, IdlePass). Every decision is written to the log under[Mod Overlap]. - 0. General … 12.: the render trimming settings (shadows, culling, particles, tree shadows, GC, adaptive and combat modes, mod throttles).
- 5. GC / 5b. Smart GC: when memory clean-ups may run (behind screens by default, not during play).
- 9. UI Warm-up: inventory warm-up, the spawn and teleport hold, and the missing-glyph fix.
- 13. Map Fog, 14. Distant Terrain, 15. Teleport Terrain Prefetch, 16. Fade Settle, 17. Loading Zones, 18. Terrain Worker: map fog upload, distant terrain and grass rebuilds, teleport and world loading.
- 20. Allocation Cuts, 21. Terrain Mesh Reuse, 22. Object Pass, 23. Combat Housekeeping: small per-frame savings.
- Spawn Budget - ...: Locations, Location Assets (learned big locations, hidden copies, memory budget, low-RAM protection), Dungeon, Zones, Heightmap, Arrival, Safety, Terrain Collider Bake, Slim Location Models, Diagnostics.
- Minimap Cache - ... and 2. Save Hitch Fix: map cache and save timing.
Every new feature has its own switch and plain description; turning one off gives the game's own behaviour. Ctrl+F12 toggles the render trimming off and on so you can compare.
Client and server
- Install it on your game (client) for the most benefit. Most of the newer features are client only.
- It is also safe on a dedicated server. On a server it detects there is no screen and only runs the parts that matter there; the graphics features stay off.
- It does not have to be installed on every player or on the server. Each copy only helps the machine it is on.
Optional mod support
These modules turn on by themselves only when the matching mod is installed. Without that mod they stay off and do nothing.
- DropNSpawn (
sighsorry.DropNSpawn): caching and pacing, and its sync work can run behind the loading screen. - Riverheim (
dev.gurebu.riverheim.stable): a disk cache for Riverheim's world generation, so it does not have to rebuild every start.
Compatibility
- Needs BepInExPack_Valheim.
- Works alongside most mods. Features that patch a game method stand down by themselves (with a log line) when another mod already rewrites or skips the same method.
- ValheimPerformanceOverhaul and FiresGhettoNetworkMod: see 0. Mod Overlap above.
- Balrond Core Optimizer: works alongside with its default settings; leave its experimental Terrain Mesh Cache off.
- If you used the older separate plugins (RenderTrim, SpawnBudget, MinimapCache, DropNSpawnCache, RiverheimCache), remove them. If one is still installed, the matching module switches itself off and logs a warning. Their old settings are copied in automatically the first time.
- The plugin ID is
vpf.ValheimPerformanceFixes, so settings from earlier versions keep working. New defaults only apply to keys that are not in your .cfg yet.
Source
Source code and issue tracker: use the Website link on this page. MIT license.
CHANGELOG
Changelog
2.2.1
New features since 2.2.0. Each new feature has its own switch in F1.
Terrain edit protection
- Terrain-edit objects load first: a zone's dig, raise, level and paint edits are created as soon as the zone is ready, ahead of the per-frame object budget, so edits made right after arriving are not lost.
- Duplicate terrain-edit guard: when you edit ground whose saved edits are known but not loaded yet, they are loaded on the spot and your edit is added to them, instead of the game starting a second, empty copy.
- Stricter terrain mesh reuse: a kept terrain mesh is checked against the current heights again and is forgotten whenever that tile's edits change. Mesh reuse steps aside while Balrond Core Optimizer's terrain mesh cache, or any other mod's terrain rebuild patch, is active, including one switched on mid-game.
2.2.0
New features since 2.1.0. Each new feature has its own switch in F1.
Smoother loading
- Loot from many creatures dying at once comes out over a few frames instead of all in one. Each creature's drops stay together, nothing is lost or rolled again, and held drops come out at once on save, logout, teleport and zone unload. Works with Drop That and DropNSpawn.
- The game's hourly unload of unused assets waits for the next loading screen, teleport or pause instead of running while you play.
Memory clean-up smoothing
- On calm frames the garbage collector gets a bigger share of the spare time, so clean-ups finish in small pieces instead of one long pause. Works with a frame cap or vsync.
- Small clean-up steps run at quiet moments: standing still out of combat, the pause menu, or the inventory or map open.
Equipment visuals
- InventorySlots' per-frame equipment visual rebuild is skipped while nothing on the character has changed. Equipment and transmog changes still show at once.
- BalrondAbsoluteOverhaul's per-frame armor bone check is skipped while the armor and body are unchanged.
- Optional, off by default: characters far from the camera update their equipment visuals less often.
Big locations
- The number of hidden location copies grows with your memory budget.
- A ready copy is let go when you are far from every known spot of that location, and no copy is made behind a loading screen for a location far from where you arrive.
- Locations you pass again in the same session are kept first.
- Lighter location models now stay on when DropNSpawn is installed.
Tweaks
- Per-frame loading budgets default to 5 ms (were 6 to 10 ms), so heavy fights and arrivals dip less. Settings still on the old defaults are moved once; values you changed are kept.
2.1.0
New features since 2.0.0. Every one has its own switch in F1, and player builds still load and unload exactly like the unmodded game.
World loading
- One shared budget spreads objects, locations, dungeons and zones over several frames, so exploring new areas no longer freezes the game for a moment.
- Dungeon rooms are built at a steady pace and checked afterwards; interiors you leave are let go one at a time.
- Zones around you are set up back to back while the loading screen is black.
- Far terrain and grass are rebuilt over several frames, and the map fog is uploaded in parts.
Big locations learned per PC
- Every world location is timed when it appears. Slow ones are remembered on your PC; their assets load early behind loading screens and a hidden copy is made ready as you come near, so they appear almost for free.
- Hidden copies use a memory budget based on your RAM and are let go first when memory runs low.
- Lighter models for often-loaded locations, without the parts the game creates and then throws away.
Terrain
- Ground colliders are cooked on a background thread.
- The game's terrain worker no longer pauses after every tile, and unchanged terrain keeps its meshes.
- The ground at a teleport destination starts building during the fade.
Loading, teleport and respawn screens
- Memory clean-ups run behind these screens instead of while you play.
- The inventory, fonts and sounds are warmed up behind the first loading screen, so the first inventory open is smooth.
- The black screen stays up a moment longer after spawning or teleporting until nearby objects are ready.
- A character save that comes as the sleep or teleport screen ends is hidden behind it.
Smaller per-frame savings
- Fewer temporary allocations, the object create/remove pass is skipped while nothing nearby changed, quieter combat housekeeping, finished fade-in effects stop updating every frame, and noisy log lines are filtered.
Working with other mods
- New Mod Overlap section: for features that ValheimPerformanceOverhaul or FiresGhettoNetworkMod also offer, tick a box to hand that job to the other mod.
- DropNSpawn's sync work can run behind the loading screen.
2.0.0
- First Thunderstore release as HitchFix.
- Combines five earlier plugins into one: RenderTrim, Spawn Budget, Minimap Cache + Save Hitch Fix, and the optional DropNSpawn Cache and Riverheim Cache.
- One config file with a Performance-to-Quality preset slider on the first tab, and plain-language descriptions for every setting.
- Optional modules only switch on when DropNSpawn or Riverheim is installed.
- Settings from the old separate plugins are copied in automatically on first start.