Skip to content

Installing Hollow Knight: Silksong mods with BepInEx: manager or manual

Official image from Hollow Knight: Silksong
Image: official, via Steam.
By ModsDrop Published 9 November 2026 · 3 min read

This guide is for Hollow Knight: Silksong players who want to run community mods safely. By the end you will know how to set up BepInEx through a manager or by hand, where mods and their settings live, and how to undo everything if you change your mind.

Silksong mods are community plugins, not the weapons, tools or upgrades you find inside the game. They run on BepInEx 5, a mod loader built for Unity games, and you will find them hosted on Thunderstore and Nexus Mods. Always grab mods from the author’s own listing rather than a random reupload.

Back up your save first

Before you install anything, copy your save folder somewhere safe. On Windows this is %USERPROFILE%AppDataLocalLowTeam CherryHollow Knight Silksong. If a mod ever corrupts a save or behaves oddly, you can drop the backup back in and carry on as if nothing happened.

Pick one route, not both

There are two ways to get BepInEx running: through a mod manager, or by hand. Choose one and stick with it. At least one mod author has warned that a manual BepInEx install conflicts with how Thunderstore tools manage files and profiles, so mixing the two causes problems that are hard to untangle.

The manager route

This is the simpler option for most players. Tools like r2modman or the Thunderstore Mod Manager handle the mod loader and your mod list for you.

  1. Install r2modman or the Thunderstore Mod Manager.
  2. Select Hollow Knight: Silksong from the game list inside the manager.
  3. Create a new profile for your mods.
  4. Install BepInExPack_Silksong, which is a preconfigured BepInEx build made for this game.
  5. Browse and install the mods you want through the manager’s interface.
  6. Launch the game through the manager, not through Steam directly.

Launching through the manager matters because that is what loads your chosen profile and mods. Starting the game from Steam instead will just give you the vanilla game.

The manual route

If you prefer to handle files yourself, you can install BepInEx 5 directly into the game folder.

  1. Find your game folder in Steam by right-clicking Hollow Knight: Silksong, choosing Manage, then Browse local files.
  2. Download BepInEx 5 from its official source.
  3. Extract the archive and move its contents into the folder containing the game’s executable.
  4. Launch the game once through Steam and let it close naturally. This generates the BepInEx folders you need.

Once that first run is done, you have a working manual BepInEx install sitting alongside the game.

Where mods and settings live

For a manual install, mod files go into BepInExplugins. Drop the mod’s files in there, then run the game once with the mod present. After that first run, look in BepInExconfig and you should find a settings file for that mod, which you can open and adjust as needed.

If you are using a manager, it handles plugin placement and configuration through its own interface, so you shouldn’t need to touch these folders directly unless something needs checking.

If something goes wrong

When mods don’t seem to load at all, the first place to look is BepInExLogOutput.log. It records what BepInEx tried to load and any errors along the way.

If the log isn’t enough, open BepInExconfigBepInEx.cfg and find the Logging.Console section. Set Enabled to true there, then relaunch. This opens a console window alongside the game showing load messages in real time, which makes it easier to spot where things stall or throw an error.

Undoing it all

If you want the game back to a clean, unmodded state, the method depends on your route. With a manager, switch to its vanilla or default launch option, which skips BepInEx entirely.

For a manual install, remove the BepInEx folder along with winhttp.dll and doorstop_config.ini from the game folder. Those three items are what hook the loader into the game, so deleting them returns you to an untouched install.

Keep your mod use to offline, single-player sessions unless an author explicitly says otherwise, since loaders like this are not designed with online modes or anti-cheat systems in mind. A tidy habit worth keeping: note down which mods you installed and in what order, so if one causes trouble later you know exactly what to remove first.

← All news