Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
776
Size
362KB
ADDatHost Valheim hosting
30% off

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.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.