For the most up-to-date resources, be sure to check out the Hollow Knight Modding Discord
Comprehensive list of commenly asked questions/problems
Silksong Modding * How to start modding * MacOS: Common issues after attempt at installing mods * Important paths (Save files and Game files) * Information about save files (Backups, Save File editing and more)
Hollow Knight Modding * How to start modding * How to manually install mods * Hollow Knight crashes after installing mods * Important paths (Save files, Game files and Modfiles) * Information about save files (Backups, Save File editing and more) * How to use the Custom Knight mod * How to create/commission a Custom Knight Skin * How to use Hollow Knight Multiplayer * How to set up Randomizer * My nail does not behave normally/my game randomly speeds up or slows down * Steam Deck/Linux: Common issues after attempt at installing mods * How to fix healing (after using Hollow Point) * How to revert to vanilla/How to uninstall the mod installer
General resources Silksong
- Transfer files from Gamepass to Steam
- Important paths (Save files and Game files)
- Information about save files (Backups, Save File editing and more)
General resources Hollow Knight
- How to see what is left for 112%/Hunters Journal
- Common fixes for controller issues
- Important paths (Save files, Game files and Modfiles)
- Information about save files
- How to clear HK registry data
- Reduce Hollow Knight lag
- Transfer files from Gamepass to Steam
If you find an error in this, you can dm me on reddit or Discord (u/Thommie02081 and @thommie_ respectively) or contact the mod team
Transferring Gamepass files to Steam (Hollow Knight)
Finding the savefile
Go to the following location:
C:\Users\[Your username]\AppData\Local\Packages\TeamCherry.15373CD61C66B_y4jvztpgccj42\SystemAppData\wgs\[long chain of numbers]In the
[long chain of numbers], there'll be a couple of other random-letter-folders; you usually would want the large "file" file in the same folder as "container.4", but it can vary which file it is. (it'll be in there somewhere though).Transfering the file
Once you find the Xbox Game Pass file, copy it and paste it into the Steam save file location:
C:\Users\[Your username]\AppData\LocalLow\Team Cherry\Hollow Knight. Once you pasted it there, rename it to userX.dat, where X corrosponds to the save slot.Mods to help reduce lag
If you haven't got a mod installer yet, see this post
Other things to look at: * Does my pc not real too high temperatures? * Does my pc have enough free RAM (If not, try to close background programs) * Does my pc meet the required specifications? * Are my drivers up to date
Clearing HK Registry Data
This is useful for fixing some uncommon game behaviors, more commonly associated with playing on older patches. Warning: Doing this will reset your local game achievements, including your ability to start a Steel Soul and Godseeker save.
WindowsKey+Rat the same time to bring up the "Run" window, then enterregeditand pressEnter.Computer\HKEY_CURRENT_USER\Software\Team Cherry, then right-click on the folder, and select "Delete".Silksong File Paths
Notes: These assume you're using Steam, with default locations. The Save Files location is the same for all versions (except for XBox Games)
*Windows except XBox Games * 🪟
%USERPROFILE%/AppData/LocalLow/Team Cherry/Hollow Knight Silksong/C:\Program Files (x86)\Steam\steamapps\common\Hollow Knight Silksong[WindowsKey]+[R][Enter]Mac OS 🍎
~/Library/Application Support/unity.Team-Cherry.Silksong/~/Library/Application Support/Steam/steamapps/common/Hollow Knight Silksong/Hollow Knight Silksong.app/enter.*Linux * 🐧
~/.config/unity3d/Team Cherry/Hollow Knight Silksong/~/.local/share/Steam/steamapps/common/Hollow Knight Silksong/Making backups and copying Auto Saves: See this post
Save Files
What do save files looks like?
user#.datwhere#is the save slot for the fileuser3.dattouser1.datto set it to your first save slotReverting Backups
user#.dat.bak#, where the first#is the save slot, and the second#is the backup number. You will usually have your last three backups.bak#part of the backup versionModded Saves
user#.modded.json(and similarly named backup). This file and theuser#.datare part of the saveWhere are the files?
%appdata%\..\LocalLow\Team Cherry\Hollow Knight\I need a specific type of save file
.raror other archived format, then you will need to extract it with something like 7ZipEditing save files
Note: If it's charm related editing, see this image for what number references what charm
user#.json, which can be edited using Notepad or a similar text editorCommon fixes for controller issues
Try these separately first, but if they don't work, then you may need to try a combination of them.
Visual examples for Steam settings: https://imgur.com/a/MKQIYHO
What is left for 112%
For PC users:
The easiest and most convenient way to check what you are still missing is using this site:
https://reznormichael.github.io/hollow-knight-completion-check/
The save file location for non-windows/gamepass users can be found here
For Console users
There are 2 options for you to use.
How to revert to vanilla/How to uninstall the mod installer
How to revert to vanilla
There are various ways to revert your game to vanilla
How to uninstall the modinstaller
Since the modinstaller isn't a program that actually installs itself, uninstalling the mod installer is as simple as deleting either the
.exeor the folder which contains the files for Scarab, depending on the mod installer you are using.Note: Uninstalling the mod installer doesn't uninstall the mods you have installed when deleting the mod installer. To return to a vanilla game, see the section above.
How to fix healing (after using Hollow Point)
Using MoreSaves mod:
focusMP_amount"33Using QoL (Quality of Life) mod:
?tag savesin chat if you don't know where that is)user#.json(with#being the save slot number)CTRL+F"focusMP_amount"33Without using another mod:
?tag savesin chat if you don't know where that is)user#.dat(with#being the save slot number)CTRL+F"focusMP_amount"33user1.dat, rename if you edited a different save slot.)Fixing Common issues on Linux/SteamDeck
-force-openglto the steam launch arguments. Note: This can be a problem even if playing Vanilla, but it is commonly seen when Modding because of the greater resources used.CD "~/.local/share/Steam/steamapps/common/"to get to the Steam Apps directory, and then usesudo chmod -R 777 "Hollow Knight"to update the permissions for the install so that all users can access it.My nail does not behave normally/my game randomly speeds up or slows down.
My nail does not behave normally
Symptoms of this are:
This is almost always caused by debug. Specifically, the keybind part of debug.
What happens is that increasing/decreasing nail damage is bound to a key which you press without knowing it's a keybind. This results in the nail damage altering without you knowing it. To solve it, open your save with debug installed. Navigate through the binds menu until you find the bind for increasing/decreasing nail damage. From there reset the damage back to normal (21 for pure nail). You can also delete a bind by pressing the option to set a new bind and then pressing backspace.
Note: Deleting debug does not revert the changes made by it. If you have deleted debug but have had it installed prior, you will need to reinstall it to solve the problem.
My game randomly speeds up/slows down
This issue is most likely also caused by debug. What happen is that increasing/decreasing timescale is bound to a key which you press without knowing it's a keybind. This results in the timescale altering without you knowing it's cause. To solve it, open your save with debug installed. Navigate through the binds menu until you find the bind for increasing/decreasing timescale. From there reset timescale to normal (1.0x) You can delete the bind by pressing the option to set a new bind and then pressing backspace.
Creating Custom Knight skins
How to create skins:
The best resource for in depth learning how to create skins is the guide created by HBKit https://docs.google.com/document/d/1Zjc8Nh_6u4zBtJ22r_8YunRgP24_1UQBPabFiG8PZ5A/edit?usp=sharing
How to commission skins:
If you are not willing or able to create a skin for various reasons but do want to have one created after your image, you can commission a skin. There is a thread in the hollow knight modding discord for artists that accept commissions. You may also check the recruiting channels and ask there.
Server link: https://discord.com/invite/A3tnUzw8hB
Thread link: https://discord.com/channels/879125729936298015/880165008930140250/1206658814871339048
Note: Because skin creation is such a big project with the knight sprite sheet being over 500 sprites, costs for a commission can easily be $100+
Using Custom Knight
This is the mod for reskinning The Knight and other things in the game
Resources
Common issues
Del. You can edit this Keybind in the Custom Knight menu.Troubleshooting
If your problem isn't fixed from the Common Issues section above, then please create a post with the
moddingflair that includes the followingYou must post a screenshot that shows:
How to use Hollow Knight Multiplayer (HKMP)
How it works
HKMP puts a copy of each player into each other players world.
Enemies have separate health and will usually be in different places; Items/abilities must be collected separately; and Breakable objects must be broken by each player. Player attacks happen in each player's world, damaging any enemies/players it comes in contact with. A player is only hurt by the enemies in their own world. This page explains how you can use other mods and addons to synchronize some aspects, and improve your experience.
Public servers
Important note: "Invalid Addons" means that you have extra HKMP addons that can't be used on the server. Pouch servers can have any Addons that say that they require Pouch, but you otherwise cannot use others!
Troubleshooting
If you run into any sorts of problems, the first thing you should do is check the guide linked at the start of the message, almost all problems are described there.
Note: It's not described in the guide, but if one of you have backdash/sitbutton you need to disable it.
If after checking the guide and having read the note the problem still persists, make a support post in the Hollow Knight Modding Discord. When making that post, be sure to include the modlog of both you and the person you are trying to play with. How to get a modlog is described here. It's the path for save files
How to use/install the Randomizer Mod
Note: This assumes you have already succesfully installed a mod installer. If you haven't, see this post
Randomizer allows you to randomize basically everything. The base version is called Randomizer 4, which can be found on all current patch mod installers. Besides the base version, there are quite a few add-ons, which allow you to randomizer more things that the base version does not allow you yet. The add-ons can also be found on the mod installers. Lumafly allows to search for mods with integration with randomizer 4
Setting up randomizer
Common questions
My randomizer doesn't look like how it looks in X youtubers video
Randomization terminated due to an error
Silksong Save Files
What do save files looks like?
user#.datwhere#is the save slot for the fileuser3.dattouser1.datto set it to your first save slot ### Reverting Backupsuser#.dat.bak#, where the first#is the save slot, and the second#is the backup number. You will usually have your last three backups.bak#part of the backup version ### Where are the files?%appdata%\..\LocalLow\Team Cherry\Hollow Knight Silksong\.raror other archived format, then you will need to extract it with something like 7zip ### Editing save filesuser#.dat, Silksong also introducesRestore_Points#for each save file as a way of going back to key points in your save.user#.datfile would be (see above)Restore_Points#to have auser#.datfile. Aftwerwards, open the game and hit the 🔄 button below the save and select the point you want to go back to.Hollow Knight crashes upon opening after installing a mod
This error can happen for a number of reasons. Read through all of the common reasons below to see which might apply to you.
.zip file(if you downloaded it as a.zip, then you'll need to Extract the files from it)How to start modding
Video guide
Fireb0rn's tutorial video! (Note: as this video is a bit older, fireb0rn shows Scarab. However the community recommended installer is currently Lumafly, which is a more updated version of Scarab.)
Text guide
hollow_knight.exeSee here for the location of the Game FilesHow to install mods manually on 1.5
FaQ about manually installing
For all current patch mod installers
dllfile or a.zipthat you need to Extract. Extraction tutorial./Modsfolder and create a folder with the name of the mod.For Lumafly
dllfile or a.zipthat you need to Extract. Extraction tutorial.dllExample of an installed mod: https://imgur.com/a/edREcUB
Modding Silksong
Silksong Modding is supported using Thunderstore!
Note: While mods from other places exist, we do not support them, and you may have issues if you use mods from multiple places
At this time we recommend using r2modman or gale to install mods. We are aware these currently don't have MacOS support, and for now MacOS users will need to see this comment for installation information. When community installers exist that have proper support for MacOS, we'll be recommending those over the generic Thunderstore installers.
Various things to know about Modding Silksong on MacOS
~/Library/Application Support/unity.Team-Cherry.Silksong/Instructions for Modding Silksong on MacOS
BepInEx-BepInExPack_Silksongfolder, and open theBepInExPackfolderBepInExPackfolder (command+athencommand+c)command+v)Viewin the menu bar and selectShow Path BarHollow Knight Silksongfolder and selectOpen in Terminalarch -x86_64 sh run_bepinex.shand press enterDoneonce and temporarily ignore the next popupDoneagain, and the next one should have anOpen Anywaybutton. Click it (you may need to enter your password there) then click OKBonus: make Steam automatically open Silksong with BepInEx:
"/Users/username/Library/Application Support/Steam/steamapps/common/Hollow Knight Silksong/run_bepinex.sh" %command%usernameby your MacOS usernameImportant paths
Notes: These are for Steam's default locations. For GoG, locate your 'hollow_knight.exe' folder and follow from there. The Saves folder also contains Global Settings and your ModLog.txt. Some mod installers such as Lumafly can open these folders for you.
Windows except XBox Games
%APPDATA%\..\LocalLow\Team Cherry\Hollow Knight\C:\Program Files (x86)\Steam\steamapps\common\Hollow Knight\C:\Program Files (x86)\Steam\steamapps\common\Hollow Knight\hollow_knight_Data\Managed\Mods\[WindowsKey]+[R][Enter]XBox Games
%AppData%\..\Local\Packages\Team Cherryin the nameC:\XboxGames\Hollow Knight\Content\C:\XboxGames\Hollow Knight\Content\hollow_knight_Data\Managed\Mods\Mac OS
~/Library/Application Support/unity.Team Cherry.Hollow Knight/~/Library/Application Support/Steam/steamapps/common/Hollow Knight/hollow_knight.app/hollow_knight.app, select "show contents", then go to:contentsᐅresourcesᐅdataᐅmanagedᐅmodsenter.Linux
~/.config/unity3d/Team Cherry/Hollow Knight/~/.local/share/Steam/steamapps/common/Hollow Knight/~/.local/share/Steam/steamapps/common/Hollow Knight/hollow_knight_Data/Managed/Mods/Proton File Paths
~/.steam/steam/steamapps/compatdata/367520/pfx/drive_c/users/steamuser/AppData/LocalLow/Team Cherry/Hollow Knight~/.local/share/Steam/steamapps/common/Hollow KnightTransferring Gamepass files to Steam (Silksong)
Finding the savefile
Go to the following location:
C:\Users\YOUR_USERNAME\AppData\Local\Packages\TeamCherry.HollowKnightSilksong_RANDOM_NUMBERS\SystemAppData\wgs\000901F0772A31B3_000000000000000000000000636F5860\RANDOM_NUMBERSIn the
RANDOM_NUMBERS, there'll be a couple of other random-letter-folders; you usually would want the most recently edited file, but it can vary which file it is. (it'll be in there somewhere though).Transfering the file
First boot up Silksong on Steam once, where you start a savefile until you have bound the nail (very start of the game).
Once you find the Xbox Game Pass file, copy it and paste it into the Steam save file location:
C:\Users\YOUR_USERNAME\AppData\LocalLow\Team Cherry\Hollow Knight Silksong\RANDOM_NUMBERS. Once you pasted it there, rename it to userX.dat, where X corrosponds to the save slot. You may want to delete the already existing userX.dat you just created.