Modding Troubleshooting Tips and Guides

From RimWorld Wiki
Jump to navigation Jump to search
Basics Menus Game Creation Gameplay Pawns Plants Resources Gear Mods
Basics Menu Controls User Interface Save File Modding Version history

Basic Troubleshooting Things You Should Do

"My game broke/crashed/the UI is gone/froze, what do I do?"

You should:

- Verify with Steam (if you use it to run Rimworld).

- Clear your configs (instructions below).

- Check your mod order (instructions also below).

- Make sure no mods updated since you last played, if a game that was running fine suddenly broke the next time you loaded it.

Basic Load Order Rules:

Mods must be loaded beneath any and all dependencies.

eg: most mods depend on Core to function and must load below it

Mods should not/cannot be loaded with other incompatible mods.

How do we know which mods are incompatible? Reading mod descriptions, asking people who know things, and trial/error

In the instance of multiple mods that change the same thing, whichever is loaded last will take precedent

There are some "ifs" and "buts" in this statement, but it's largely true

Local Mods:

Windows: C:\Program Files (x86)\Steam\steamapps\common\RimWorld\Mods

or C:\Program Files (x86)\RimWorld\Mods

Mac OS X: Right-click the RimWorld application and show package contents cd Library/Application\ Support/Steam/steamapps/common/RimWorld

Linux: ~/.steam/steam/steamapps/common/Rimworld/Mods;

Config Files:

--RimWorld configuration files and most mod settings are kept in this folder, and removing them will reset all settings to default.

--"Clearing configs" refers to deletion of old/all configs in the aforementioned folder

--Old mod config files are not automatically removed and may cause errors.

--Save the "ModsConfig.xml" as this is your mod load order, and if you remove it you will lose your modded load order. %appdata%\..\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Config

Steam Default Install Location:

C:\Program Files (x86)\Steam\steamapps\common

Steam Default Mod Install Folder:

C:\Program Files (x86)\Steam\steamapps\workshop\content\294100

Verify Game Files with Steam:

> Steam Library

> Right Click RimWorld

> Properties

> Local Files

> Verify Integrity of Game Files...

Change Game Version with Steam:

> Steam Library

> Right Click RimWorld

> Properties

> Betas

> "Select the beta you would like to opt into:"

Load Order:

Rimpy is a useful tool that works outside the game, to make it easier to sort your mods. It also has it's own auto-sort function if you want to see if that will help your issue:

There are also a few mod managers out there, both as mods and as external programs.

Another option for sorting your mods is to follow this guide here:

An explanation of how this works code wise;

"Keep in mind that not all mod conflicts will be solved by shuffling load order around. Sometimes mods are just incompatible until the mod authors put in effort to fix their mods.

Sometimes mods will just be incompatible.

As with most things, the truth is a bit more fine-grained. It's true that "Core, Mod 1, Mod 2, Mod 3" is the load order, and the last mod "wins", but the actual load order is a bit different.


- xpath

- C#

The game first loads all XML (defs, mostly) from Core, Mod 1, Mod 2, Mod 3

Then it applies all xpath patches from Mod 1, Mod 2, Mod 3

Then it loads the C# from Mod 1, Mod 2, Mod 3

Core doesn't use xpath or load any C#, so they're not in that list. The C# for RimWorld is already loaded by that point, roughly speaking.

So if Mod 3 overwrites something in XML, but Mod 2 overwrites it in xpath and Mod 1 overwrites it in C#, it's Mod 1 that wins -- even though Mod 3 and Mod 2 come after it in the load order.

There are a few things that matter with load order:

- Does the mod require a different mod? Examples of that are mods that require HugsLib, Proper Shotguns, Turret Extensions, Alien Races, JecsTools, whatever. If you are missing a dependency, you'll notice: You get a nice red error saying something like Could not find type named TurretExtensions.CompProperties_Upgradable from node <A lot of XML> and missing a dependency like that will put the entire game in a corrupted and unplayable state.

And then there is another insidious thing some XML mods do: overwrite (abstract) bases. For that, I refer you to This is something that's still unfortunately very frequently done, and it can cause havoc.

The C# summary slightly diverts from the truth. It even depends on how they instantiate the mod; there are two or three possible hooks and they happen at different times. Most mods that mess about with Defs will all have to do it in the second or third hook.

There's inherit from mod, which happens before Defs are loaded. Generally mods can't screw around with Defs in there.

There's the staticconstructoronstartup annotation which happens after Defs are loaded. This is where mods would screw around with Defs, for the most part.

Finally there's Hugslibs' ondefsloaded, which is exactly like a staticconstructoronstartup, but it runs after the staticconstructoronstartup utility is done.

and fwiw: that's just the Defs side of the equation

I won't even mention the harmony conflicts (which are way harder to detect) or runtime conflicts (which sometimes get logged, but not nearly always)

take the world edit mod: I can't remember which page it was, but basically if you click next somewhere and from there on you get redirected to world edit's version of whatever the next screen would've been.

There's like.. almost zero chance of detecting that programmatically"

Common things people do that they should be doing differently

These are the opinions of one particular troubleshooting group, and not of the rest of the maintainers of this article. If you take offense, please direct your fury at the Unofficial Rimworld Discord server, thank you.

-Do not run out of date mods. This means mods that are for a different version of the game than you are running. The only exception is Allyourbase at this time.

-If asked to add and use Allyourbase, do NOT turn on Verbose Logging till you are asked to do so.

-Do not run two copies of the same mod. This causes things to break horribly.

-Do not use modpacks. They are almost always partially out of date, almost always partially broken, and you will be told to make your own list if you present them to a troubleshooter. Also Samuel Streamer needs to either stop editing around all the dev commands they use, or they need to stop giving people the packs without FIXING them first.

-Do not come into a troubleshooting area with "Can someone help?" and nothing else. Do not even come into such an area with that and a log. Come with a description of your problem, AND a log, so that troubleshooters do not have to spend multiple minutes asking for a description of your problem.

-If a troubleshooter asks you to do something that does not ACTUALLY BREAK LAWS OR PUT YOU IN HARMS WAY, do it. Even if you did it already. You're not being asked as a delaying tactic, or as a power trip; you are being asked to do that thing so that they can help you fix your game.

-If you come from modding Skyrim or Fallout and you are used to the LOOT filter: Guess what, Rimpy exists, it hasn't had enough time to get to where LOOT is (though the devs are working on it). Use it.

-Always provide a Hugslog if possible. Yes, even if it has to come from the main menu. Yes, even if it has to come from a restart before the error occurs. It will STILL be useful. (Hugslogs are acquired by adding the Hugslib mod, and then either pressing Ctrl+F12 while in game, or navigating to the dev mode console window and hitting the green "Share Logs" button.)

-It's (almost always) not Achtung or Rocketman.

   ~Both of these mods check what other mods are doing to try to make bugs easier to notice and fix. They are probably not the cause of whatever they catch.