Dwarf Fortress Wiki - User contributions [en]

v0.31:Dwarven atom smasher

2010-12-28T16:05:54Z

Kadath:

{{quality|Exceptional|11:34, 2 October 2010 (UTC)}}{{av}}
[[Image:DwarfSMASH.PNG|thumb|An atom smasher. Take care so there are no dwarves underneath when you trigger the bridge.]]

The '''Dwarven Atom Smasher''' is a euphemism for a {{L|Drawbridge}} in waste disposal or militarily-significant applications. It {{L|exploit}}s the implementation of drawbridges to utterly destroy any objects and most creatures in its target area. Implementation of bridges appears to have changed significantly since earlier versions -- Dwarven atom smashers are now functional only in a small subset of their previous roles. A DAS still works fine as a trash compactor to smash boulders, items, and fluids straight into oblivion.

== Smashing against the floor ==
In this design, a drawbridge is built to come down on at least one tile of solid floor. The drawbridge is raised, the targets are placed (or move of their own volition) into position on that floor, and then the drawbridge is lowered, erasing the targets from existence. Most commonly, a garbage dump {{L|activity zone}} is used in order to place items beneath the drawbridge (as stockpiles cannot be placed on top of existing buildings), but other methods such as flowing {{L|water}} have been used with varying degrees of success.

Sand or dye in bags doesn't get erased while the bag does, creating a small pile of sand or dye on the ground.

== Smashing upon closing ==
In this design, a very compact drawbridge (as little as one tile long) is used, and the target area is the one-tile wide anchoring area, where the bridge will close. This often uses walls, locked doors, or other solid objects, leaving the targets nowhere to go. The drawbridge is lowered, the targets are placed (or move of their own volition) into position on the tile(s) that the drawbridge will occupy when closing, and then the drawbridge is raised, squashing the targets flat.

== Immune creatures ==
The performance of a DAS on creatures is a bit of a drawback. It's well known that special creatures with a certain size (Elephants, Bronze Collosi) will make it impossible to raise a drawbridge they are standing on as well as cause a drawbridge to immediately deconstruct if lowered upon the creature; however, it also appears to be true that groups of lesser creatures which are individually subject to atomizing death may be similarly immune to the DAS when in sizeable groups.

[[Category:Game mechanics]]

File:DwarfSMASH.PNG

2010-12-28T15:58:33Z

Kadath: Suicidal dwarf falling asleep on the atom-smasher.

Suicidal dwarf falling asleep on the atom-smasher.

v0.31:Tunnel

2010-12-25T23:01:31Z

Kadath:

{{av}}{{Quality|Fine}}

[[Image:DF tunnel.png|thumb|An underground capped tunnel, created during world gen]]
A '''tunnel''' is a goblin or dwarf-made construction that connects sites together, much like a [[road]] but underground.
When embarked on in fortress mode they are capped at the map edge, preventing any visitors from using them.

{{World}}

[[Category:World]]

File:DF tunnel.png

2010-12-25T22:46:32Z

Kadath: A tunnel in 0.31.18

A tunnel in 0.31.18

File talk:Regicide.PNG

2010-08-08T23:20:37Z

Kadath:

Question, did the sheriff pick up the crown and wear it? [[User:Kungasi|Kungasi]] 15:04, 28 July 2010 (UTC)

Sadly no, only thing he did was leave a puke on the floor due to cave adaptation, and return back inside :) --[[User:Kadath|Kadath]] 23:20, 8 August 2010 (UTC)

v0.31:Gem setter

2010-07-24T20:47:13Z

Kadath:

{{Quality|Exceptional|00:33, 12 June 2010 (UTC)}}
{{Skill
| color = 2:1
| skill = Gem Setter
| profession = {{L|Jeweler}}
| job name = Gem Setting
| tasks =
* Encrust ammo with ''gem name''
* Encrust finished goods with ''gem name''
* Encrust furniture with ''gem name''
| workshop = {{L|Jeweler's workshop}}}}
{{av}}

'''Gem setter''' is the skill associated with the '''gem setting''' {{L|labor}}. Gem setters {{L|decoration|encrust}} {{L|furniture}}, {{L|Finished goods|finished goods}} and {{L|ammo}} with cut {{L|gem}}s. It is not currently possible to decorate {{L|weapons}} and {{L|armor}}, unless the armor is made of {{L|cloth}}. A high level of gem setting allows a dwarf to set gems faster and with better quality, making the decorated items more valuable.

Rough gems, which are found by {{L|Miner|miners}}, have to be converted to cut gems by a {{L|gem cutter}} before a gem setter can use them. Large gems, which are sometimes created instead of a cut gems, can not be used for setting as they are finished goods.

Because there is a very wide variety of gems in most regions and some types of gems have pretty high {{L|material value}}, adding decorations of different types of gems is a good way to create items with very high value for {{L|trade}} or {{L|nobles}}.

===Training gem setters for maximizing value gain===
To get the most value out of the gems you find, it is recommended to use up the cheapest gems first (agates, chalcedonies, jaspers etc.) to train your gem setter and leave the more valuable ones (tourmalines, zircons, opals etc.) until he or she reaches a high skill level. The most valuable gems (emeralds, rubies, diamonds, sapphires) should only belong into the hands of a legendary gem setter.

Rough {{L|green glass}} is also a rough gem, so if you have a {{L|sand}} layer on your map it can be produced by yourself from regenerative resources ({{L|charcoal}}) in a regular {{L|glass furnace}} and even from nothing when you are the proud owner of a {{L|magma glass furnace}}. Thus, letting your gem setter encrust everything he gets his hands on with cut green glass is a great way to train him without wasting any of the limited natural-occurring gems.

In order to avoid diluting experience, you should only train a single gem setter (not including successful {{L|strange mood}}s), as you will likely not find enough gems for more than one anyway unless you have an army of miners strip-mining the whole map.

{{Skills}}

v0.31:Utilities

2010-05-24T01:55:04Z

Kadath: new version compitability for reveal.exe

{{AV}}
{{Quality|Exceptional}}
Please only list utilities that are known to work with the newest version here.

Here are third party applications useful for Dwarf Fortress.
__TOC__
== [http://dffd.wimbli.com/ Dwarf Fortress File Depot] ==
The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of [[User:Janus|Janus]]; for files related to Dwarf Fortress only.

== 3D Visualizers ==

=== [[Utility:Stonesense|Stonesense]] ===
[[File:stonesense.jpg|208px|thumb|right|Stonesense Screenshot]]
''by Jonask, Solifuge, Kaypy and Japa''

Stonesense is a third party real-time visualizer that lets you view your Dwarf Fortress world in a classic isometric perspective.

More information is available in [http://www.bay12games.com/forum/index.php?topic=43260.0 this forum thread].

Stonesense Slate now supports v0.31.04 - [http://stonesense.googlecode.com/files/Stonesense_Slate_RC1.rar get it here]

== [http://dffd.wimbli.com/file.php?id=645 Reveal] ==

Reveal (or Reveal.exe as it is commonly referred to) is a program that runs alongside Dwarf Fortress and shows all "unexplored" or "undug" tiles of the map (in fortress mode). To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal (Not required in the latest version using the parameters below, simply start the .exe file.). Playing on revealed map might ''(read "will")'' cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, and a lot more). '''Using Reveal has been known to corrupt saved game folders.''' and, as such, it is highly recommended to only use Reveal to preview a biome's layout and then restart without running Reveal.

There are two versions of Reveal, one for Vista and newer, one for XP and older.

The new version of Reveal.exe (Reveal2) is in public beta, you can find it here [http://dffd.wimbli.com/file.php?id=1044 Reveal2]. Please report problems in [[User_talk:0x517A5D|0x517A5D's Talk page]].

Pasting the following code into reveal2.ini makes it work for the newest (DF2010) version of Dwarf Fortress:

<pre>
;; DF2010 31.02
[4BBDF378]
map_data=0x016ad718
map_x_count=0x016ad738
map_y_count=0x016ad73c
map_z_count=0x016ad740
</pre>
[4BB45F99] can be substituted in for 31.01.

For 31.04, the following works:
<pre>
; .31.04
[4BF014FA]
dwarf_fortress=0x00A551C0
map_data=0x016BAAC4
map_x_count=0x016BAAE4
map_y_count=0x016BAAE8
map_z_count=0x016BAAEC
map_data_designation_offset=0x29C
</pre>

However, do '''not''' save your game, it can mess up many things including civilizations (Giant Toad and Cave Crocodile civilizations, you will also embark with those if it should occur.)

==[http://www.bay12games.com/forum/index.php?topic=39229 Dwarf Therapist]==

Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments (40d), statistics (such as attributes, personality traits and happiness), plus sort dwarves by various criteria (eg. profession, migration wave etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 5.1 is out (4/24/10). This version supports DF build 3.01.03.

New dedicated support forum: http://code.google.com/p/dwarftherapist/

==[http://www.bay12games.com/forum/index.php?topic=50643.0 Dfterm]==

Dfterm is a tool to run dwarf fortress via terminals remotely. multiple people can connect and watch or join in.

Main article here: [[Dfterm]].

== [http://www.bay12games.com/forum/index.php?topic=41916.0 DFHack] ==

DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.3.1.4) release only supports the new DF 0.31.01, 0.31.02 and 0.31.03 versions. It consists of some of the more useful DFHack tools.

Code and binary releases are available from the [http://github.com/peterix/dfhack/downloads Github site].

=== DFhack tools for DF 2010 ===
==== dfcleanmap ====
Cleans all the bloodsmears that get scattered all over the map.
==== dfliquids ====
Allows creating liquids (water and magma), making them flow or preventing them from flowing. Newly also allows making obsidian walls. It's a command-prompt style utility where you type in very simple commands. Replaces the older magma_create tool.

==== dfprospector ====
Lists all available minerals on the map and how much of them there is.
==== dfreveal ====
Reveals the whole map. Newly can also hide what it revealed. Use with caution, releases [[HFS]]! Same warnings as to the original Reveal tool apply.

==== dfvdig ====
Designates a whole vein for digging. When using the '-x' option, it will dig stairs into other z-levels. Point the cursor at a vein and run this thing :)

== DF Map Compressor / DF Map Archive ==

*[http://shadowlord13.googlepages.com/dfmap-index.html SL's DF Map Compressor - Website]
*[http://mkv25.net/dfma/ Dwarf Fortress Map Archive]

The DF Map Compressor encodes multiple bitmaps exported from Dwarf Fortress into a single, very compressed, .fdf-map file. The fdf-map file can then be shared with your friends by uploading to the DF Map Archive that features an online viewer (written in Flash).

The map compressor was created by Shadowlord in May 2007. Extract from the website :
:"The '''DF Map Compressor''' is a program I made to encode Dwarf Fortress fortress or world map images into a much smaller format than is possible with normal image formats. Here's a quick summary of how it works: It determines the size of your tiles from your DF font file (or asks you), splits the map up into tiles, identifies duplicate tiles, writes out every unique tile image, and then writes out a list of ID#s for each tile position which points to the tile image for that tile. What it outputs is piped through the LZMA compressor (the one used in 7-zip), to compress it further. The .df-map file which it writes out is usually less than 100 KB in size. (By comparison, a PNG of the same map can exceed 2 megabytes, depending on how well you compress it, whether you change the color depth, and whether you are using a graphical tileset or detailed font)."

Read more about the [[User:Markavian/DF_Map_Archive|DF Map Archive]] on Markavian's User page.

== [[User:Soundandfury/DF_Designer|DF Designer]] ==
DF Designer, by [[User:Soundandfury|soundnfury]] is a fort layout planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and both Linux and Windows builds are available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

== Modding tools ==
=== [http://dffd.wimbli.com/file.php?id=2068 Custom Workshop Workshop] ===
WYSIWYG editor for designing the raws for a custom workshop.
(Not all raws, just the tiles and colors) Lets you see how it will look at each stage of construction. Comes with the default 16x16 CURSES font built in, but you can load any .BMP formatted DF font you like, keeping in mind that if its bigger than 16x16 it won't fit.

Accommodates up to 32x32 workshops, not that there's any reason for such a large workshop, right?

== Raw tile tools ==
=== [http://dffd.wimbli.com/file.php?id=2113 Raw tile selector] ===
Provides an easy to use graphical interface to select which tiles and colors should be displayed for plants, stones and small creatures.

Made to ease the job of creators of tilesets with edited raws. It will also be useful for users that dislike decisions made by tileset creators or users that could not find the edited raws for a tileset.

Currently for windows only.

=== [http://dffd.wimbli.com/file.php?id=2178 Raw tile merger] ===
Provides an easy to use interface to change the tile and color data of raws to match the data of another set of raw files.

Made to ease the job of creators of tilesets with edited raws when new versions of df are released. The edited raws for your tileset for a new df version can now be created with a few clicks.

== [http://winmerge.org/ WinMerge] ==
Winmerge allows you to compare the contents of folders or files. It highlights any differences between files and allows you to merge them. It is most useful for modders or users of mods. If you compare modified raw files with unmodified ones you can quickly see any differences.

User talk:Markavian

2010-05-17T18:08:06Z

Kadath:

I just wanted to thank you for the excellent 12x12 tileset, keep being awesome.
--[[User:Kadath|Kadath]] 18:08, 17 May 2010 (UTC)

On [[Sky]], what is the source for the quote? --[[User:Geofferic|Geofferic]] 01:48, 9 December 2007 (EST)
: It's an IC quote that I made up using the name of one of my dwarven miners from the fortress of [[User:Markavian/Axegear|Axegear]]. --[[User:Markavian|Markavian]]

<s>Are you sure about [[charcoal]] for [[pig iron]]? I remember reading contrary to that on the forums. I think charcoal doesnt count as coal bars. [[User:VengefulDonut|VengefulDonut]] 11:45, 18 December 2007 (EST)</s> [[User:VengefulDonut|VengefulDonut]] 12:50, 18 December 2007 (EST)

Template:Sg/caption

2009-11-07T23:01:54Z

Kadath:

{{choose|c={{{1|default}}}|default=No caption? Add one!
|1=Preparing a ballista.
|2=A well-placed door holds back disaster...
|3=Belal's 16x16 tileset
|4=Use utilities like 3Dwarf to render your fortresses
|5=Communal living: who needs walls?
|6=The burdens of being mayor are great, you barely get enough time for arena combat with a bunch of goblins every now and then. And then its back to conducting meetings.
|7=The dwarves hang around in the ale storage area to get some alone time with their alchohol.
|8=A baby crawling through the aftermath of a human siege at Ringfissures
|9=The dwarves have found a way to paint thier walls. It's a shame they ran out of paint when they were half-way done.
|10=With friends like these...
|11=Some fish are better left alone.
|12=No matter what your orders may be, your dwarves know the real matters of importance.
|13=Maybe Little Miss Muffet was a dwarf?
|14=All the comforts of home.
|15=Fires are very dangerous, and dwarves are not cautious. Ensure your dwarves stay away.
|16=GODS DANGIT MELBUL AND YOUR WATERFALLS!
|17=Ah... the great outdoors.
|18=You heard the man, Gimli. Your cot's in the barracks.
|19=A colossus makes short work of captured goblins in an arena.
|20=Is that a euphemism?
|21=Pain and hardship starts at a young age in dwarven culture.
|22=The vanity of dwarven engravers is not to be underestimated.
|23=Goblins have a very fickle relationship with their body parts. A skilled Axedwarf can quickly have them calling for a divorce.
|24=The King is dead. Long live the King!
}}

Template:Sg/caption

2009-11-07T23:01:23Z

Kadath:

File:Regicide.PNG

2009-11-07T22:53:41Z

Kadath: The Goblin king - when killed by my sheriff, he dropped his crown (and some other junk, but the crown's on top), and flew a bit, leaving a trail of blood behind him.

The Goblin king - when killed by my sheriff, he dropped his crown (and some other junk, but the crown's on top), and flew a bit, leaving a trail of blood behind him.

40d:Exploit

2009-06-18T00:27:40Z

Kadath:

An '''exploit''' is a quirk of a game that allows players to gain what other players may consider an unfair advantage, usually by making use of a feature that is not working properly or which defies logic. 'Exploiting the game' is distinct from '[[cheating]]' because exploits occur within the game as written and do not need any external [[utilities]] or [[modding]]. Whether a player chooses to make use of an exploit or not depends on their personal taste; given that [[Dwarf Fortress]] is a single-player game, the user alone can decide what liberties to take and what options to shun.

Some exploits are listed below.

== Self-powered pumps ==

It is possible to produce a perpetual motion water pump where the act of pumping actually powers itself! See [[screw pump]] and [[water wheel]] for details.

== Atom Smasher ==

A [[drawbridge]], when rapidly triggered on and off, can be used to obliterate any creature or item beneath it. Nothing short of a [[demon]] or [[megabeast]] is capable of withstanding a drawbridge crush.

== Trap fields ==
Laying a field of [[trap]]s with a significant-enough depth can protect your fortress from all invaders with no need to maintain a [[military]]. Traps are somehow intelligent enough to distinguish between [[pet]]s and allies while being dangerous to enemies and wild animals.

Many players do not consider this an exploit.

== Parents are back, party over! ==
A party can be stopped right away by {{K|f}}reeing (removing) the room the party is taking place in. The room can be recreated the same instance. Similarly, in times of high activity (e.g. mass dumping, trading; hauling) removing all rooms parties can take place in, prevents them. Since parties also have benefits this is not necessarily an exploit.

== Get back to work! ==
When a dwarf is "On [[Break]]", it is possible to draft this civilian into the military and then undraft her in order to get her to cancel the break. This does give an unhappy [[thought]] (but only if the dwarf has no military and/or civilian skills), so it is not a significant exploit and some may consider it a perfectly acceptable gameplay method.

== Frère Jacques ==
Need a [[sleep]]ing dwarf to do some work? Kick him out of bed by deconstructing it. This causes an unhappy thought.

== Quantum stockpiles ==
By designating a garbage pit [[zone]] instead of a [[stockpile]], you may store an infinite number of objects in a single tile by dumping them, then reclaiming them when you want to use them.

A similar effect may be achieved by building a wall two tiles in front of a catapult and digging a channel between the wall and catapult. By firing the catapult at the wall, the stone falls into the trench. The stone will pile up in the channel, putting it out of sight and out of mind. Not only does this train [[siege operator]]s, but it clears the stone that your legendary [[miner]]s leave.

Another way to quantum stockpile is to not have appropriate stockpiles to move items back you moved to the trading depot. The depot can hold an arbitrary number of items, and those items will not be removed if there is nowhere else to place them. This is also useful for anything you want to trade anyway.

== Cooking alcohol ==

[[Alcohol]] can be cooked without requiring many other ingredients, producing solid food that is eaten and not imbibed. Doing so is a highly efficient means of producing food, as each plant produces five units of alcohol.

Though some consider it an exploit, many people make use of this feature. It will eventually be plugged with [http://www.bay12games.com/dwarves/dev_req_101-150.html Req129]:
<blockquote>Req129, IMPROVE COOKING, (Future): More food. Food should require a substrate, rather than just being seeds etc. Seeds, syrups, drinks and other such objects can contribute to the likes/dislike checks as they do now, but they shouldn't add to the number created. A good roll could lead to the recipe being given a name and saved to the entity definition, where it can then be encountered in other cities in subsequent games.</blockquote>

==Bling Bolts==

Adding a [[decoration]] to a stack of [[bolt]]s causes a huge [[value]] increase. The value of the decoration is multiplied by the number of bolts in the stack. This is considered a [[bug]].

==Bookkeeper Exercise Program==
Changing your [[bookkeeper]]'s settings to maximum accuracy causes him to work furiously in his office, training quickly up to [[legendary]]. Even if this is a bug it is not really an exploit, since a) you actually want highest precision anyway b) he attains highest precision rather fast (depending, for example, on how many stones you have mined) and thus one can not train an unlimited number of, if even several, dwarves that way.

==Manager Exercise Program==

As a [[Manager]], skill is gained as tasks are approved, not completed. Simply by queueing lots of jobs ({{key|j}} {{key|m}} {{key|q}}), the manager will quickly level to [[legendary]]. The tasks can then be removed once approved.

==Nudist Fortress==

Dwarves get a bad [[thought]] from having [[clothing]] [[wear]] out, but nothing happens if they can't find replacement clothes. As long as you don't make new clothes, they will happily go naked. This also avoids the problem of messy dwarves leaving clothing strewn around the fortress.

==Recycling Archery Range==

In an [[archery range]], [[bolt]]s that hit the target are are always destroyed, but bolts that miss can be saved. Build a [[channel]] between the [[archery target]] and the back wall of the range, and [[stairs]] to get into it. Amazingly, the bolts will no longer shatter on impact with the wall, but fall intact into the channel. Reclaim the bolts, and your dwarves will re-use them for target practice. This exploit has the unfortunate side effect of splitting up [[stack]]s of bolts, so your dwarves will make a separate trip for each individual bolt.

This trick will work for a [[ballista]] as well. Be careful for friendly fire.

==Merchant Swindles==

There are a variety of ways to cheat [[merchant]]s out of their cargo without seizing it. Tearing down the [[trade depot]] while the merchants are there is the easiest way.

Also, marking items for [[dump]]ing, using view creature mode ({{key|v}}), the stocks menu ({{key|z}}), or items in room mode ({{key|t}}), lets you relieve merchants of their goods. Just reclaim the items from your garbage dump [[zone]] later. You can even take clothing and equipment off merchant and guards this way.

The merchants will still leave disappointed if they have less value in goods when they leave the map than when they entered {{verify}}.

== The Castle of Ice in the Lake of Fire ==

[[Construction]]s are indestructible, regardless of material, and walls of wood and ice easily stand up to [[magma]]. Entire fortresses can be built of ice in temperate climates equally impervious to catapults, the summer sun, or a thousand tons of boiling lava.

On a similar note, all buildings and furniture are equally strong - indestructible to most creatures, tissue paper to others. Witness a single troll bashing through a multilayered set of [[adamantine]] and [[steel]] doors, while an army of Elite Hammergoblins are stymied by a single [[glass]] [[portal]].

== Miasma can't move diagonally ==
[[Miasma]] can only move horizontally and vertically. This means that if your refuse stockpile is only accessible on a diagonal, there is no way for the miasma to escape. This is more effective than the use of doors or even pairs of doors in an "airlock" setup, as doors can be stuck open if a creature or material is occupying their square. The same method can be used to create enclosures to prevent the spread of miasma from kitchens, tanneries, and butcher shops.

== Extremely Intricate Artifacts ==

When a moody dwarf sets out to fetch some material he's craving, forbid all the other items he has gathered so far. The dwarf will set out to find a replacement for the forbidden item(s). When he returns, forbid the new one, and so on. After a while you should have a large stockpile of stuff on the moody dwarfs workshop. Now, unforbid everything. Since dwarves use what is available on the tile they are standing on for the artifact they are working on, the artifact will contain all the items you forbid previously, netting you an artifact with potentially pages of decorations.

40d:Modding guide

2009-02-23T15:50:48Z

Kadath: [BONECARN] makes the game difficult; made it optional.

This is intended to be an easy guide for general newbies on how to both edit and add civilizations, creatures, objects, and so on in Dwarf Fortress, both [[Adventure_Mode|adventurer]] and [[Dwarf_Fortress_Mode|fortress]] modes, without breaking anything too much. Generally breaking stuff is fine! Just always back up your work + the originals, and be patient at having to [[World_Generation|generate new worlds]] over and over.

This guide was edited for version 0.27.176.39c and may not be accurate for later versions, particularly the examples.

= Modding Guide =

== Basics of DF modding ==

All of the data you can edit are stored in the \raw\ folder wherever you saved your DF executable. The raw folder contains two subfolders: graphics (where you insert [[Object_Tilesets|graphic packs]] to make custom tiles), and objects, which contains all the data for generally everything in the game that is not hardcoded. Quite a lot is not hardcoded, so you can edit a wide variety of things in the game.

Editing the [[Raw file|raw text files]] is easy and simple. When you go into the \raw\objects folder you will see a wide variety of text files. When you are modding your game, you can either change existing files or add your own. I personally find it easier just to edit the existing ones in a new \DF\ game folder. When you are changing a token you can simply change the values - these are the numbers/strings after the : in a token entry. For example, [CREATURE:DWARF] is a token in the entity text file, which determines what creatures are used for dwarven civilizations. Simply open the text file, edit what you want, save and close, and generate a new world after you're done editing what you want.

Essentially, everything that can be modded uses text files to determine how they interact with the world or with other objects. With a bit of know-how you can tinker with just about everything.

Every text file uses what are called "tokens", also called "flags". They are essentially attributes that you can add or remove or edit for any particular object in the game, that change the way the object works or acts. Most of the actual effects are hardcoded: for example, giving a creature such as a moose the [EVIL] creature token will make it only appear in evil maps, or giving it [BONECARN] will make it chow down on bones.

A few key things to remember when modding the text files:

* Always back up the default text files you plan on editing. This way, if your game crashes (due to say, a typo that you can't find) you can simply copy-paste it back in for a 'vanilla' DF.
* You do not need to delete old saves; simply create a new world using your modded files and things should run just fine. Just don't try to play a "non-modded" world with modded files! Should you desire to go back to your old sites, just make sure you revert to the raw files used for the creation of that world.
* In general it's better to make whole new text files for new stuff you're adding rather than editing the existing ones by tagging them onto the bottom. This allows you to keep track of them easier and keeps them all in one place so there's less messing about with tons of files.
* The absolute easiest way to add an entirely new creature/entity/etc is to simply copy-paste an existing one and rename it, then edit the various tokens appropriately.

In addition, if you ''rename'' the any of the \raw\ files themselves (such as 'creature_insects.txt' to 'creature_bugs.txt'), you must find the same filename in the \data\objects\ folder and delete it. This is required because once the world is generated it creates the new files and saves them for use next time the world is needed; without deleting the file you will get duplication errors. This is not necessary if you just don't change any of the filenames.

== Modding the civilizations ==

The civilization entries are stored in entity_default.txt. They are quite simple files that are in the following format:

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

At the top of the file you'll see an 'entity_default' all by itself, that must be at the top of the file only. All game files require those markers at the top. If you're creating a new civilization in its own text file, be sure to add entity_default, and [OBJECT:ENTITY] at the top of the file.

Now what do these tokens mean, exactly? For one, where the tags are located don't generally matter quite a lot. You can add them in any order as long as they're underneath the "[ENTITY:]" token, which is the 'header' of the civilization and lets the game know that everything underneath deals with that civ. The entity token can be anything as long as it's not the same as another one.

'[CREATURE:]' links the civilization with a certain creature defined in a different file. This is the creature you play in adventurer or fortress mode, or that wanders around their towns when you explore them. For example, if you wanted to do something silly you could switch the "DWARF" entry in entity_default.txt with "ELF" and you would be marching elves around in fortress mode, though they would still use dwarven technology and language and names and so forth.

'[TRANSLATION:]' connects the civ to a specific language file that determines things like their natural (untranslated) creature first + last names and city names. The valid ones are HUMAN, DWARF, ELF, and GOBLIN.

'[BIOME_SUPPORT:]' defines biomes that civs will appear in. The 'FREQUENCY' value determines the likelyhood of them appearing there: generally 1 for not very often, up to 3 for very often (ie. dwarves in mountains).

You can find many details about the rest of the civilization tokens [[Entity_Tokens|here]]. The important ones are the CIV_CONTROLLABLE token, which lets you control the civ in dwarf fortress mode and the INDIV_CONTROLLABLE and ADVENTURE_TIER tokens which lets you play the civ in adventure mode via the PLAY NOW! command. Remember that ADVENTURE_TIER must be in order, so if you are adding a new playable race you must put it above dwarves and set its tier 1 higher (4).

If you have more than one civ with the [CIV_CONTROLLABLE] token, groups belonging to that civ will appear in the group selection section on the embark screen, although it is not immediately obvious what species each group may be. While this can be determined from legends mode, experimentation suggests that the topmost species in the 'neighbors' section of the embark screen is the same as the currently selected species: If your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a group (and therefore a species if there is more than one) at random.

Any token that has to deal with weapons, armor, clothing, etc. are all the items that the civ can build, not necessarily the ones they can wear. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

[SELECT_SYMBOL:] and [CULL_SYMBOL:ALL:] are the words that can be randomly generated in names, civs, cities, artifacts, engravings, etc. "SELECT_SYMBOL" means that the civ is far more likely to use those, and CULL_SYMBOL means they never will. You can find a list of every symbol type [[Language|here]]. SUBSELECT_SYMBOL:WAR/BATTLE/SIEGE just determines which language token to use when they begin wars, battles, or sieges in legends mode, ie. 'The Conflict of Craziness' or 'The Siege of Assaults'. All have these as 'violence' by default but they can be changed to any other token.

'SELECT:SYMBOL:ROAD/TUNNEL/BRIDGE/WALL' use the special language tokens NAME_ROAD, NAME_TUNNEL, etc. and determines what the civ names their structures. 'SELECT_SYMBOL:REMAINING': are the standard tokens used for the species language.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's ENTITY: name! This name can be anything as long as it's not already existing.

There are many tokens to play with in the entity file, most of which do something interesting. It's best to simply look through the entity tokens list and figure out for yourself what you want to do with them. The ones of interest are:

* [SIEGER] [BABYSNATCHER] [NUISANCE] These determine what the civ does in relation to other civs. Babysnatchers periodically swipe infants from nearby civs and have them grow up in their own civ (if kidnapped/brainwashed infants grow up and have children, their last names will use their capturer's language files: ie. you will have evil dwarves with the name Urist Deathghouls in a goblin fortress).

* [AT_PEACE_WITH_WILDLIFE] This token, currently set only on elves, will mean they will not attack wild animals and animals will not attack them. This ALSO means that if you bring an elf or two along with you in adventurer mode, don't expect them to help you if you get attacked by cougars!

* [RELIGION_SPHERE] This determines what religious deities will have as spheres when the civilization is generated, along with their subspheres. With a SPHERE_ALIGNMENT set you can also make one more likely than others; ie. Elves have trees, plants, and animals set very high so they are likely to get those more often with their deities.

* With [DEFAULT_SITE], LIKES_, and TOLERATES_ you can decide where the species will live. DEFAULT_SITE is their home cities and will usually cluster there in large groups. If a civ conquers another and they do not at least tolerate the enemy's home type they will simply destroy it instead of moving in (sometimes they will destroy it anyway).

* [ETHIC:] tokens determine how the species behaves when it comes to certain unpleasant acts. This also determines what reasons the civ will use when going to war: if a nearby civ has something set ACCEPTABLE that they consider UNTHINKABLE, then it is likely they will go to war over it. It also determines a few other things, like what happens to dead foes: Elves have '[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]' for example. Goblins defacing their enemies (ie. hanging, stuck on pikes) is [ABUSE_BODIES], as well as ETHIC:MAKE_TROPHY_ tokens set ACCEPTABLE.

== Modding the creatures ==

Creature modding is great fun. Essentially you can change nearly any aspect of a creature or completely make your own from scratch. You can either add a new creature to the bottom of an existing creature_thing.txt file or make your own file; just be sure to add the name of the file (without the txt) to the top of it. For example, I tend to use a 'creature_newbies.txt' file myself.

Modding creatures is exactly similar to modding civs: just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all the information about each specific creature in the game, from animals to dwarves to goblins to even caravan wagons. Much of the data of a creature is quite self-explanatory; you can find a list of every creature token [[Creature_Tokens|here]].

There're some tokens which use temperature values. Dwarf Fortress has it's own temperature scale for this. [[Temperature scale|DF temperature scale]].

Note: If you add a butcherable creature to the game such as a domestic animal, people will automatically wander around wearing its fur or skin as leather items when you are in the game, assuming the creature comes from the civ's biome (natural area). So don't be surprised to see 'duck leather armor' or something if you add ducks. Also note if you add a species that has a naturally high body temperature (magma snakes for example) and set it butcherable, people will automatically be generated wearing their skins.. and then since the skins have a naturally high temperature too they tend to burst into flame immediately because they were wearing a +magma snake leather sock+. Woops.

You'll notice many of the creature entries have tokens that other ones don't have. If a token is not present it's considered "default", though sometimes the default can be hard to figure out. All of the creatures referenced in the entity files are present in creature_standard.txt and require certain other tokens that non-entity creatures do not need, such as [INTELLIGENT] and [CANOPENDOORS].

For example, if you wanted to allow your dwarves to eat bones from the refuse stockpile (ew), you would open up creature_standard.txt, add [BONECARN] somewhere in the CREATURE_DWARF: entry at the top, and then save and close it, then generate a new world. Bon appetit!

[http://www.dwarffortresswiki.net/index.php/User:Deon#How_to How to add a new creature.]

== Modding items ==

Items come in several flavors: 'crafted' items, and 'natural' items. Both are the same in most ways, but are stored in different places: most crafted item data are stored in the item_blah.txt files (such as item_armor.txt), while things like plants, gems, food, and ore are stored in "matgloss" files, ie. matgloss_plant.txt. Both are easily editable just like a creature or civ, but the problem is that there is no definitive list of what most of the tokens for these quite do yet. In any case they are usually pretty self-explanatory and you can guess what they do by checking out similar entries.

For example, let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[WEIGHT:10]
[VALUE:10]
[BLOCKPOWER:5]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]

Most of these are pretty obvious if one compares them to the other entries. Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere, and probably [HARD] instead of [SOFT]. Simple!

Weapons work largely the same way; but remember that in order to actually use any of these things you'd have to add the ITEM_THING item flag to the civilization's 'useable items' list in entity_default.txt. For example, if you're fond of Scots and decided to make a 'claymore' sword that's even bigger than the two-hander already in the files. It might look like this:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_CLAYMORE]
[NAME:claymore sword:claymore swords]
[DAMAGE:160:SLASH]
[WEIGHT:120]
[SKILL:SWORD]
[CRIT_BOOST:1]
[TWO_HANDED:0]
[MINIMUM_SIZE:7]
[MATERIAL_SIZE:5]

Tada! Yes, it's that easy. Then you just add it to the civ entry so a civilization can actually use and craft it, and it's done.

== Modding language files ==

Let's say you added a whole new species. Sure, you could just swipe one of the existing translation files and steal their language for your species, but that's the lazy way! If you want to create a whole new language, it's very simple.

First, you'd need a whole new language_RACE file, such as language_LIZARDMAN.txt, along with "language_LIZARDMAN" at the top of the file proceeded by [OBJECT:LANGUAGE] and [TRANSLATION:LIZARDMAN]. After that, it's just a matter of copy-pasting one of the existing language lists and editing the finished 'translated' word. That's it! Then just add the translation link to your civ in entity_default.txt and it'll be added to the game on worldgen.

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All body definitions are located in body_default.txt and then linked to a creature in the creature's entry. For example, the dwarf creature has: [BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:THROAT:NECK:SPINE:BRAIN:5FINGERS:5TOES:MOUTH]. All of these are seperate bodypart definitions in body_default.txt. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created. This means that if you don't add the appropriate bodyparts, hilarious things can happen: if you forget to add a throat or lungs your new creature will suffocate after taking a few steps (unless you make it a nonbreather).

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the very simple format:

[BODY:BODYNAME]
[BP:ID:name][TOKENSGOHERE]

You can add as many sub-parts as you want to an overall section. The most important tokens are 'CONTYPE' and 'CON': CONTYPE means the bodypart in question is connected to a certain *type* of bodypart, while CON means it's connected to a *specific* one. Let's break down a few entries:

[BODY:BASIC_HEAD]
[BP:HD:head][CONTYPE:UPPERBODY][HEAD]

This is a very simple one: a head. It connects directly to an upper body. All the stuff inside the head are seperate entries that call up the head as a different contype in turn:

[BODY:THROAT]
[BP:THROAT:throat][CONTYPE:HEAD][THROAT][EMBEDDED][SMALL]

The foot bone's connected to the ankle bone..

If you wanted someone to be able to break someone else's throat (like breaking a joint) and suffocate them, just add the [JOINT], [BREATHE], and possibly [NERVOUS] to the throat object's tokens.

A 'BODYGLOSS', which you can sometimes find in the creature entries, are simply replacement words for certain defined words in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in the body_default.txt, and then you can use this in a creature with '[BODYGLOSS:CLAW_HAND]' and it will replace all instances of "hand" with "claw" in that creature. For all intent and purpose the body part will still function as the proper part, though.

Note that only creatures with the [EQUIPS] token (and possibly [INTELLIGENT]) and a civ that can create clothes/armor/weapons will be able to actually wear stuff. Also, if the creature size is too large for the clothes they will also not be able to wear it.

== Example one: dark dwarves ==

These examples will go over the details for creating several new things as well as editing some old ones.

Remember: Do NOT load an old save after genning a new world with different raws. It's much safer to simply delete all your old saves after you've modded things, or simply copy-and-paste a fresh version of DF into a new folder.

First, we're going to create a new, evil civilization of dwarves called, unsurprisingly, dark dwarves. This will be quite easy, though with a few fundamental differences. Mainly, that dark dwarves are evil and more warlike than regular dwarves.

Now, open up entity_default.txt. All your species civilizations will be in there. We're going to make a whole new one for our dark dwarves. In many ways it'll be a simple copy-paste job of regular dwarves, then tweaking some things.

Add this to the TOP of the entity_default file, before the dwarf entry:

[ENTITY:DARK_DWARF]
[CIV_CONTROLLABLE]
[CREATURE:DARK_DWARF]
[TRANSLATION:DWARF]
[DIGGER:ITEM_WEAPON_PICK]
[WEAPON:ITEM_WEAPON_AXE_BATTLE]
[WEAPON:ITEM_WEAPON_WHIP]
[WEAPON:ITEM_WEAPON_FLAIL]
[WEAPON:ITEM_WEAPON_SCOURGE]
[WEAPON:ITEM_WEAPON_DAGGER_LARGE]
[WEAPON:ITEM_WEAPON_MACE]
[WEAPON:ITEM_WEAPON_SWORD_SHORT]
[WEAPON:ITEM_WEAPON_SCIMITAR]
[WEAPON:ITEM_WEAPON_CROSSBOW]
[AMMO:ITEM_AMMO_BOLTS]
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]
[ARMOR:ITEM_ARMOR_CHAINMAIL:COMMON]
[ARMOR:ITEM_ARMOR_LEATHER:COMMON]
[ARMOR:ITEM_ARMOR_COAT:COMMON]
[ARMOR:ITEM_ARMOR_SHIRT:COMMON]
[ARMOR:ITEM_ARMOR_CLOAK:COMMON]
[ARMOR:ITEM_ARMOR_TOGA:UNCOMMON]
[ARMOR:ITEM_ARMOR_VEST:COMMON]
[ARMOR:ITEM_ARMOR_DRESS:COMMON]
[ARMOR:ITEM_ARMOR_ROBE:COMMON]
[HELM:ITEM_HELM_HELM:COMMON]
[HELM:ITEM_HELM_HOOD:COMMON]
[GLOVES:ITEM_GLOVES_GAUNTLETS:COMMON]
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]
[SHOES:ITEM_SHOES_SHOES:COMMON]
[SHOES:ITEM_SHOES_BOOTS:COMMON]
[SHOES:ITEM_SHOES_BOOTS_LOW:COMMON]
[PANTS:ITEM_PANTS_PANTS:COMMON]
[PANTS:ITEM_PANTS_GREAVES:COMMON]
[PANTS:ITEM_PANTS_LEGGINGS:COMMON]
[SHIELD:ITEM_SHIELD_SHIELD]
[SHIELD:ITEM_SHIELD_BUCKLER]
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]
[TRAPCOMP:ITEM_TRAPCOMP_ENORMOUSCORKSCREW]
[TRAPCOMP:ITEM_TRAPCOMP_SPIKEDBALL]
[TRAPCOMP:ITEM_TRAPCOMP_LARGESERRATEDDISC]
[TOY:ITEM_TOY_HAMMER]
[TOY:ITEM_TOY_AXE]
[TOY:ITEM_TOY_MINIFORGE]
[INSTRUMENT:ITEM_INSTRUMENT_TRUMPET]
[INSTRUMENT:ITEM_INSTRUMENT_DRUM]
[CLOTHING]
[SUBTERRANEAN_CLOTHING]
[CURRENCY_BY_YEAR]
[CURRENCY:COPPER:1]
[CURRENCY:SILVER:5]
[CURRENCY:GOLD:15]
[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]
[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]
[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[SELECT_SYMBOL:REMAINING:EVIL]
[SELECT_SYMBOL:REMAINING:UNTOWARD]
[SELECT_SYMBOL:REMAINING:UGLY]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:HOLY]
[CULL_SYMBOL:ALL:PEACE]
[CULL_SYMBOL:ALL:NEGATOR]
[CULL_SYMBOL:ALL:GOOD]
[METAL_PREF]
[GEM_PREF]
[STONE_PREF]
[INDOOR_FARMING]
[USE_CAVE_ANIMALS]
[USE_ANIMAL_PRODUCTS]
[USE_EVIL_ANIMALS]
[USE_EVIL_PLANTS]
[USE_EVIL_WOOD]
[COMMON_DOMESTIC_PACK]
[COMMON_DOMESTIC_PULL]
[COMMON_DOMESTIC_MOUNT]
[COMMON_DOMESTIC_PET]
[USE_MISC_PROCESSED_WOOD_PRODUCTS]
[EQUIPMENT_IMPROVEMENTS]
[ART_FACET_MODIFIER:GOOD:0]
[ART_FACET_MODIFIER:EVIL:512]
[ITEM_IMPROVEMENT_MODIFIER:RINGS_HANGING:0]
[ITEM_IMPROVEMENT_MODIFIER:BANDS:0]
[ITEM_IMPROVEMENT_MODIFIER:SPIKES:384]
[ADVENTURE_TIER:4]
[FRIENDLY_COLOR:1:0:1]
[DEFAULT_SITE_TYPE:CAVE_DETAILED]
[LIKES_SITE:CAVE_DETAILED]
[TOLERATES_SITE:CITY]
[TOLERATES_SITE:TREE_CITY]
[TOLERATES_SITE:CAVE_DETAILED]
[TOLERATES_SITE:CAVE]
[LEADER_TYPE:KING]
[SITE_LEADER_TYPE:STANDARD]
[START_BIOME:MOUNTAIN]
[BIOME_SUPPORT:ANY_WETLAND:1]
[BIOME_SUPPORT:ANY_DESERT:1]
[BIOME_SUPPORT:ANY_OCEAN:1]
[BIOME_SUPPORT:ANY_LAKE:1]
[BIOME_SUPPORT:MOUNTAIN:3]
[BIOME_SUPPORT:ANY_GRASSLAND:1]
[BIOME_SUPPORT:ANY_SAVANNA:1]
[BIOME_SUPPORT:ANY_SHRUBLAND:1]
[BIOME_SUPPORT:ANY_RIVER:1]
[DIPLOMAT]
[DIPLOMAT_BODYGUARDS]
[MERCHANT_BODYGUARDS]
[ACTIVE_SEASON:WINTER]
[SIEGER]
[MAX_STARTING_CIV_NUMBER:3]
[START_GROUP_NUMBER:10]
[MAX_POP_NUMBER:10000]
[MAX_SITE_POP_NUMBER:200]
[RELIGION:PANTHEON]
[RELIGION_SPHERE:FORTRESSES]
[RELIGION_SPHERE:JEWELS]
[RELIGION_SPHERE:METALS]
[RELIGION_SPHERE:MINERALS]
[RELIGION_SPHERE:MOUNTAINS]
[RELIGION_SPHERE:WEALTH]
[RELIGION_SPHERE:NIGHT]
[RELIGION_SPHERE:WAR]
[RELIGION_SPHERE:DISEASE]
[RELIGION_SPHERE:FIRE]
[MAYOR]
[WANDERER]
[BEAST_HUNTER]
[SCOUT]
[PERMITTED_JOB:MINER]
[PERMITTED_JOB:CARPENTER]
[PERMITTED_JOB:BOWYER]
[PERMITTED_JOB:WOODCUTTER]
[PERMITTED_JOB:ENGRAVER]
[PERMITTED_JOB:MASON]
[PERMITTED_JOB:ANIMAL_CARETAKER]
[PERMITTED_JOB:ANIMAL_TRAINER]
[PERMITTED_JOB:HUNTER]
[PERMITTED_JOB:TRAPPER]
[PERMITTED_JOB:ANIMAL_DISSECTOR]
[PERMITTED_JOB:FURNACE_OPERATOR]
[PERMITTED_JOB:WEAPONSMITH]
[PERMITTED_JOB:ARMORER]
[PERMITTED_JOB:BLACKSMITH]
[PERMITTED_JOB:METALCRAFTER]
[PERMITTED_JOB:GEM_CUTTER]
[PERMITTED_JOB:GEM_SETTER]
[PERMITTED_JOB:WOODCRAFTER]
[PERMITTED_JOB:STONECRAFTER]
[PERMITTED_JOB:LEATHERWORKER]
[PERMITTED_JOB:BONE_CARVER]
[PERMITTED_JOB:WEAVER]
[PERMITTED_JOB:CLOTHIER]
[PERMITTED_JOB:GLASSMAKER]
[PERMITTED_JOB:STRAND_EXTRACTOR]
[PERMITTED_JOB:FISHERMAN]
[PERMITTED_JOB:FISH_DISSECTOR]
[PERMITTED_JOB:FISH_CLEANER]
[PERMITTED_JOB:CHEESE_MAKER]
[PERMITTED_JOB:MILKER]
[PERMITTED_JOB:COOK]
[PERMITTED_JOB:THRESHER]
[PERMITTED_JOB:MILLER]
[PERMITTED_JOB:BUTCHER]
[PERMITTED_JOB:TANNER]
[PERMITTED_JOB:DYER]
[PERMITTED_JOB:PLANTER]
[PERMITTED_JOB:HERBALIST]
[PERMITTED_JOB:BREWER]
[PERMITTED_JOB:SOAP_MAKER]
[PERMITTED_JOB:POTASH_MAKER]
[PERMITTED_JOB:LYE_MAKER]
[PERMITTED_JOB:WOOD_BURNER]
[PERMITTED_JOB:MECHANIC]
[PERMITTED_JOB:SIEGE_ENGINEER]
[PERMITTED_JOB:SIEGE_OPERATOR]
[PERMITTED_JOB:PUMP_OPERATOR]
[PERMITTED_JOB:CLERK]
[PERMITTED_JOB:ADMINISTRATOR]
[PERMITTED_JOB:TRADER]
[PERMITTED_JOB:ARCHITECT]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[ETHIC:KILL_ENTITY_MEMBER:PUNISH_CAPITAL]
[ETHIC:KILL_NEUTRAL:ACCEPTABLE]
[ETHIC:KILL_ENEMY:ACCEPTABLE]
[ETHIC:KILL_ANIMAL:ACCEPTABLE]
[ETHIC:KILL_PLANT:ACCEPTABLE]
[ETHIC:TORTURE_AS_EXAMPLE:ACCEPTABLE]
[ETHIC:TORTURE_FOR_INFORMATION:ACCEPTABLE]
[ETHIC:TORTURE_FOR_FUN:PERSONAL_MATTER]
[ETHIC:TORTURE_ANIMALS:ACCEPTABLE]
[ETHIC:TREASON:PUNISH_CAPITAL]
[ETHIC:OATH_BREAKING:PUNISH_CAPITAL]
[ETHIC:LYING:PERSONAL_MATTER]
[ETHIC:VANDALISM:ACCEPTABLE]
[ETHIC:TRESPASSING:PUNISH_SERIOUS]
[ETHIC:THEFT:PUNISH_SERIOUS]
[ETHIC:ASSAULT:PUNISH_SERIOUS]
[ETHIC:SLAVERY:ACCEPTABLE]
[ETHIC:EAT_SAPIENT_OTHER:ACCEPTABLE]
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]
[ETHIC:MAKE_TROPHY_SAME_RACE:ACCEPTABLE]
[ETHIC:MAKE_TROPHY_SAPIENT:ACCEPTABLE]
[ETHIC:MAKE_TROPHY_ANIMAL:ACCEPTABLE]
[WILL_ACCEPT_TRIBUTE]

The fun part is that your dark dwarves will, thanks to the specified symbols, have some crazy names that you'd never see with regular dwarves (one of the fortresses it generated was called "Crowanus", for example). If you dislike having bad language, just remove the [SELECT_SYMBOL:ALL:UNTOWARD].

The main differences you'll see here compared to the dwarf entry is that they have different weapons, toys, instruments (thanks to their warlike nature, they build less of them) and [USE_EVIL_ANIMALS] is turned on: this will do nothing in dwarf fort mode but you'll see tamed trolls and ogres in their fortresses in adventurer mode. Many of their other tokens are changed as well, to make them more violent and evil. For example, they will eat their foes like elves do. Yum!

Now, we need to build the DARK_DWARF creature. Create a new text file called 'creature_new.txt'. Immediately, add the following:

creature_new

[OBJECT:CREATURE]

That'll make this text file recognized as a creature file. Now, we simply add our dark_dwarf creature:

[CREATURE:DARK_DWARF]
[NAME:dark dwarf:dark dwarves:dark dwarven]
[TILE:1][COLOR:3:0:0]
[GENPOWER:3]
[INTELLIGENT]
[TRANCES]
[EVIL]
[CANOPENDOORS]
[PREFSTRING:beards]
[PREFSTRING:violent tempers]
[PREFSTRING:sullying of the dead]
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:THROAT:NECK:SPINE:BRAIN:5FINGERS:5TOES:MOUTH]
[STOUT]
[MAXAGE:250:270]
[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]
[ATTACK:SECOND:BYTYPE:MOUTH:bite:bites:1:1:GORE][ATTACKFLAG_CANLATCH]
[CHILD:12][BABY:1][MULTIPLE_LITTER_RARE]
[DAMBLOCK:1]
[FAT:3]
[SIZE:6]
[EQUIPS]
[CAVE_ADAPT]
[NOCTURNAL]
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]
[FISHERMAN_NAME:fisherdwarf:fisherdwarves]
[HAMMERMAN_NAME:hammerdwarf:hammerdwarves]
[SPEARMAN_NAME:speardwarf:speardwarves]
[CROSSBOWMAN_NAME:marksdwarf:marksdwarves]
[AXEMAN_NAME:axedwarf:axedwarves]
[SWORDSMAN_NAME:swordsdwarf:swordsdwarves]
[MACEMAN_NAME:macedwarf:macedwarves]
[PIKEMAN_NAME:pikedwarf:pikedwarves]
[BOWMAN_NAME:bowdwarf:bowdwarves]
[SPEECH:dwarf.txt]
[STANDARD_FLESH]
[HOMEOTHERM:10067]
[LAYERING:50]
[SWIMS_LEARNED][SWIM_SPEED:2500]
[PERSONALITY:ANGER:25:75:100]
[PERSONALITY:IMMODERATION:0:75:100]
[PERSONALITY:EXCITEMENT_SEEKING:0:60:100]
[PERSONALITY:CHEERFULNESS:0:10:90]
[PERSONALITY:ALTRUISM:0:25:50]
[PERSONALITY:MODESTY:0:20:90]
[PERSONALITY:SYMPATHY:0:25:50]
[PERSONALITY:VULNERABILITY:0:25:100]
[PERSONALITY:STRAIGHTFORWARDNESS:25:65:100]
[PERSONALITY:SELF_DISCIPLINE:30:75:100]

This is largely a copy of the regular dwarves, but with several differences: [LIKES_FIGHTING] will give them happy thoughts when they have fought something, [NOCTURNAL] means they like nights rather than days, and [EVIL] means on the adventurer map their fortresses will tend to end up on evil tiles rather than good ones. Otherwise, they are exactly the same as regular dwarves. To make them extra evil, add [BONECARN] somewhere in there and they can eat bones (they'll actually haul them from your refuse pit to the dining table, yum), but will sometimes (though rarely) choke to death on them. Bear in mind that [BONECARN] implies [CARNIVORE], so they won't eat vegetables making the game much harder. Also, they do not require booze to stay happy (though will happily drink it anyway if they have to).

There! That's all we need to do in order to add our civilization. Just create a new world and they'll be there: however, when you go to adventurer mode, all (or none) of your dwarf entries might be replaced with dark dwarves, so it's really a matter of luck. When you start a new fortress, there will be a 50-50 chance of playing either as dwarves or dark dwarves. The easiest way to tell if a civ is a dark dwarven is if the name is rather unpleasant. 'The Fortress of Rapes' for example would probably not be a standard dwarven one. Remove [CIV_CONTROLLABLE] from the standard dwarves if you only want to play as dark.

== Example two: "Arachnid" playable creature ==

This time, we're going to add a new playable creature to adventurer mode, but not playable in fortress mode. An 'arachnid' is a large, powerful, evil half-elf, half-spider (no copyright violations here!): they are too big to wear standard equipment and are quite nasty enough without it anyway. The downside to playing them is that since they do not form standard civilizations, you cannot start them at a specific location nor will they have any weapon, armor, or [[wrestling]] skills to start out.

First off, we need to add a civilization entry in entity_default.txt. Open it up and add this to the top of the file:

[ENTITY:ARACHNIDS]
[MOUNTAIN_SETTLEMENTS]
[CREATURE:ARACHNID]
[INDIV_CONTROLLABLE]
[ADVENTURE_TIER:4]
Note: adventure_tier should be 5 if you also have the dark dwarves.
[TRANSLATION:ELF]
[BIOME_SUPPORT:ANY_WETLAND:2]
[BIOME_SUPPORT:ANY_DESERT:3]
[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:MOUNTAIN:4]
[BIOME_SUPPORT:ANY_GRASSLAND:1]
[BIOME_SUPPORT:ANY_SAVANNA:1]
[BIOME_SUPPORT:ANY_SHRUBLAND:1]
[BIOME_SUPPORT:ANY_RIVER:2]
[START_BIOME:MOUNTAIN]
[SELECT_SYMBOL:ALL:EVIL]
[SELECT_SYMBOL:ALL:VIOLENT]
[SELECT_SYMBOL:ALL:DEATH]
[SELECT_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:HOLY]
[CULL_SYMBOL:ALL:PEACE]
[CULL_SYMBOL:ALL:NEGATOR]
[CULL_SYMBOL:ALL:GOOD]
[FRIENDLY_COLOR:7:0:0]
[DEFAULT_SITE_TYPE:CAVE]
[LIKES_SITE:CAVE]
[TOLERATES_SITE:CAVE]
[ACTIVE_SEASON:SPRING]
[ACTIVE_SEASON:SUMMER]
[ACTIVE_SEASON:AUTUMN]
[ACTIVE_SEASON:WINTER]
[MAX_STARTING_CIV_NUMBER:2]
[START_GROUP_NUMBER:1]
[MAX_POP_NUMBER:500]
[MAX_SITE_POP_NUMBER:20]
[ETHIC:KILL_ENTITY_MEMBER:ACCEPTABLE]
[ETHIC:KILL_NEUTRAL:ACCEPTABLE]
[ETHIC:KILL_ENEMY:ACCEPTABLE]
[ETHIC:KILL_ANIMAL:ACCEPTABLE]
[ETHIC:KILL_PLANT:ACCEPTABLE]
[ETHIC:TORTURE_AS_EXAMPLE:ACCEPTABLE]
[ETHIC:TORTURE_FOR_INFORMATION:ACCEPTABLE]
[ETHIC:TORTURE_FOR_FUN:ACCEPTABLE]
[ETHIC:TORTURE_ANIMALS:ACCEPTABLE]
[ETHIC:TREASON:ACCEPTABLE]
[ETHIC:OATH_BREAKING:ACCEPTABLE]
[ETHIC:LYING:ACCEPTABLE]
[ETHIC:VANDALISM:ACCEPTABLE]
[ETHIC:TRESPASSING:NOT_APPLICABLE]
[ETHIC:THEFT:NOT_APPLICABLE]
[ETHIC:ASSAULT:ACCEPTABLE]
[ETHIC:SLAVERY:UNTHINKABLE]
[ETHIC:EAT_SAPIENT_OTHER:ACCEPTABLE]
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]
[ETHIC:MAKE_TROPHY_SAME_RACE:ACCEPTABLE]
[ETHIC:MAKE_TROPHY_SAPIENT:ACCEPTABLE]
[ETHIC:MAKE_TROPHY_ANIMAL:ACCEPTABLE]

INDIV_CONTROLLABLE and ADVENTURE_TIER tokens allows us to use ARACHNID: PLAY NOW! in adventurer mode, which is exactly what we want. They'll be powerful enough to use without gear anyhow.

Next, we open up creature_new.txt (if you haven't made one, check the above example) and add the new creature to it:

[CREATURE:ARACHNID]
[NAME:arachnid:arachnids:arachnid]
[TILE:'&'][COLOR:7:0:0]
[MODVALUE:20][SEMIMEGABEAST]
[INTELLIGENT][CANOPENDOORS]
[LARGE_CHASM][FREQUENCY:1][DIFFICULTY:4]
[SPEED:700]
[STOUT]
[EXTRACT:arachnid venom:7:0:0]
[EXTRACT_VALUE:500]
[EXTRACT_PARALYZE][NATURAL][PET_EXOTIC]
[EXTRACT_ANTIDOTE:arachnid antivenin:7:0:0:100]
[WEBIMMUNE][AMBUSHPREDATOR][PARALYZEIMMUNE]
[GENPOWER:4]
[BLOODTYPE:W][CHITIN]
[PETVALUE:2500]
[GRASSTRAMPLE:10]
[CARNIVORE][BONECARN]
[EXTRAVISION][NOSTUN][NOEXERT][NOFEAR]
[BUILDINGDESTROYER:1]
[PREFSTRING:terrifying presence]
[PREFSTRING:fearsome venom]
[BODY:ARACHNOBODY:8EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:THROAT:NECK:SPINE:BRAIN:MOUTH:5FINGERS]
[SIZE:15]
[MAXAGE:20:30]
[ATTACK:MAIN:BYTYPE:MOUTH:bite:bites:1:6:GORE][SPECIALATTACK_INJECT_EXTRACT:50:100]
[ATTACK:SECOND:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]
[FAT:2]
[CHILD:30][BABY:1][MULTIPLE_LITTER_RARE]
[DAMBLOCK:10]
[ALL_ACTIVE][CAVE_ADAPT]
[STANDARD_FLESH]
[HOMEOTHERM:10067]
[LAYERING:50]
[SWIMS_LEARNED][SWIM_SPEED:2500]
[MUNDANE]

Now, what does this all mean, exactly? Well, compared to dwarves they are big, bad, as fast as elves, as sturdy as dwarves (hard to knock over), they have white blood, can eat bones, are immune to fear, stun, and never get tired, see twice as far, and are almost totally immune to most small-damage attacks. In addition I copied the giant cave spider paralyzing bite attack, so when you bite and hit, you'll sometimes inject a paralyzing poison fairly often that'll knock your prey unconscious in a few combat rounds. Not only is the bite very damaging, but you can even knock out creatures like ettins or giants and rip them up as they sleep at your leisure.

However, we're not done yet. Notice the BODY: token has a few tidbits that we need to take a closer look at- 'ARACHNOBODY' and '8EYES' in particular. These are new to our species and we need to add them. So, close that and open up body_default.txt, or create your own body_something.txt file. Add the following to the bottom:

[BODY:ARACHNOBODY]
[BP:UB:upper body][UPPERBODY]
[BP:LB:abdomen][CON:UB][LOWERBODY]
[BP:HD:head][CON:UB][HEAD]
[BP:RUA:right upper arm][CON:LB][LIMB][RIGHT]
[BP:LUA:left upper arm][CON:LB][LIMB][LEFT]
[BP:RLA:right lower arm][CON:RUA][LIMB][RIGHT]
[BP:LLA:left lower arm][CON:LUA][LIMB][LEFT]
[BP:RH:right hand][CON:RLA][GRASP][RIGHT]
[BP:LH:left hand][CON:LLA][GRASP][LEFT]
[BP:RA1:right first leg][CON:LB][LIMB][RIGHT]
[BP:LA1:left first leg][CON:LB][LIMB][LEFT]
[BP:RF1:right first claw][CON:RA1][STANCE][RIGHT]
[BP:LF1:left first claw][CON:LA1][STANCE][LEFT]
[BP:RA2:right second leg][CON:LB][LIMB][RIGHT]
[BP:LA2:left second leg][CON:LB][LIMB][LEFT]
[BP:RF2:right second claw][CON:RA2][STANCE][RIGHT]
[BP:LF2:left second claw][CON:LA2][STANCE][LEFT]
[BP:RA3:right third leg][CON:LB][LIMB][RIGHT]
[BP:LA3:left third leg][CON:LB][LIMB][LEFT]
[BP:RF3:right third claw][CON:RA3][STANCE][RIGHT]
[BP:LF3:left third claw][CON:LA3][STANCE][LEFT]
[BP:RA4:right fourth leg][CON:LB][LIMB][RIGHT]
[BP:LA4:left fourth leg][CON:LB][LIMB][LEFT]
[BP:RF4:right fourth claw][CON:RA4][STANCE][RIGHT]
[BP:LF4:left fourth claw][CON:LA4][STANCE][LEFT]

[BODY:8EYES]
[BP:REYE:first eye][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT]
[BP:REYE:second eye][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT]
[BP:REYE:third eye][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL]
[BP:REYE:fourth eye][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL]
[BP:REYE:fifth eye][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL]
[BP:REYE:sixth eye][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL]
[BP:REYE:seventh eye][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT]
[BP:LEYE:eighth eye][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT]

Voila! Now you have your complete arachnid. They are very fun to play in adventurer mode, yet still a challenge. You can tear through unarmed civilians like a knife through butter, armed soldiers pose a minor challenge (much bigger if you are getting ganged up on), elite spearmen are devastating, and archers still rip you to shreds unless you close in on them quickly and poison them. However, thanks to your multiple eyes and legs you can take quite a few direct hits and still keep going (I once had an arrow smash straight through my head, taking out 5 eyes and wounding the throat, brains, and both ears, and survived the encounter).

In any case, you're now done! Create a new world and you will now be able to use arachnids as a playable creature in adventurer mode.

Written by Teldin.

= Modbase =

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings.
[http://www.bay12games.com/forum/index.php?topic=18623.0 Get it now!]
For version 0.38c.

[[Category:Modding]]
[[Category:Guides]]