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.

Editing Graphics

Jump to navigation Jump to search

Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.

If you are creating a redirect to the current version's page, do not use any namespace. For example: use #REDIRECT [[Cat]], not #REDIRECT [[Main:Cat]] or #REDIRECT [[cv:Cat]]. See DF:Versions for more information.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 46: Line 46:
  
 
== Creature Graphics ==
 
== Creature Graphics ==
−
{{for/see|a list of all known creature graphics tokens|[[Graphics token#Creature Graphics]]}}.
 
 
Creature graphics are found within graphics_creature_x files (such as graphics_creature_domestic or graphics_creature_layered).  All graphics files must begin with the file name, followed by the <code>[OBJECT:GRAPHICS]</code> token that tells the game that the file contains graphics definitions.
 
Creature graphics are found within graphics_creature_x files (such as graphics_creature_domestic or graphics_creature_layered).  All graphics files must begin with the file name, followed by the <code>[OBJECT:GRAPHICS]</code> token that tells the game that the file contains graphics definitions.
  
Line 65: Line 64:
  
 
:'''Basic Conditions'''
 
:'''Basic Conditions'''
−
Different graphics can be defined for the same creature based on some properties about it. Below is a list of the most common creature conditions tokens.  
+
Different graphics can be defined for the same creature based on some properties about it. Below is a list of the most common creature conditions tokens. Here is the full list of known creature condition tokens.
  
 
{| {{prettytable}}
 
{| {{prettytable}}
Line 173: Line 172:
  
 
There is not currently a way to use procedurally defined graphics like this for non-{{token|FEATURE_BEAST|c}} creatures.{{verify}}
 
There is not currently a way to use procedurally defined graphics like this for non-{{token|FEATURE_BEAST|c}} creatures.{{verify}}
 +
 +
 +
=== All creature tokens ===
 +
For reference, all known creature graphics tokens are reproduced below.
 +
 +
 +
:'''Basic Conditions'''<br>Different graphics can be defined for the same creature based on some properties about it. Below is a list of all conditions that can be used for creature graphics that accept a ''condition'' token.
 +
{| {{prettytable}}
 +
|- bgcolor="#dddddd"
 +
! Condition
 +
! Accepts<br>Secondary
 +
! Description
 +
|-
 +
| {{token|DEFAULT|g}} || No || The default condition that will be displayed unless overwritten by a more specific one below.
 +
 +
|-
 +
| {{token|CHILD|g}} || Yes || Will only be displayed if the creature is a {{token|CHILD|c}} or {{token|BABY|c}} and is younger than one of those ages.
 +
 +
|-
 +
| {{token|ANIMATED|g}} || Yes || Displayed if the creature is raised from the dead, although it is not known how this is decided. Raised status is not related to having a syndrome with the class from {{token|CONDITION_SYN_CLASS|g}} or from having {{token|NOT_LIVING|c}}/{{token|OPPOSED_TO_LIFE|c}}.
 +
 +
|-
 +
| {{token|CORPSE|g}} || Yes || Displayed as soon as the creature dies.
 +
 +
|-
 +
| {{token|TRAINED_HUNTER|g}} || Yes || Shown for hunting-trained versions of this creature.
 +
 +
|-
 +
| {{token|TRAINED_WAR|g}} || Yes || Shown for war-trained versions of this creature.
 +
 +
|-
 +
| {{token|LIST_ICON|g}} || Unknown || Displayed in menus. Useful for large images that would extend beyond the menu boxes otherwise/
 +
 +
|-
 +
| {{token|SKELETON|g}} || Unknown || Decayed remains of the creature.{{verify}}
 +
 +
|-
 +
| {{token|SKELETON_WITH_SKULL|g}} || Unknown || Decayed remains of the creature with a skull.{{verify}}
 +
|}
 +
 +
 +
:'''Vermin Conditions'''<br>Special Conditions for {{token|VERMIN|c}} creature graphics:
 +
{| {{prettytable}}
 +
|- bgcolor="#dddddd"
 +
! Condition
 +
! Description
 +
|-
 +
| {{token|VERMIN|g}} || Necessary for defining graphics that use the tokens below.{{verify}}
 +
 +
|-
 +
| {{token|VERMIN_ALT|g}} || Image cycles every 1 second.
 +
 +
|-
 +
| {{token|SWARM_SMALL|g}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in small groups.
 +
 +
|-
 +
| {{token|SWARM_MEDIUM|g}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in medium-sized groups.
 +
 +
|-
 +
| {{token|SWARM_LARGE|g}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in large groups.
 +
 +
|-
 +
| {{token|LIGHT_VERMIN|g}} || For [[firefly|fireflies]] etc. Does not replace {{token|VERMIN|g}}.
 +
 +
|-
 +
| {{token|LIGHT_VERMIN_ALT|g}} || Like {{token|VERMIN_ALT|g}} for [[firefly|fireflies]] etc.
 +
 +
|-
 +
| {{token|LIGHT_SWARM_SMALL|g}} || Like {{token|SWARM_SMALL|g}} for [[firefly|fireflies]] etc in small groups.
 +
 +
|-
 +
| {{token|LIGHT_SWARM_MEDIUM|g}} || Like {{token|SWARM_LARGE|g}} for [[firefly|fireflies]] etc in large groups.
 +
 +
|-
 +
| {{token|LIGHT_SWARM_LARGE|g}} || Like {{token|SWARM_LARGE|g}} for [[firefly|fireflies]] etc.
 +
 +
|-
 +
| {{token|REMAINS|g}} || Vermin corpses.
 +
 +
|-
 +
| {{token|HIVE|g}} || Vermin hives.
 +
|}
 +
 +
 +
:'''Layered Conditions'''<br>Layers aren't very useful on their own, so they come with a set of conditions to define how when they are displayed and how they interact.
 +
{| {{prettytable}}
 +
|- bgcolor="#dddddd"
 +
! Token
 +
! Arguments
 +
! Type
 +
! Description
 +
 +
|-
 +
| {{token|LAYER_GROUP|g}} ||  || Layer<br>Group
 +
| Begins defining a layer group. Current effect unknown.{{verify}}
 +
 +
|-
 +
| {{token|END_LAYER_GROUP|g}} ||  || Layer<br>Group
 +
| marks the end of a layer group. Current effect unknown.{{verify}}
 +
 +
|-
 +
| {{token|CONDITION_ITEM_WORN|g}} ||
 +
* BY_CATEGORY / BY_TOKEN
 +
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
 +
* Armor type (ARMOR, GLOVES, Etc.)
 +
* Item ID(s)
 +
|| Armor<br>Wieldables || Defines a clothing or armor graphic by the specific part it is equipped to, the type of armor it is, and the internal id of that item.
 +
For example, a condition representing a right handed mitten or glove would be defined as:
 +
<code>[CONDITION_ITEM_WORN:BY_TOKEN:RH:GLOVES:ITEM_GLOVES_GLOVES:ITEM:GLOVES:MITTENS]</code>
 +
 +
|-
 +
| {{token|SHUT_OFF_IF_ITEM_PRESENT|g}} ||
 +
* BY_CATEGORY / BY_TOKEN
 +
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
 +
* Armor type
 +
* Item ID(s)
 +
|| Armor || Causes the current layer to not be rendered if the creature has one of the items worn or equipped. Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).
 +
 +
|-
 +
| {{token|CONDITION_DYE|g}} ||
 +
* dye color
 +
|| Armor
 +
|| Should represent which color the clothing is dyed. Currently nonfunctional.{{version|50.05}}
 +
 +
|-
 +
| {{token|CONDITION_NOT_DYED|g}} ||  || Armor
 +
|| Should check if the clothing is dyed. Currently nonfunctional.{{version|50.05}}
 +
 +
|-
 +
| {{token|CONDITION_MATERIAL_FLAG|g}} ||
 +
* material flag
 +
|| Material || Changes graphics based on the material an equipped item is made of. Valid material flags are similar to [[Reaction#Full_token_list|reactant conditions]] including:
 +
* WOVEN_ITEM
 +
* ANY_X_MATERIAL
 +
:with X being:
 +
:* PLANT, SILK, YARN, LEATHER, WOOD, SHELL, BONE, STONE, GEM, TOOTH, HORN, PEARL
 +
* IS_DIVINE_MATERIAL
 +
* NOT_ARTIFACT
 +
* IS_CRAFTED_ARTIFACT
 +
* METAL_ITEM_MATERIAL
 +
* GLASS_MATERIAL
 +
* FIRE_BUILD_SAFE
 +
* MAGMA_BUILD_SAFE
 +
[http://www.bay12forums.com/smf/index.php?topic=169696.msg8442543#msg8442543 among other, less useful ones.]
 +
 +
|-
 +
| {{token|CONDITION_MATERIAL_TYPE|g}} ||
 +
* material token
 +
|| Material || Changes graphics based on the material an equipped item is made of. Valid material types take the form <code>METAL:COPPER</code> where copper can be replaced with any weapons-grade metal. Initial testing has shown that some [[material token]]s are not functional. {{token|CONDITION_MATERIAL_FLAG|g}} is a better option for any material condition other than metal.
 +
 +
|-
 +
| {{token|CONDITION_PROFESSION_CATEGORY|g}} ||
 +
* [[Unit type token|profession token(s)]]
 +
|| General
 +
|| Checks the profession of the creature to act as a condition. Multiple profession tokens can be chained together.
 +
 +
|-
 +
| {{token|CONDITION_RANDOM_PART_INDEX|g}} ||
 +
* body part
 +
* integer index
 +
* integer range
 +
|| General
 +
|| Chooses a random layer within the same group of body parts. Index is which option this condition is, out of Range number of options. Ex:
 +
<code>[CONDITION_RANDOM_PART_INDEX:HEAD:3:4]</code>
 +
Is the third possible random head out of four total options. One of these random conditions each will be put into a set of four slightly different heads to add some random variation in the appearance of the creature's head.
 +
 +
|-
 +
| {{token|CONDITION_HAUL_COUNT_MIN|g}} ||
 +
* integer
 +
|| General
 +
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL|c}}s in vanilla.
 +
 +
|-
 +
| {{token|CONDITION_HAUL_COUNT_MAX|g}} ||
 +
* integer
 +
|| General
 +
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL|c}}s in vanilla.
 +
 +
|-
 +
| {{token|CONDITION_CHILD|g}} ||  || General
 +
|| Checks if the creature is a child or baby.
 +
 +
|-
 +
| {{token|CONDITION_NOT_CHILD|g}} ||  || General
 +
|| Checks if the creature is an adult.
 +
 +
|-
 +
| {{token|CONDITION_GHOST|g}} ||  || General
 +
|| Checks if the creature is a ghost.
 +
 +
|-
 +
| {{token|CONDITION_SYN_CLASS|g}} ||
 +
* {{token|SYN_CLASS|syndrome}}
 +
|| Syndrome || Changes graphics based on any syndromes the creature is affected by. Valid values include:
 +
* ZOMBIE
 +
* NECROMANCER
 +
* VAMPCURSE
 +
* RAISED_UNDEAD
 +
* GHOUL
 +
 +
|-
 +
| {{token|CONDITION_TISSUE_LAYER|g}} ||
 +
* BY_CATEGORY
 +
* [[Body_token#CATEGORY|body part category]] or ALL
 +
* [[Body_detail_plan_token#BP_LAYERS|tissue layer]] or ALL
 +
|| Tissue
 +
|| Selects a tissue layer to use for checking other conditions. Ex:
 +
<code>[CONDITION_TISSUE_LAYER:BY_CATEGORY:ALL:SKIN]</code>
 +
 +
|-
 +
| {{token|TISSUE_MIN_LENGTH|g}} ||
 +
* integer
 +
|| Tissue
 +
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is greater than the integer input.
 +
 +
|-
 +
| {{token|TISSUE_MAX_LENGTH|g}} ||
 +
* integer
 +
|| Tissue
 +
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is less than the integer input.
 +
 +
|-
 +
| {{token|TISSUE_MAY_HAVE_COLOR|g}} ||
 +
* [[Color#Color_tokens|color token(s)]]
 +
|| Tissue
 +
|| Checks the selected tissue's color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.
 +
 +
|-
 +
| {{token|TISSUE_MAY_HAVE_SHAPING|g}} ||
 +
* styling token
 +
|| Tissue
 +
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s shaping (hairstyle). Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.{{verify}}
 +
 +
|-
 +
| {{token|TISSUE_NOT_SHAPED|g}} || || Tissue
 +
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.
 +
 +
|-
 +
| {{token|TISSUE_SWAP|g}} ||
 +
* IF_MIN_CURLY
 +
* integer
 +
* tile page id
 +
* x position
 +
* y position
 +
| Tissue
 +
| Checks if a tissue is sufficiently curly, and if so swaps to display a different image. The new image is defined by the tile page ID, x position, and y position.
 +
 +
This condition should be within a [LAYER:... ] that has a similar graphic to the on in the TISSUE_SWAP.
 +
The current {{token|CONDITION_TISSUE_LAYER|g}} group must also include a {{token|TISSUE_MIN_LENGTH|g}}.
 +
|}
 +
  
 
== Item Graphics ==
 
== Item Graphics ==

Please note that all contributions to Dwarf Fortress Wiki are considered to be released under the GFDL & MIT (see Dwarf Fortress Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following CAPTCHA:

Cancel Editing help (opens in new window)

Templates used on this page:

This page is a member of 3 hidden categories:

Retrieved from "https://dwarffortresswiki.org/index.php/Graphics"