🛠️ Modding 🛠️

[akarnokd]

⚠️ Warning ⚠️

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.

📝 Note 📝

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.

Finding mods

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

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

Development Branch Mods

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.

Installing mods

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.

Video guides by MrSpicyGaming

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

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

Issues with mods

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]

Disabling mods

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.

Uninstalling mods

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

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

Questions about or issues with mods

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

[PinaColada]

Originally posted by starlight78sso:

Make sure any and all mods are up to date, I had that issue too till I realized I forgot to update my mods.

Thats what I did before I wrote here, nothing happened, I will try again...

[Major Trubble]

akarnokd please update your autocrafter mod , I really miss it , Garcia made one but it has not option to change delay , thanks , love your mods , they always work perfectly .

[wncol2004]

Originally posted by PinaColada:

Originally posted by starlight78sso:

Make sure any and all mods are up to date, I had that issue too till I realized I forgot to update my mods.

Thats what I did before I wrote here, nothing happened, I will try again...

Many mods no longer work because the author hasn't updated them in years. akarnokd is the only one that is keeping up to date (THANKS AKARNOKD! Your efforts are greatly appreciated!). All others no longer work at all or crash the game. Any mods that haven't been updated in the last few weeks (since the Procedural Wrecks update) won't work.

[EmilyHunter]

(Edited) Never mind, I just saw you have added a Craft From Containers mod already - THANK YOU SO MUCH (it's my absolute QoL mod, next to the Stacking one)

Agree with wncol2004 - you're a total star 😉⭐

[wncol2004]

Originally posted by wncol2004:

Originally posted by PinaColada:

Thats what I did before I wrote here, nothing happened, I will try again...

Many mods no longer work because the author hasn't updated them in years. akarnokd is the only one that is keeping up to date (THANKS AKARNOKD! Your efforts are greatly appreciated!). All others no longer work at all or crash the game. Any mods that haven't been updated in the last few weeks (since the Procedural Wrecks update) won't work.

Correction, Better Jetpack still works. Other than all of akarnokd's mods working, this is the only non akarnokd mod I have found that works...so far.

[DJQuad]

Some mods still do work but it's always a gamble that they will, and could cause weird problems not seemingly even related to the mod itself.

Agreed with the positive comments about akarnokd as well!

[The Militant Penguin Front]

So does that mean losing your save game to reinstall?

[starlight78sso]

Originally posted by The Militant Penguin Front:

So does that mean losing your save game to reinstall?

I havent noticed any issues so far in uninstalling or reinstalling mods with this game. Just know some like the stacking mod will cause issues if you uninstall it.

[phoneticdecay]

Originally posted by Just_Plain_Stupid:

I need help because I've tried all this including uninstalling and reinstalling the game and starting from scratch and downloading it all again but it still doesn't work

Did you make sure that all the game folders were removed?
Often player saves, configs and such are left behind.
If any remnants associated with modloader will cause your problems to persist even with a clean install.

You can manually search these files or using a program like Revo uninstaller.

[Guillermo]

Is there any way to get mods without having to create an account and login to Nexus Mod?

[Mr. Moyer]

Originally posted by Raudkoer:

There was yet another big update.For me,it looks,Bepinex wont work anymore,as no cfg or new folders are created...

You need to uninstall the game, delete all files, reinstall the game, start the game once, quit the game, then go download the BepinEx and extract the zip file into the game directory. Run the game again, then quit the game. Now you can see the Bepinex/Config folder is created, along with the Bepinex/Plugins folder. Now you can start downloading the mod files into Plugins. Anything you put into the Plugins file will activate the next time you run the game.

I think you forgot to uninstall the game since the previous update, you should only need to do this ONCE though; future updates shouldn't need a complete uninstall/reinstall anymore.

I also think you forgot to run the game once and then quit the game after you installed the BepinEx zip files. Half of the folders and files for BepinEx will not exist until after you run the game and exit it for the first time after installing BepinEx.

[Jo_Rocker]

Mods still work for me. At least the item stacking one. multiplayer with mods will probably be a nightmare!

[PocketNerd]

Is there any documentation on creating mods? Would be interesting to try.

[Valerie]

Any plans on making Steam Workshops a thing?

[Denian Shades]

Originally posted by apocolypse321:

I don't suppose someone could put up a tutorial for steam deck users. It would be really helpful and greatly appreciated. Thank you.

I'd also like instructions for Steam Deck, I've followed the normal ones and nothing happens when I start the game after copying BepInEx to the game folder, neither a plugin folder nor a config folder is added...