Modding:Overview

From Caves of Qud Wiki
Revision as of 19:29, 25 April 2020 by imported>Sepherescent (→‎Modding FAQ/Frequent Issues)
Jump to navigation Jump to search
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: C:\Users\Brian\AppData\LocalLow\Freehold Games\CavesOfQud\Mods\MyAwesomeMod

Likewise, on Linux: ~/.config/unity3d/Freehold Games/CavesOfQud/Mods/MyAwesomeMod

On Mac: ~/Library/Application Support/com.FreeholdGames.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 dependant on your operating system.

PC:

Mac: /library/logs/unity/player.log

Linux: