Editing Installing mods

{{BackToTutorials}}
{{Credit|[[User:Alistaire|Alistaire]]}}

==What you'll learn==

You'll learn where to install your downloaded mods and how to activate them, along with some notes on compatibility and backups.

==Finding mods==

Look online and find a mod that you want to try out. The main source for finding mods is the {{LudeonThread|15|mod release section|board}} on the forums.<br/>

Once you find a mod you like that is '''compatible''' with the version of RimWorld you have, you can download them from their individual threads.

If you want to install a Steam mod manually, https://www.steamworkshopdownloader.io/ can help. This might be useful in saving historical versions or for playing offline.

==Installation==

# Open the downloaded ZIP archive
# Go to your [[save file#Save file locations|RimWorld download location]]
# '''Windows''':
## Find your RimWorld directory:
##* For Steam users, the directory is typically: <code>C:\Program Files (x86)\Steam\steamapps\common\RimWorld</code>
## Drag and drop the extracted ModName folder into your <code>RimWorld\Mods\</code> folder (not in Core)
##* Make sure not to "double extract" your mod, e.g. <code>RimWorld\Mods\Modfolder\Modfolder</code>, when extracting your mod
###
# '''Mac''':
## Right-click the RimWorld application and ''show package contents''
##* For Steam users, the directory is: <code>Library/Application\ Support/Steam/steamapps/common/RimWorld</code>
## Drag and drop the ZIP archive's ModName folder into your Mods folder (not in Core) in the application package
# '''Linux''':
## Unpack archive into the Mods folder <code>~/.steam/steam/steamapps/common/RimWorld/Mods</code>
##* If you're play Rimworld from GoG the directory would be <code>/home/<user>/GOG\ Games/RimWorld/game/Mods/</code>
# Start up your game
# Click the Mods button and activate your mods.
Some mods require a fresh world generation to work.

===Editing mods folder===

In case your game stops running after you installed a mod, it's useful to have a backup of the mods folder somewhere. This way, you will always be able to undo a mistake that may occur.

<!-- I have no idea whether this is at all useful info -->It is also very important to never delete the ThingCategories.xml file in your mod pack; doing this will result in a black screen when trying to start the game up.

===Compatibility===

Not all mods are compatible with each other:

* Many content mods - such as Weapon, Apparel, Faction or even Hair mods - are compatible with each other
* Mods that change the same base game files, such as combat overhaul mods, are usually incompatible
* Mods that add functionality to base game things are compatible but usually won't include the things from content mods
* Modpack authors try to make mods in their pack compatible with each other. Adding or updating mods might break the pack.


You will know if you have incompatible mods if you are having serious gameplay issues, such as unplaceable items, graphical issues, colonists getting stuck, etc.<br/>
Having a console error might point to incompatibility as well, but some mods are expected to have console errors on start up.

==Next up==

*[[Modding Tutorials/Folder structure|Exploring the Folder Structure]]

[[Category:Modding]][[Category:Modding tutorials]]