Nuckflare-AssetUnloadGate icon

AssetUnloadGate

Stops Valheim's hourly 'Unloading unused assets' freeze (200-500 ms) while you are playing. Cleanup still runs in menus, on respawn/sleep, and at a configurable cap. Works on clients and dedicated servers.

Last updated a day ago
Total downloads 48
Total rating 0 
Categories Mods Tweaks Server-side Client-side Utility
Dependency string Nuckflare-AssetUnloadGate-1.1.0
Dependants 1 other package depends on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
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.2350

README

AssetUnloadGate

Valheim calls Resources.UnloadUnusedAssets() once an hour (Game.CollectResourcesCheckPeriodic). On a large world this freezes the game for 200-500 ms and shows "Unloading unused assets" in the top-left corner.

This mod skips that hourly call while it would interrupt play:

  • Client: skipped while you are in the world. Vanilla cleanup still runs in the main menu, when you respawn and when you sleep (if 20+ minutes have passed), so memory is still reclaimed. A safety cap forces a cleanup at most every ClientMaxHours (default 4).
  • Dedicated server: skipped while players are connected, runs normally when the server is empty. Safety cap MaxHoursWithPlayers (default 6).

No network component, no version check: players without the mod are not kicked; they simply keep the vanilla behaviour. Install on clients for the client fix, on the server for the server fix.

Configuration

BepInEx/config/homelab.assetunloadgate.cfg

Key Default
Enabled true master switch
MaxHoursWithPlayers 6 server: longest gap between cleanups while players are online
ClientMaxHours 4 client: longest gap between cleanups while in the world

Each skip is logged: Saatlik UnloadUnusedAssets atlandi ...

Changelog

  • 1.1.0 client support
  • 1.0.0 dedicated server only