Modding:Installing a mod
There are multiple ways to obtain and install mods for Caves of Qud.
Note: Not all mods will be available by all methods.
Steam Workshop
Note: This section applies only to running the game through Steam. (Even if you obtained the game through Steam, running it from outside of Steam will cause it not to load any Steam Workshop mods.)
- Go to Caves of Qud's Steam Workshop page.
- If you aren't already logged in, log in to Steam with the account you'll be playing under.
- Locate the mod you'd like to install and go to its page.
- Press "Subscribe".
Now, the next time you run the Steam desktop client, it will download the mod and install it where the game will load it.
Manual Download
Mods can also be downloaded manually from a variety of other locations.
For example, the Nexus Mods site has a page for Caves of Qud. You can also download mods from github, bitbucket, or any other code hosting website where a mod is hosted. Sometimes, mod authors will post links to their code hosting site in the description of the mod on the Steam Workshop, which means it can still be a good idea to check the Steam Workshop even if you don't use Steam.
Set Up Your Mods Folder
To install manually downloaded mods, you must first create a Mods
folder in the game directory:
- Go to the game's configuration directory on your system. The default paths for each operating system are:
- Windows:
C:\Users\[Username]\AppData\LocalLow\Freehold Games\CavesOfQud\
- Linux:
/home/[Username]/.config/unity3d/Freehold Games/CavesOfQud/
- Mac:
Users/[Username]/Library/Application Support/com.FreeholdGames.CavesOfQud/
- Windows:
- Create a
Mods
folder in that directory if one doesn't already exist.
Download the Mod
Nexus Mods
- Go to the Nexus Mods page for Caves of Qud.
- If you aren't already logged in, log in to Nexus Mods.
- Locate the mod you'd like to install and go to its page.
- Press "Manual Download" to download a
.zip
archive of the mod.
GitHub
- Press "Clone or download".
- Press "Download ZIP" to download a
.zip
archive of the mod.
Bitbucket
- Press "Downloads" on the left sidebar.
- Press "Download repository" to download a
.zip
archive of the mod.
Other Sites
Other code repositories or mod hosting sites should have some option to download the mod's files. You can download the files and put them in your Mods directory, using the folder structure demonstrated below.
Install the Mod
Now that you have a .zip
archive of the mod, you can install it in the Mods
directory you created earlier.
- Unzip the file into the
Mods
directory. - Verify that the
Mods
folder structure looks correct.- Each mod's files should be contained in a separate folder in the
Mods
directory. - The folder name for an individual mod doesn't matter - the game loads content from any folder in the
Mods
directory.
- Each mod's files should be contained in a separate folder in the
For example, your Mods
directory might look like this if you have 3 mods installed:
<Caves of Qud App Directory>
Mods
SampleMod1
CodeFile.cs
ObjectBlueprints.xml
Textures
character_tile.png
SampleMod2
CodeFile1.cs
CodeFile2.cs
ObjectBlueprints.xml
Mutations.xml
SampleMod3
ObjectBlueprints.xml