Modding:Overview: Difference between revisions

From Caves of Qud Wiki
Jump to navigation Jump to search
m (consistency)
Line 11: Line 11:
You can create mods for the game by creating a Mods folder in your game save directory, and then creating a sub-folder inside of the Mods folder for your new mod. New content can be created and existing content can be modified or replaced via data files and textures placed in this directory.
You can create mods for the game by creating a Mods folder in your game save directory, and then creating a sub-folder inside of the Mods folder for your new mod. New content can be created and existing content can be modified or replaced via data files and textures placed in this directory.


For example, on Windows: <code>C:\Users\Brian\AppData\LocalLow\Freehold Games\CavesOfQud\Mods\MyAwesomeMod</code>
For example, on Windows: <code>%USERPROFILE%\AppData\LocalLow\Freehold Games\CavesOfQud\Mods\MyAwesomeMod</code>
Likewise, on Mac: <code>~/Library/Application Support/com.FreeholdGames.CavesOfQud/mods/MyAwesomeMod</code>
On Linux: <code>~/.config/unity3d/Freehold Games/CavesOfQud/Mods/MyAwesomeMod</code>


Likewise, on Linux: <code>~/.config/unity3d/Freehold Games/CavesOfQud/Mods/MyAwesomeMod</code>
On Mac: <code>~/Library/Application Support/com.FreeholdGames.CavesOfQud/mods/MyAwesomeMod</code>


You may have to create the "mods" folder yourself.
You may have to create the "mods" folder yourself.
Line 42: Line 41:
A: The location is dependent on your operating system.
A: The location is dependent on your operating system.


* PC: <pre>%USERPROFILE%\AppData\LocalLow\Freehold Games\CavesOfQud\Player.log</pre>
* PC: <code>%USERPROFILE%\AppData\LocalLow\Freehold Games\CavesOfQud\Player.log</code>
* Mac: <pre>~/Library/Logs/Unity/Player.log</pre>
* Mac: <code>~/Library/Logs/Unity/Player.log</code>
* Linux: <pre>~/.config/unity3d/Editor/Player.log</pre>
* Linux: <code>~/.config/unity3d/Editor/Player.log</code>




{{Modding Navbox}}
{{Modding Navbox}}

Revision as of 21:25, 25 April 2020

For information on installing mods, see Modding: Installing a mod.
For information on installing mods, see Modding: Installing a mod.

Caves of Qud presents a broadly extensible engine. The game's core definition files reside in %game directory%\CoQ_Data\StreamingAssets\Base.

You can create mods for the game by creating a Mods folder in your game save directory, and then creating a sub-folder inside of the Mods folder for your new mod. New content can be created and existing content can be modified or replaced via data files and textures placed in this directory.

For example, on Windows: %USERPROFILE%\AppData\LocalLow\Freehold Games\CavesOfQud\Mods\MyAwesomeMod Likewise, on Mac: ~/Library/Application Support/com.FreeholdGames.CavesOfQud/mods/MyAwesomeMod On Linux: ~/.config/unity3d/Freehold Games/CavesOfQud/Mods/MyAwesomeMod


You may have to create the "mods" folder yourself.

A note about text editors

Note that word processors, such as Microsoft Word, are not suitable for modding the game, because they save documents in a format intended for formatted text and the like, instead of for plain text, which is what programming tools tend to use.

Consider using Notepad++ (Windows only) or Sublime Text (all major platforms) instead, or nearly any other programming text editor. If you must make do with what's already installed on your machine, Notepad is also essentially useable, even if it's missing certain features usually desireable for programming, such as syntax highlighting.

Modding FAQ/Frequent Issues

Q: I keep getting an error when trying to save my game.

A: Most likely, you have a list in your mod. Qud's default method of saving doesn't handle lists, so you need to handle it yourself. To see how, check out this article on how to override Qud's default saving/loading.


Q: I'm stuck and don't know what to do.

A: Feel free to ask for help or guidance in #modding on the official Caves of Qud discord server! There are several modders there who use the channel to talk through and ask for feedback on their mods.


Q: Where can I find 'Player.log'?

A: The location is dependent on your operating system.

  • PC: %USERPROFILE%\AppData\LocalLow\Freehold Games\CavesOfQud\Player.log
  • Mac: ~/Library/Logs/Unity/Player.log
  • Linux: ~/.config/unity3d/Editor/Player.log