v0.31:Color

v50.14 · v0.47 · v0.34 · v0.31.25 · v0.28 · v0.23 This article is about an older version of DF. More Info · V

xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼

Color is used to express various information, from a dwarf's Template:L to the natural color of a terrain feature to the material an item is made of.

• If looking for different colors for the game as seen on your computer screen, see Template:L.
• If looking for the different colors used to represent different dwarfs, see Template:L.)
• If looking for colors of items listed in the z-stocks menu, see Template:L.

Wall vs. floor color

Template:L (to the left) has DISPLAY_COLOR:0:7:1 and BASIC_COLOR:7:0. The Template:L present has DISPLAY_COLOR:7:6:1 and so the actual floor color is 7:1 (white).

While the foreground, background and brightness shown in the {{L|Material definition token|RAW} files will be applied to Template:Ls, the Template:L's "secondary" color will end up different. Here is how it works:

• If the BASIC_COLOR tag is specified, it will use that color. Note that the BASIC_COLOR tag only has foreground and brightness as arguments.
• If BASIC_COLOR is left out:
  • The background color is forced to 0 (effectively stripping it).
  • If the foreground color is 0, the game will display it as dark grey, color 8 (in other words, color 0 with brightness 1).

This is effective for Template:L, Template:Ls, Template:Ls, and Template:Ls (in the case of stone). When stone is Template:L, it uses the material's TILE_COLOR (which is the same as the DISPLAY_COLOR unless overridden).

Modding color

If you wish to change how a specific item appears in the game, you can modify what colors are associated with that item.* Various moddable files use one of the the two color definitions below.

Color flags

Colors are primarily defined using the [COLOR:foreground:background:brightness] flag. The three arguments are:

1. Foreground color [0-7]
2. Background color [0-7]
3. Brightness of the foreground color [0 or 1]

The brightness of the background color is always 0.

By default*, the following 8 pairs of colors are displayed:

Col. Bri. Name 0 0 Black 1 0 Blue 2 0 Green 3 0 Cyan 4 0 Red 5 0 Magenta 6 0 Brown 7 0 Light grey

Col. Bri. Name 0 1 Dark grey 1 1 Light blue 2 1 Light green 3 1 Light cyan 4 1 Light red 5 1 Light magenta 6 1 Yellow 7 1 White

(* See Template:L for information about how to change the actual various colors as displayed.)

Sometimes the color numbers are part of another flag, e.g. the last three arguments of [EXTRACT:golden salve:6:0:1] express the color yellow on black.

Interesting Color Effects

Values 8-15

If the brightness value is 1 or another nonzero number, it adds 8 to the foreground color. If the final value of the foreground or background is 8-15, it appears as a "bright" color. As these values can be manually typed in instead of using the brightness value, you can also give the background a bright color with this method.

Values higher than 15:

If the foreground color is higher than 15 for any reason, the tile or creature will take the color of whatever tile was in that position on the screen in the previous frame. If the background color value is higher than 15, it also acts this way, taking the background color of the previous tile to inhabit that location. ^{[Disputed - see talk]}

Color tokens

Dyes do not use color flags, they reference color tokens defined in descriptor_color_standard.txt. Color tokens are simply referenced by the token name, e.g. [MILL_DYE:EMERALD]. However, the defined RGB values are never actually displayed in-game - instead, the game uses one of the above 16 colors, choosing the one with the closest RGB values.

The following colors are defined via tokens:

Token RGB SILVER 192 192 192 MAROON 128 0 0 BLACK 0 0 0 VERMILION 227 66 52 RUSSET 117 90 87 BURNT_UMBER 138 51 36 SCARLET 255 36 0 DARK_CHESTNUT 152 105 96 BURNT_SIENNA 233 116 81 RUST 183 65 14 MAHOGANY 192 64 0 PUMPKIN 255 117 24 CHOCOLATE 210 105 30 ECRU 194 178 128 TAUPE_PALE 188 152 126 TAUPE_GRAY 139 133 137 TAUPE_MEDIUM 103 76 71 TAUPE_DARK 72 60 50 TAUPE_SANDY 150 113 23 COPPER 184 115 51 DARK_PEACH 255 218 185 SEPIA 112 66 20 AUBURN 111 53 26 PALE_BROWN 152 118 84 BRONZE 205 127 50 DARK_BROWN 101 67 33 LIGHT_BROWN 205 133 63 BROWN 150 75 0 CINNAMON 123 63 0 OCHRE 204 119 34 RAW_UMBER 115 74 18 TAN 210 180 140 ORANGE 255 165 0 PEACH 255 229 180 BUFF 240 220 130 GOLDENROD 218 165 32 DARK_TAN 145 129 81 AMBER 255 191 0 SAFFRON 244 196 48 FLAX 238 220 130 GOLDEN_YELLOW 255 223 0 GOLD 255 215 0 BRASS 181 166 66 LEMON 253 233 16 CREAM 255 253 208 YELLOW 255 255 0 BEIGE 245 245 220 OLIVE 128 128 0 LIME 204 255 0 DARK_OLIVE 85 104 50 YELLOW-GREEN 154 205 50 GREEN-YELLOW 173 255 47 CHARTREUSE 127 255 0 FERN_GREEN 79 121 66 MOSS_GREEN 173 223 173 MINT_GREEN 152 255 152

Token RGB GREEN 0 255 0 EMERALD 80 200 120 SEA_GREEN 46 139 87 DARK_GREEN 1 50 32 JADE 0 168 107 SPRING_GREEN 0 255 127 AQUAMARINE 127 255 212 PINE_GREEN 1 121 111 TURQUOISE 48 213 200 LIGHT_BLUE 173 216 230 PALE_BLUE 175 238 238 SKY_BLUE 135 206 235 TEAL 0 128 128 AQUA 0 255 255 CERULEAN 0 123 167 MIDNIGHT_BLUE 0 51 102 AZURE 0 127 255 ASH_GRAY 178 190 181 SLATE_GRAY 112 128 144 CHARCOAL 54 69 79 COBALT 0 71 171 BLUE 0 0 255 DARK_BLUE 0 0 139 PERIWINKLE 204 204 255 LAVENDER 230 230 250 DARK_VIOLET 66 49 137 DARK_INDIGO 49 0 98 AMETHYST 153 102 204 VIOLET 139 0 255 INDIGO 75 0 130 PURPLE 102 0 153 HELIOTROPE 223 115 255 LILAC 200 162 200 GRAY 128 128 128 CLEAR 128 128 128 MAUVE_TAUPE 145 95 109 ROSE_TAUPE 144 93 93 TAUPE_PURPLE 80 64 77 PLUM 102 0 102 FUCHSIA 244 0 161 MAUVE 153 51 102 WHITE 255 255 255 IVORY 255 255 240 LAVENDER_BLUSH 255 240 245 PEARL 240 65 14 DARK_PINK 231 84 128 DARK_SCARLET 86 3 25 CRIMSON 220 20 60 CARDINAL 196 30 58 PINK 255 192 203 CARMINE 150 0 24 PALE_PINK 250 218 221 PALE_CHESTNUT 221 173 175 RED 255 0 0 CHESTNUT 205 92 92 PUCE 204 136 153

Raws

[COLOR:AMBER] [NAME:amber] [RGB:255:191:0] [COLOR:AMETHYST] [NAME:amethyst] [RGB:153:102:204] [COLOR:AQUA] [NAME:aqua] [RGB:0:255:255] [COLOR:AQUAMARINE] [NAME:aquamarine] [RGB:127:255:212] [COLOR:ASH_GRAY] [NAME:ash gray] [RGB:178:190:181] [COLOR:AUBURN] [NAME:auburn] [RGB:111:53:26] [COLOR:AZURE] [NAME:azure] [RGB:0:127:255] [COLOR:BEIGE] [NAME:beige] [RGB:245:245:220] [COLOR:BLACK] [NAME:black] [WORD:BLACK] [RGB:0:0:0] [COLOR:BLUE] [NAME:blue] [WORD:BLUE] [RGB:0:0:255] [COLOR:BRASS] [NAME:brass] [RGB:181:166:66] [COLOR:BRONZE] [NAME:bronze] [WORD:BRONZE] [RGB:205:127:50] [COLOR:BROWN] [NAME:brown] [RGB:150:75:0] [COLOR:BUFF] [NAME:buff] [RGB:240:220:130] [COLOR:BURNT_SIENNA] [NAME:burnt sienna] [RGB:233:116:81] [COLOR:BURNT_UMBER] [NAME:burnt umber] [RGB:138:51:36] [COLOR:CARDINAL] [NAME:cardinal] [RGB:196:30:58] [COLOR:CARMINE] [NAME:carmine] [RGB:150:0:24] [COLOR:CERULEAN] [NAME:cerulean] [RGB:0:123:167] [COLOR:CHARCOAL] [NAME:charcoal] [RGB:54:69:79] [COLOR:CHARTREUSE] [NAME:chartreuse] [RGB:127:255:0] [COLOR:CHESTNUT] [NAME:chestnut] [RGB:205:92:92] [COLOR:CHOCOLATE] [NAME:chocolate] [RGB:210:105:30] [COLOR:CINNAMON] [NAME:cinnamon] [RGB:123:63:0] [COLOR:CLEAR] [NAME:clear] [RGB:128:128:128] [COLOR:COBALT] [NAME:cobalt] [RGB:0:71:171] [COLOR:COPPER] [NAME:copper] [WORD:COPPER] [RGB:184:115:51] [COLOR:CREAM] [NAME:cream] [WORD:CREAM] [RGB:255:253:208] [COLOR:CRIMSON] [NAME:crimson] [WORD:CRIMSON] [RGB:220:20:60] [COLOR:DARK_BLUE] [NAME:dark blue] [RGB:0:0:139] [COLOR:DARK_BROWN] [NAME:dark brown] [RGB:101:67:33] [COLOR:DARK_CHESTNUT] [NAME:dark chestnut] [RGB:152:105:96] [COLOR:DARK_GREEN] [NAME:dark green] [WORD:GREEN] [RGB:1:50:32] [COLOR:DARK_INDIGO] [NAME:dark indigo] [RGB:49:0:98] [COLOR:DARK_OLIVE] [NAME:dark olive] [RGB:85:104:50] [COLOR:DARK_PEACH] [NAME:dark peach] [WORD:PEACH] [RGB:255:218:185] [COLOR:DARK_PINK] [NAME:dark pink] [RGB:231:84:128] [COLOR:DARK_SCARLET] [NAME:dark scarlet] [RGB:86:3:25] [COLOR:DARK_TAN] [NAME:dark tan] [RGB:145:129:81] [COLOR:DARK_VIOLET] [NAME:dark violet] [WORD:VIOLET] [RGB:66:49:137] [COLOR:ECRU] [NAME:ecru] [RGB:194:178:128] [COLOR:EMERALD] [NAME:emerald] [RGB:80:200:120] [COLOR:FERN_GREEN] [NAME:fern green] [WORD:GREEN] [RGB:79:121:66] [COLOR:FLAX] [NAME:flax] [RGB:238:220:130] [COLOR:FUCHSIA] [NAME:fuchsia] [RGB:244:0:161] [COLOR:GOLD] [NAME:gold] [WORD:GOLD] [RGB:212:175:55] [COLOR:GOLDEN_YELLOW] [NAME:golden yellow] [RGB:255:223:0] [COLOR:GOLDENROD] [NAME:goldenrod] [RGB:218:165:32] [COLOR:GRAY] [NAME:gray] [RGB:128:128:128] [COLOR:GREEN] [NAME:green] [WORD:GREEN] [RGB:0:255:0] [COLOR:GREEN-YELLOW] [NAME:green-yellow] [WORD:GREEN] [WORD:YELLOW] [RGB:173:255:47] [COLOR:HELIOTROPE] [NAME:heliotrope] [RGB:223:115:255] [COLOR:INDIGO] [NAME:indigo] [RGB:75:0:130] [COLOR:IVORY] [NAME:ivory] [RGB:255:255:240] [COLOR:JADE] [NAME:jade] [WORD:JADE] [RGB:0:168:107] [COLOR:LAVENDER] [NAME:lavender] [RGB:230:230:250] [COLOR:LAVENDER_BLUSH] [NAME:lavender blush] [RGB:255:240:245] [COLOR:LEMON] [NAME:lemon] [RGB:253:233:16] [COLOR:LIGHT_BLUE] [NAME:light blue] [RGB:173:216:230] [COLOR:LIGHT_BROWN] [NAME:light brown] [RGB:205:133:63] [COLOR:LILAC] [NAME:lilac] [RGB:200:162:200] [COLOR:LIME] [NAME:lime] [RGB:204:255:0] [COLOR:MAHOGANY] [NAME:mahogany] [RGB:192:64:0] [COLOR:MAROON] [NAME:maroon] [RGB:128:0:0] [COLOR:MAUVE] [NAME:mauve] [RGB:153:51:102] [COLOR:MAUVE_TAUPE] [NAME:mauve taupe] [RGB:145:95:109] [COLOR:MIDNIGHT_BLUE] [NAME:midnight blue] [WORD:BLUE] [RGB:0:51:102] [COLOR:MINT_GREEN] [NAME:mint green] [WORD:GREEN] [RGB:152:255:152] [COLOR:MOSS_GREEN] [NAME:moss green] [WORD:GREEN] [RGB:173:223:173] [COLOR:OCHRE] [NAME:ochre] [RGB:204:119:34] [COLOR:OLIVE] [NAME:olive] [RGB:128:128:0] [COLOR:ORANGE] [NAME:orange] [RGB:255:165:0] [COLOR:PALE_BLUE] [NAME:pale blue] [WORD:BLUE] [RGB:175:238:238] [COLOR:PALE_BROWN] [NAME:pale brown] [RGB:152:118:84] [COLOR:PALE_CHESTNUT] [NAME:pale chestnut] [RGB:221:173:175] [COLOR:PALE_PINK] [NAME:pale pink] [RGB:250:218:221] [COLOR:PEACH] [NAME:peach] [WORD:PEACH] [RGB:255:229:180] [COLOR:PEARL] [NAME:pearl] [RGB:240:234:214] [COLOR:PERIWINKLE] [NAME:periwinkle] [RGB:204:204:255] [COLOR:PINE_GREEN] [NAME:pine green] [WORD:GREEN] [WORD:PINE] [RGB:1:121:111] [COLOR:PINK] [NAME:pink] [RGB:255:192:203] [COLOR:PLUM] [NAME:plum] [RGB:102:0:102] [COLOR:PUCE] [NAME:puce] [RGB:204:136:153] [COLOR:PUMPKIN] [NAME:pumpkin] [RGB:255:117:24] [COLOR:PURPLE] [NAME:purple] [WORD:PURPLE] [RGB:102:0:153] [COLOR:RAW_UMBER] [NAME:raw umber] [RGB:115:74:18] [COLOR:RED] [NAME:red] [WORD:RED] [RGB:255:0:0] [COLOR:RUSSET] [NAME:russet] [RGB:117:90:87] [COLOR:RUST] [NAME:rust] [WORD:RUST] [RGB:183:65:14] [COLOR:SAFFRON] [NAME:saffron] [RGB:244:196:48] [COLOR:SCARLET] [NAME:scarlet] [RGB:255:36:0] [COLOR:SEA_GREEN] [NAME:sea green] [WORD:GREEN] [WORD:SEA] [WORD:OCEAN] [RGB:46:139:87] [COLOR:SEPIA] [NAME:sepia] [RGB:112:66:20] [COLOR:SILVER] [NAME:silver] [WORD:SILVER] [RGB:192:192:192] [COLOR:SKY_BLUE] [NAME:sky blue] [RGB:135:206:235] [COLOR:SLATE_GRAY] [NAME:slate gray] [RGB:112:128:144] [COLOR:SPRING_GREEN] [NAME:spring green] [RGB:0:255:127] [COLOR:TAN] [NAME:tan] [RGB:210:180:140] [COLOR:TAUPE_DARK] [NAME:dark taupe] [RGB:72:60:50] [COLOR:TAUPE_GRAY] [NAME:taupe gray] [RGB:139:133:137] [COLOR:TAUPE_MEDIUM] [NAME:taupe] [RGB:103:76:71] [COLOR:TAUPE_PURPLE] [NAME:purple taupe] [RGB:80:64:77] [COLOR:TAUPE_PALE] [NAME:pale taupe] [RGB:188:152:126] [COLOR:TAUPE_ROSE] [NAME:rose taupe] [RGB:144:93:93] [COLOR:TAUPE_SANDY] [NAME:sandy taupe] [RGB:150:113:23] [COLOR:TEAL] [NAME:teal] [RGB:0:128:128] [COLOR:TURQUOISE] [NAME:turquoise] [RGB:48:213:200] [COLOR:VERMILION] [NAME:vermilion] [RGB:227:66:52] [COLOR:VIOLET] [NAME:violet] [WORD:VIOLET] [RGB:139:0:255] [COLOR:WHITE] [NAME:white] [WORD:WHITE] [RGB:255:255:255] [COLOR:YELLOW] [NAME:yellow] [WORD:YELLOW] [RGB:255:255:0] [COLOR:YELLOW_GREEN] [NAME:yellow-green] [WORD:GREEN] [WORD:YELLOW] [RGB:154:205:50]

NOTE: Often these number must be expressed in "hexadecimal" (base 16) - do a web search for key words "decimal hex converter", and you should find several. For further information, see this article.