Color is used to express various information, from a dwarf's profession, over the natural color of a terrain feature to the material an item is made of.
You may be looking for Color schemes, which contains color schemes different from DF's default.
Modding color
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:
- Foreground color [0-7]
- Background color [0-7]
- Brightness of the foreground color [0 or 1]
The brightness of the background color is always 0.
The following colors can be 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
|
|
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.
There's also a one-argument form of the COLOR
flag used to define the color of gems. In that case the argument is the foreground color, the background color is variable and the brightness of gems is always 1.
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]
.
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
|
PUMPKIN
|
255
|
117
|
24
|
CHOCOLATE
|
210
|
105
|
30
|
TAUPE
|
188
|
152
|
126
|
COPPER
|
184
|
115
|
51
|
DARK_PEACH
|
255
|
218
|
185
|
SEPIA
|
112
|
66
|
20
|
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
|
GOLDENROD
|
218
|
165
|
32
|
DARK_TAN
|
145
|
129
|
81
|
AMBER
|
255
|
191
|
0
|
SAFFRON
|
244
|
196
|
48
|
FLAX
|
238
|
220
|
130
|
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
|
GREEN-YELLOW
|
173
|
255
|
47
|
CHARTREUSE
|
127
|
255
|
0
|
FERN_GREEN
|
79
|
121
|
66
|
MOSS_GREEN
|
173
|
223
|
173
|
|
Token
|
RGB
|
MINT_GREEN
|
152
|
255
|
152
|
GREEN
|
0
|
255
|
0
|
EMERALD
|
80
|
200
|
120
|
SEA_GREEN
|
46
|
139
|
87
|
DARK_GREEN
|
1
|
50
|
32
|
JADE
|
0
|
168
|
107
|
AQUAMARINE
|
127
|
255
|
212
|
PINE_GREEN
|
1
|
121
|
111
|
TURQUOISE
|
48
|
213
|
200
|
PALE_BLUE
|
175
|
238
|
238
|
TEAL
|
0
|
128
|
128
|
AQUA
|
0
|
255
|
255
|
CERULEAN
|
0
|
123
|
167
|
MIDNIGHT_BLUE
|
0
|
51
|
102
|
AZURE
|
0
|
127
|
255
|
SLATE_GRAY
|
112
|
128
|
144
|
COBALT
|
0
|
71
|
171
|
BLUE
|
0
|
0
|
255
|
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
|
PLUM
|
102
|
0
|
102
|
FUCHSIA
|
244
|
0
|
161
|
MAUVE
|
153
|
51
|
102
|
WHITE
|
255
|
255
|
255
|
LAVENDER_BLUSH
|
255
|
240
|
245
|
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
|
|