- 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.
Difference between revisions of "Modding pitfalls"
Alpacalypse (talk | contribs) m (→Errorlog: (nitpicking) substituted a descriptive word with more specific terminology.) |
Alpacalypse (talk | contribs) m (→My mod won't load: clarified terminology/explanation to (hopefully) be cleaerer to total beginners.) |
||
| Line 9: | Line 9: | ||
== My mod won't load == | == My mod won't load == | ||
| − | Make sure you have an [[info.txt file]] and that your mod is in the '' | + | Make sure you have an [[info.txt file]] and that your mod is in the ''root'' of the mods folder (Dwarf Fortress/mods), ''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 [[Mod info token#Tokens|required token in your info.txt!]]''' | Make sure you have '''every [[Mod info token#Tokens|required token in your info.txt!]]''' | ||
Revision as of 21:42, 11 February 2023
v50.14 · 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 · Value · 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", located in the root directory of the game (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 root of the mods folder (Dwarf Fortress/mods), 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.
Reactions
My custom armor/clothing reaction won't let user choose size
Currently only the internal make armor/clothing tasks can set the product size via the Details screen; custom reactions cannot do this. If you want to be able to size things when ordering them to be made, they have to be included in the entity using the ARMOR token. The size selection menu only displays if armor/clothing made from cloth, leather, or weapons-grade metal is being produced.