PauseGuard

PauseGuard is a lightweight, zero-overhead background optimizer that automatically coordinates the engine's persistence system:

πŸ›‘ The Problem in Vanilla Dragonwilds

Have you ever paused RuneScape: Dragonwilds to grab a drink, answer the door, or take a break, only to return, click unpause, and find the pause menu gone but the world completely frozen in place with the "Saving..." icon stuck on screen?

In RuneScape: Dragonwilds, the game's persistence engine (SPUD - Steve's Persistent Unreal Data) continues running background auto-save tasks every 5 minutes (dom.StateSaveFrequencyMins:5) even while the game is paused.

Because the world is paused and actors cannot move, these repeated saves generate dozens of duplicate, incremental World Partition cell cache layers (SpudCache/*.lvl) and cause process memory to balloon up to 8–13+ GB. When you finally hit Unpause, the engine forces a synchronous global cell compaction pass on a worker thread to prune deprecated level data. The game thread deadlocks waiting for this pass to complete, resulting in a 5 to 15+ minute freeze (or a complete hard crash).

 


πŸ›‘οΈ How PauseGuard Fixes It

PauseGuard is a lightweight, zero-overhead background optimizer that automatically coordinates the engine's persistence system:

  1. Intelligent Auto-Save Throttling (dom.StateSaveFrequencyMins 0):

    • When you open the pause menu, PauseGuard allows the game's initial clean save to commit safely to disk (your progress is always 100% saved).
    • Once written, PauseGuard automatically suspends redundant periodic auto-saves while you remain paused.
    • Zero duplicate cell snapshots are generated, preventing the massive backlog that causes the unpause hang.
  2. Instant Unpause Resumption:

    • The moment you unpause, PauseGuard instantly restores your normal 5-minute auto-save frequency (dom.StateSaveFrequencyMins 5).
    • Because no cell backlog accumulated while you were AFK, the engine unpauses immediately and smoothly with zero stutter.
  3. Mod Hibernation Coordination:

    • Exposes a global _G.PauseGuard_IsPaused flag so background mods (such as Minimap radar, item scanners, and auto-gatherers) put their timers to sleep during pause rather than flooding the game thread with hundreds of thousands of tasks.
  4. Emergency / Manual Save Hotkey:

    • Press Shift + F10 at any time during gameplay to trigger an instant, clean manual save on demand.

✨ Features

  • ⚑ Instant Unpauses: Leave the game paused for 10 minutes, 2 hours, or overnight — unpausing is instantaneous every time.
  • πŸ’Ύ 100% Safe: Always preserves the initial pause save; your game progress is never lost.
  • πŸ“‰ Zero Memory Leaks: Prevents multi-gigabyte memory buildup in the background during extended pauses.
  • πŸ”Œ Universal Compatibility: Works seamlessly with pure vanilla gameplay as well as all community mods (CustomBuilds, OSRS Minimap, QuickStack, etc.).
  • πŸ› οΈ Plug-and-Play: No configuration required. Drop it into your mods folder and it works automatically.

πŸ“‹ Requirements

  • UE4SS experimental build with Unreal Engine 5.6 support (the experimental-latest release on the RE-UE4SS GitHub).
  • Single-player mode.

πŸ“¦ Installation

  1. Ensure UE4SS is installed in:
    RSDragonwilds\Binaries\Win64\
  2. Extract PauseGuard-1.0.0.zip (or copy the PauseGuard folder) into:
    RSDragonwilds\Binaries\Win64\ue4ss\Mods\
  3. Open RSDragonwilds\Binaries\Win64\ue4ss\Mods\mods.txt in a text editor and ensure the line exists:
    text
     
    PauseGuard : 1
  4. Launch the game and enjoy hang-free pauses!

⌨️ Controls

Hotkey Action Description
Escape Pause / Unpause Automatic save throttling & instant unpause
Shift + F10 Manual Save Forces an immediate clean save to disk

PauseGuard Team

profile avatar
  • 2
    Projects
  • 59
    Downloads

More from Paul1337noob