- v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
- Use this page to report any issues related to the migration.
Modding pitfalls
v50.12 · v0.47.05 This article is about the current version of DF.Note that some content may still need to be updated. |
- For a guide to getting started with modding, see Modding.
| Modding |
|---|
| Tokens |
| Audio · Biome · Graphics · Interaction · Mod info · Plant · Speech · Sphere · Syndrome · World |
| Body tokens |
| Body · Body detail plan · Bodygloss · Tissue |
| Creature tokens |
| Creature · Creature mannerism · Personality · Creature variation · Procedural graphics layer |
| Descriptor tokens |
| Descriptor color · Color · Descriptor pattern · Descriptor shape |
| Entity tokens |
| Entity · Ethic · Language · Position |
| Job tokens |
| Building · Labor · Reaction · Skill · Unit type |
| Item tokens |
| Item type · Item definition · Ammo · Armor · Instrument · Tool · Trap component · Weapon |
| Material tokens |
| Material type · Material definition · Inorganic material definition |
When making a mod, there's a lot of things that can go wrong. Here's a bunch of common pitfalls that people might fall into.
Errorlog
The errorlog is in a file called "errorlog.txt", living in the same folder as Dwarf Fortress's executable. Check that before you read on; your problem may in fact be in there.
My mod won't load
Make sure you have an info.txt file and that your mod is in the base of the mods folder, not in the mod_upload folder. Dwarf Fortress doesn't read that folder for using mods, only to publish them to the steam workshop.
Make sure you have every required token in your info.txt!
Also make sure that the mod has a NUMERIC_VERSION which is an integer, and greater than or equal to EARLIEST_COMPATIBLE_NUMERIC_VERSION. So this is acceptable:
[NUMERIC_VERSION:1]
[EARLIEST_COMPATIBLE_NUMERIC_VERSION:1]
But this isn't:
[NUMERIC_VERSION:1.05]
[EARLIEST_COMPATIBLE_NUMERIC_VERSION:1.0]
Nor is this:
[NUMERIC_VERSION:1]
[EARLIEST_COMPATIBLE_NUMERIC_VERSION:5005]
My mod loads, but my creature/plant/entity won't
Make sure the file contains all of the following:
- A filename that refers to the type of objects contained therein. Creature files must start with creature_, entity files must start with entity_, and so on.
- The filename on the first line of the file.
- [OBJECT:type], where "type" is replaced with the relevant object type, [OBJECT:CREATURE] etc
If it does have all those, ask in one of the many places there are where one may get help.
Creatures
My civilization lives in "Nothing hamlets", "Nothing fortresses" or similar
You forgot to add a NAME. These use NAME rather than CASTE_NAME, so if you have a CASTE_NAME but no NAME, you'll see the individuals having a correct species name but their sites not having one.