v50 Steam/Premium information for editors
  • 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.
This notice may be cached—the current version can be found here.

Difference between revisions of "Modding pitfalls"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
m (→‎Errorlog: (nitpicking) substituted a descriptive word with more specific terminology.)
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 ''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 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

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.


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:

  1. 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.
  2. The filename on the first line of the file.
  3. [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.