Color - Revision history

Doorkeeper: /* Color tokens */

2025-08-09T19:33:41Z

Color tokens

Doorkeeper: /* Color tokens */ changed table layout

2025-08-09T18:52:10Z

Color tokens: changed table layout

Doorkeeper: /* Color tokens */ 52.03 colors

2025-08-09T18:35:58Z

Color tokens: 52.03 colors

Show changes

Zippy: Added image; moved template.

2025-04-21T18:53:27Z

Added image; moved template.

Quietust: alphabetical order

2025-04-05T03:43:09Z

alphabetical order

162.218.226.249: move Olivine's from YELLOW to GREEN in color table

2025-04-05T01:08:36Z

move Olivine's from YELLOW to GREEN in color table

DPhKraken: /* Color tokens */ Loading from raw functions rather than duplicating it here

2025-02-18T01:35:17Z

Color tokens: Loading from raw functions rather than duplicating it here

Show changes

DPhKraken: /* How colors are assigned */ Token links

2025-02-10T04:10:00Z

How colors are assigned: Token links

DPhKraken: /* Color tokens */ Token arguments

2025-02-10T04:03:24Z

Color tokens: Token arguments

DPhKraken: /* Color tokens */ Link typo

2025-02-10T04:02:26Z

Color tokens: Link typo

@@ Line 751: / Line 751: @@
 | style="padding: 0.15em 0.4em" | #7BFF00
 | style="padding: 0.15em 0.4em" |{{Colorramp|#243023|#2c3b1f|#3a4724|#465027|#53592a|#6b6d31|#8c8a46|#b1b362|#d1e879}}
-|- style="color: white; background: rgb(80, 229, 0)"
+|- style="color: black; background: rgb(80, 229, 0)"
 | style="padding: 0.15em 0.4em; text-align: left" | BRIGHT_GREEN
 | style="padding: 0.15em 0.4em" | 80
@@ Line 765: / Line 765: @@
 | style="padding: 0.15em 0.4em" | #19B211
 | style="padding: 0.15em 0.4em" |{{Colorramp|#24252B|#272C30|#2B3636|#32463B|#39553C|#437343|#4B924C|#63AE65|#BAE0A4}}
-|- style="color: white; background: rgb(55, 229, 45)"
+|- style="color: black; background: rgb(55, 229, 45)"
 | style="padding: 0.15em 0.4em; text-align: left" | ZESTY_GREEN
 | style="padding: 0.15em 0.4em" | 55
@@ Line 786: / Line 786: @@
 | style="padding: 0.15em 0.4em" | #0F9931
 | style="padding: 0.15em 0.4em" |{{Colorramp|#242328|#242628|#242C2E|#2A3635|#324D3B|#3C6541|#71965F|#80AE6C|#AED497}}
-|- style="color: white; background: rgb(0, 204, 51)"
+|- style="color: black; background: rgb(0, 204, 51)"
 | style="padding: 0.15em 0.4em; text-align: left" | GRASS_GREEN
 | style="padding: 0.15em 0.4em" | 0
@@ Line 793: / Line 793: @@
 | style="padding: 0.15em 0.4em" | #00CC33
 | style="padding: 0.15em 0.4em" |{{Colorramp|#242E28|#273828|#324929|#3E572F|#577042|#598947|#7AAC62|#8FC574|#B5E1A0}}
-|- style="color: white; background: rgb(25, 255, 82)"
+|- style="color: black; background: rgb(25, 255, 82)"
 | style="padding: 0.15em 0.4em; text-align: left" | VIBRANT_GREEN
 | style="padding: 0.15em 0.4em" | 25
@@ Line 931: / Line 931: @@
 | style="padding: 0.15em 0.4em" | #7FFFD4
 | style="padding: 0.15em 0.4em" |{{Colorramp|#2a3036|#2d484a|#3b5e5d|#456e6a|#508079|#69a490|#88beac|#a7cec2|#dbe9e3}}
-|- style="color: white; background: rgb(25, 255, 220)"
+|- style="color: black; background: rgb(25, 255, 220)"
 | style="padding: 0.15em 0.4em; text-align: left" | SEA_FOAM
 | style="padding: 0.15em 0.4em" | 25
@@ Line 952: / Line 952: @@
 | style="padding: 0.15em 0.4em" | #00FFFF
 | style="padding: 0.15em 0.4em" |{{Colorramp|#26293d|#323e55|#3d5168|#486178|#56758d|#6793a3|#87aebd|#a6c2ce|#dbe6e9}}
-|- style="color: white; background: rgb(25, 220, 255)"
+|- style="color: black; background: rgb(25, 220, 255)"
 | style="padding: 0.15em 0.4em; text-align: left" | GLACIER_BLUE
 | style="padding: 0.15em 0.4em" | 25
@@ Line 1,018: / Line 1,018: @@
 | style="padding: 0.15em 0.4em" | #3D8BCC
 | style="padding: 0.15em 0.4em" |{{Colorramp|#241F2F|#24283E|#282E49|#354061|#425275|#56708F|#7088A4|#9CABC1|#C8D1D9}}
-|- style="color: white; background: rgb(76, 174, 255)"
+|- style="color: black; background: rgb(76, 174, 255)"
 | style="padding: 0.15em 0.4em; text-align: left" | CORNFLOWER
 | style="padding: 0.15em 0.4em" | 76

@@ Line 175: / Line 175: @@
 The following colors are grouped according to their corresponding display color in ASCII mode. Hexadecimal color values are not used in the raws, but correspond to the RGB values that are. For further information, see the Wikipedia article on [[wikipedia:Web colors|web colors]].
-{| style="margin: 1em auto; border-spacing: 0"
+{| style="margin: 1em 0; border-spacing: 0"
 |- style="vertical-align: top; padding: 0 1em"
+|
-{| style="text-align: right; border-spacing: 0 1px; margin: 0 auto; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
+{| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''DGRAY colors'''
 |- style="background: {{fgcolor|0:1}}"
@@ Line 214: / Line 214: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#27201e|#2b2726|#322f2e|#3c3835|#453e3a|#5d544d|#6b6058|#7e7269|#c1b7a3}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''LGRAY colors'''
@@ Line 236: / Line 238: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#2e2d34|#3a393f|#48464c|#56545b|#68666b|#838482|#9f9e99|#bebdb0|#f2f1f1}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''WHITE colors'''
@@ Line 279: / Line 282: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#2f2c32|#483e47|#604f5f|#775e76|#8c6d8a|#ae84ac|#ba98b7|#c7adc6|#e9dae5}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''RED colors'''
@@ Line 399: / Line 404: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#22222c|#322933|#442b35|#4e2c36|#592e37|#712c2a|#963a2e|#c44935|#d8957a}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''LRED colors'''
@@ Line 477: / Line 483: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#401c2b|#4d252d|#612c2c|#6b3734|#743f3c|#96433d|#ae3f35|#cd4835|#e79a91}}
 |}
+|
-{| style="text-align: right; border-spacing: 0 1px; margin: 0 auto; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
+{| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''BROWN colors'''
 |- style="background: {{fgcolor|6:0}}"
@@ Line 577: / Line 584: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#252823|#2c2f2a|#34382b|#424637|#555542|#696f48|#8d8c56|#aaa371|#d4d1a9}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''YELLOW colors'''
@@ Line 676: / Line 684: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#2c2f30|#3f3e33|#55503c|#636341|#707649|#91a258|#bacf71|#d1f082|#f2fadc}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''GREEN colors'''
@@ Line 726: / Line 736: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#25292B|#2A3030|#2B3431|#334234|#44533E|#5A6F4D|#6B8B58|#84A871|#BAD6A9}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''LGREEN colors'''
@@ Line 818: / Line 829: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#1c1a2d|#212034|#26253a|#2b2b41|#33334f|#40415d|#4e4f6a|#686988|#aaaabe}}
 |}
+|
-{| style="text-align: right; border-spacing: 0 1px; margin: 0 auto; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
+{| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''CYAN colors'''
 |- style="background: {{fgcolor|3:0}}"
@@ Line 897: / Line 909: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#2c2c30|#383336|#473e40|#524446|#5a494b|#6d5452|#8a6763|#a07c6b|#ccb299}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''LCYAN colors'''
@@ Line 961: / Line 974: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#302c32|#473b43|#5a4755|#705569|#825d79|#a6759b|#b288a9|#c09eb8|#e6d4de}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''BLUE colors'''
@@ Line 1,074: / Line 1,089: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#241F3B|#241F56|#243168|#243E7B|#275496|#3E83B9|#5D98C5|#78A5CD|#BBD0DB}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''LBLUE colors'''
@@ Line 1,124: / Line 1,140: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#2b2325|#393031|#4b3b3c|#5f494c|#6d5254|#886669|#94787a|#a18b8d|#c2b7b7}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''MAGENTA colors'''
@@ Line 1,202: / Line 1,220: @@
 | style="padding: 0.15em 0.4em" |{{Colorramp|#2c252c|#3d3139|#4e3f49|#634d5e|#73576c|#8f6c87|#9c7f95|#aa92a4|#ccbfc6}}
 |}
 {| style="text-align: right; border-spacing: 0 1px; margin: 1em auto 0; background: black; border-left: 1px solid black; border-right: 1px solid black; width: 100%"
 |+ '''LMAGENTA colors'''

@@ Line 1: / Line 1: @@
 {{Quality|Exceptional}}
 {{av}}
 : {{for/see|an overview of graphics in Dwarf Fortress|[[Graphics]]}}
 : {{for/see|user-compiled colors|[[color scheme]]}}
 : {{for/see|lists of the colors of materials, professions, creatures, etc.|[[Color#Color lists|the "Color Lists" at the bottom of this page]]}}
-[[File:palettes_v50.png|right]]''Dwarf Fortress'' can use roughly 8424 '''colors''' to give many tiles such as foregrounds, backgrounds and sprites different colors. These colors make up the [[color scheme]]. Which of these colors are assigned to a given tile is often decided by values in its raw file. Whether a pixel shows foreground, background, black or anything in between is influenced by its brightness and opacity. These colors are shown at the right:
+[[File:color_preview.png|180px|right]]''Dwarf Fortress'' can use roughly 8424 '''colors''' to give many tiles such as foregrounds, backgrounds and sprites different colors. These colors make up the [[color scheme]]. Which of these colors are assigned to a given tile is often decided by values in its raw file. Whether a pixel shows foreground, background, black or anything in between is influenced by its brightness and opacity. These colors are shown at the right:
 The original game used a simplistic 16-color palette, with 8 of those colors: black, blue, green, cyan, red, purple, yellow, grey, and a lighter version of those colors creating a total of 16. The game also has an option to use the classic ASCII visuals, mimicking the classic version of the game by using 16 colors. Even with the updated graphics turned on, the text in the GUI still references the color scheme. Color is also used to express various information, from a dwarf's [[profession]], to the natural color of a terrain feature, to the material an item is made of.
@@ Line 13: / Line 11: @@
 == Overview ==
 === The tileset influences color display ===
 [[File:Tileset-color-processing.png|300px|thumb|right]]
 In the simplest case, a pixel on a tileset is either white (foreground) or transparent* (background). However, black, and anything in between is possible as well (even color):
@@ Line 44: / Line 45: @@
 -->
 == How colors are assigned ==
 Colors of [[Status icon]]s, [[profession]]s, text and the [[interface]] in general are hardcoded. [[Item]]s, [[furniture]], [[construction]]s, and geographic features get the color of their [[material]]. Dyes and material contaminants use color tokens.

@@ Line 1,182: / Line 1,182: @@
 |-valign="top"
 |{{Raw Tile|•|2:0}} GREEN
-|[[Serpentine]], [[Olivine]]
+|[[Olivine]], [[Serpentine]]
 |[[Malachite]]
+|

@@ Line 1,164: / Line 1,164: @@
 |-valign="top"
 |{{Raw Tile|•|6:1}} YELLOW
-|[[Brimstone]], [[Orpiment]], [[Orthoclase]], [[Saltpeter]], [[Sylvite]], [[Gypsum]], [[Olivine]]
+|[[Brimstone]], [[Orpiment]], [[Orthoclase]], [[Saltpeter]], [[Sylvite]], [[Gypsum]]
 |[[Limonite]], [[Native gold]]
 |[[Gold]], [[Bismuth bronze]], [[Brass]], [[Electrum]]
@@ Line 1,182: / Line 1,182: @@
 |-valign="top"
 |{{Raw Tile|•|2:0}} GREEN
-|[[Serpentine]]
+|[[Serpentine]], [[Olivine]]
 |[[Malachite]]
+|

@@ Line 48: / Line 48: @@
 Colors of [[Status icon]]s, [[profession]]s, text and the [[interface]] in general are hardcoded. [[Item]]s, [[furniture]], [[construction]]s, and geographic features get the color of their [[material]]. Dyes and material contaminants use color tokens.
 ===Wall and floor color===
-[[image:Towercaps-sandy.jpg|thumb|[[Phyllite]] (to the left) has DISPLAY_COLOR:0:7:1 and BASIC_COLOR:7:0.  The [[white sand]] present has DISPLAY_COLOR:7:6:1 and so the actual floor color is 7:1 (white).]]
+[[image:Towercaps-sandy.jpg|thumb|400px|[[Phyllite]] (to the left) has {{token|DISPLAY_COLOR|md|0:7:1}} and {{token|BASIC_COLOR|md|7:0}}.  The [[white sand]] present has {{token|DISPLAY_COLOR|md|DISPLAY_COLOR:7:6:1}} and so the actual floor color is ``7:1`` (white).]]
 While the foreground, background and brightness shown in the [[Material definition token|RAW]] files will be applied to [[wall]]s, the [[stone|mineral]]'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 the {{token|BASIC_COLOR|md}} tag is specified, it will use that color.  Note that the {{token|BASIC_COLOR|md}} tag only has foreground and brightness as arguments.
-* If BASIC_COLOR is left out:
+* If {{token|BASIC_COLOR|md}} 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 gray, color 8 (in other words, color 0 with brightness 1).
-This is effective for [[stairs]], [[floor]]s, [[ramp]]s, and [[construction]]s (in the case of stone).  When stone is [[engraving|engraved]], it uses the material's TILE_COLOR (which is the same as the DISPLAY_COLOR unless overridden).
+This is effective for [[stairs]], [[floor]]s, [[ramp]]s, and [[construction]]s (in the case of stone).  When stone is [[engraving|engraved]], it uses the material's {{token|TILE_COLOR|md}} (which is the same as the {{token|DISPLAY_COLOR|md}} unless overridden).
 === Color values ===
-Colors are primarily defined using the [COLOR:x:y:z] or [DISPLAY_COLOR:x:y:z] tokens. The three arguments are:
+Colors are primarily defined using the {{token|COLOR|c|x:y:z}} or {{token|DISPLAY_COLOR|md|x:y:z}} tokens. The three arguments are:
 # Foreground color [0-7]
@@ Line 161: / Line 161: @@
 ::::''(* See [[color scheme]] for information about how to change the actual various colors as displayed.)''
-Sometimes the color numbers are part of another token, e.g. <code>[LEAVES:quarry bush leaf:quarry bush leaves:6:7:0:0:0:0:1:LOCAL_PLANT_MAT:LEAF]</code> specifies the colors "7:0:0" for quarry bush leaves and "0:0:1" for wilted quarry bush leaves.
+Sometimes the color numbers are part of another token, e.g. {{token|LEAVES|plant|quarry bush leaf:quarry bush leaves:6:7:0:0:0:0:1:LOCAL_PLANT_MAT:LEAF}} specifies the colors ``7:0:0`` for quarry bush leaves and ``0:0:1`` for wilted quarry bush leaves.
 ====Values 8-15====

@@ Line 171: / Line 171: @@
 === Color tokens ===
-When in graphics mode, most things do not use color flags. Instead, they reference [[Descriptor color token|color tokens]] defined in ``descriptor_color_standard.txt``. Color tokens are referenced by their token name, e.g. {{token|STATE_COLOR|md|SOLID|DARK_GREEN}} or {{token|POWDER_DYE|md|EMERALD}}. The defined RGB values are not displayed in-game; instead, it assigns colors in the sprite from the top row of the palette file (see [[Graphics#Palettes]]) to the row defined in ``data/vanilla/vanilla_descriptors_graphics/graphics/palette_default.txt``, or any user-defined palette objects.
+When in graphics mode, most things do not use color flags. Instead, they reference [[Descriptor color token|color tokens]] defined in ``descriptor_color_standard.txt``. Color tokens are referenced by their token name, e.g. {{token|STATE_COLOR|md|SOLID:DARK_GREEN}} or {{token|POWDER_DYE|md|EMERALD}}. The defined RGB values are not displayed in-game; instead, it assigns colors in the sprite from the top row of the palette file (see [[Graphics#Palettes]]) to the row defined in ``data/vanilla/vanilla_descriptors_graphics/graphics/palette_default.txt``, or any user-defined palette objects.
 The following colors are grouped according to their corresponding display color in ASCII mode. Hexadecimal color values are not used in the raws, but correspond to the RGB values that are. For further information, see the Wikipedia article on [[wikipedia:Web colors|web colors]].