Game updates, especially on the development branch tend to break mods.

The Procedural Wrecks update broke all known mods. Newer updates such as the release version, Vehicles and now the Humble DLC broke mods again.

Unfortunately, almost all mod authors stopped updating their mods. These outdated mods will break the current and future game in various ways and have to be removed.


Please don't forget that mods themselves get updates from time to time fixing bugs or adding new features.

Therefore, if you happen to run into an issue with a mod, please check for a newer version first before posting about it.


Primary repository of mods: NexusMods[www.nexusmods.com]

For the official 1.0 release look for mods updated since April 9, 2024.


Most mods don't actively support the development branch versions of the game. They might work, they might break.

Check out (or wait for) the Mods Bundle for the Dev Branch[www.nexusmods.com] during the dev-branch days for updated mods of mine.


You have to perform the following steps once, the first time you want to start modding the game:

• Important! When upgrading from before the Official Release (1.001) version, you'll have to perform a clean reinstall of the game and modding framework. Uninstall the game, then delete every remaining file from the game's install directory. Install the game as normal.
  
• Install BepInEx 5.4.22 (Windows & Proton[github.com]). You should extract the zip like this image[imgur.com] into the game's install directory.
  
• On the Steam Deck, open the game's properties and put WINEDLLOVERRIDES="winhttp.dll=n,b" %command% into the launch options field.
  
• Start the game, quit the game.
  
• Find the BepInEx\config\BepInEx.cfg file, and in it, set HideManagerGameObject = true. The entry can be found like this[imgur.com].
  
• Alternatively, install the Mod Enabler[www.nexusmods.com] mod.

Now you can install the individual mods:

• Extract the mod's files from its ZIP file into BepInEx\Plugins. I recommend keeping the folder structure from the ZIP intact.

Windows: https://www.youtube.com/watch?v=grOSCSfnlRk

SteamDeck: https://www.youtube.com/watch?v=koehytJuzpA


When in doubt, do a clean install of the game and mods as instructed in the previous section.

A common issue is with either downloading the wrong BepInEx version or not downloading it at all. Currently, the Vortex mod manager does not preinstall BepInEx for players, thus it has to be done manually.

The second common issue is with extracting the BepInEx zip. Windows tends to extract into a subdirectory, which is always incorrect. Make sure you extract the zip in a way that files such as winhttp.dll ends up next to Planet Crafter.exe and you see a directory named BepInEx with only a subdirectory named core. Image[imgur.com]



In the game's install directory, find the winhttp.dll and rename it to something else. For example, winhttp.dll.disabled. Rename it back once you want modding to work again.

The game will still say Modded but don't worry about that.


Delete files or the folders in BepInEx\plugins belonging to the mods.

You can also delete files from BepInEx\config belonging to the mods.


Please visit the Official Discord[discord.gg]'s #modding channel.