SilksongFocusQoL

v1.0.1·Updated 2025-10-11

Pauses game and mutes audio when window loses focus; auto-unpauses within configurable time window.

About this mod Author’s original text

Silksong Focus QoL

A mod for Hollow Knight: Silksong that improves window focus behavior.

Automatically pauses and mutes the game when the window loses focus, and unpauses when focus is restored within specified time window.

Features

  • Pause the game when unfocused
  • Mute audio while unfocused
  • Auto-unpause when focus returns
  • Configurable time window for quick tab-outs
  • Supports real-time configuration via Configuration Manager

Configuration

After the first launch, the configuration file is created: BepInEx/config/com.zlq.silksongfocusqol.cfg

You can modify the settings either manually in the.cfg file (requires restarting the game), or use the Configuration Manager to adjust settings in real-time while the game is running.

Example config file

Settings file was created by plugin Silksong Focus QoL v1.0.1

Plugin GUID: com.zlq.silksongfocusqol

[Settings]

Mute audio when window loses focus

EnableAutoMute = true

Pause game when window loses focus

EnableAutoPause = true

Unpause when focus returns

EnableAutoUnpause = true

Time window to auto-unpause

0 = always unpause when focus returns; >0 = only if refocus occurs within this many seconds

AutoUnpauseWindow = 3

Installation

Requirements: BepInEx 5 is required for this mod.

  • In Steam, right-click Hollow Knight: Silksong → Manage → Browse local files.
  • Download BepInEx.zip and extract its contents into the game folder.
  • Launch the game once, then exit.
  • Open the BepInEx folder in the game directory. You should see plugins and config folders — this confirms BepInEx loaded correctly.
  • Place this mod's.dll file into BepInEx/plugins.

For easier configuration in-game, you can also use BepInEx 5 with Configuration Manager.

Changelog

See the full changelog here.

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack_Silksong

File & checksum

Filename
SilksongFocusQoL-1.0.1.zip
File size
49.6 KiB