Troubleshooting Mods

Due to the complex nature of some mods, things can sometimes go wrong. This page should be used for troubleshooting issues when installing mods for the game. To help everyone involved, please make sure you have followed all of these troubleshooting steps before contacting a mod developer about the issue. Modders are encouraged to link users to this page if they believe it will help the user solve their problem.

1. Version Checking

When installing a mod, you need to make sure that the version of the mod is made for the version of the game you are playing.

Mods on the ModDB all have a files tab, which lists all the mod versions that are compatible with what game versions. Ensure that you are using the most up-to-date mod version that supports your game's version. The mod will likely not work as intended or at all if you use the wrong version.

As shown in the above screenshot, mod version 3.6.6, although is the latest, does not support game version 1.19.8. Installing a mod version that is for a different game version will likely lead to issues.

2. Compatible Mods

Although the game has a lot of modding capabilities, not all mods work friendly with each other, and compatibility issues can cause game-breaking issues.

If you have several mods, the chance of mod conflicts becomes more and more likely. These are usually due to two mods trying to interfere with very similar aspects of the game. By disabling mods through the mod manager, you should try to pinpoint what mod(s) is/are not compatible, and then use whichever one is more likely.

Finding out which mod is causing issues...

There exists a simple "divide-and-conquer" method for finding out what mod is causing issues in a game. Note that all tests should be done on a new world to prevent corrupting worlds.

1. Firstly, find a method to always recreate the issue. This will allow you to test later on.
2. In the main menu, in the mod manager, disable half of your mods.
3. Start a new world, and see if the issue remains.
4. If the issue still happens, then the broken mod must be in the enabled list, so disable half of the enabled mods and repeat the process.
5. If the issue does not still happen, then the broken mod must be in the disabled list. Enable half of the disabled mods, and repeat the process.
6. Keep repeating the process until you have found a single mod that, when enabled, causes the problem, and when disabled, the problem goes away.

You should now know what mod is causing issues with your game. It is your decision on what to do with that mod.

If all else fails...

If you have gone through the above steps and the mod is still not working as expected, then you can report the issue to the mod developer and they will be able to assist you further.