Modding:Color (0.9.9.7) - Revision history

Epyon at 12:34, 11 August 2025

2025-08-11T12:34:09Z

Yaflhdztioxo at 22:40, 21 April 2013

2013-04-21T22:40:59Z

Yaflhdztioxo: moved Modding:Color to Modding:Color (0.9.9.7)

2013-04-21T22:04:40Z

moved Modding:Color to Modding:Color (0.9.9.7)

Yaflhdztioxo: Created page with "In console mode all game tiles are associated with a particular color. Choosing a good color scheme is an important part of modding, but the choice is limited--only 16 colors exi..."

2012-12-08T04:09:05Z

Created page with "In console mode all game tiles are associated with a particular color. Choosing a good color scheme is an important part of modding, but the choice is limited--only 16 colors exi..."

New page

In console mode all game tiles are associated with a particular color. Choosing a good color scheme is an important part of modding, but the choice is limited--only 16 colors exist in the standard [http://en.wikipedia.org/wiki/VGA-compatible_text_mode VGA compatible console] which, when combined into foreground and background, results in only 256 possible combinations. There are some special engine colors as well to further complicate matters.

== Color Definitions ==
{{Template:Color}}

== Special Colors ==
{{Template:Special_Color}}

== Background Colors ==
DoomRL uses 4 bit color. In 4 bit color consoles the lower four bits correspond to the foreground color while the upper four bits correspond to the background color (usually). When you assign a color using the color constants above the upper bits will equal zero, which is the default background color--black. You can change this by explicitly assigning the upper 4 bits a value using code similar to the following:
<source lang="lua">color = LIGHTGRAY + (RED * 16)</source>
The above statement will display <span style="color:silver; background:maroon">light gray text over a red background</span>. Officially this is unsupported. Unofficially it is used often enough that support for it will most likely continue. There is a caveat though--some combinations are used by the [[#Special Colors|special colors]] above and thus cannot be used for regular items.

== Notes and Advice ==
* The [[Manual:color.lua|color.lua]] script can be used by players to customize tiles.
** Many objects have a color_id property that can be used to prevent unscrupulous players from distinguishing between items such as levers by color.
* Colors are not always consistent. Brown in particular can vary a lot and more closely mimics orange in some environments.
* Dark Blue is hard to see on a black background and should be used sparingly, especially with beings who can be frustrating when hard to see.
* Background colors should be used sparingly, if at all. The clear divides break immersion.
* Be aware of common roguelike coloring customs, especially those used by NetHack and (obviously) DoomRL.

@@ Line 11: / Line 11: @@
 === Background Colors ===
-DoomRL uses 4 bit color. In 4 bit color consoles the lower four bits correspond to the foreground color while the upper four bits correspond to the background color (usually). When you assign a color using the color constants above the upper bits will equal zero, which is the default background color--black. You can change this by explicitly assigning the upper 4 bits a value using code similar to the following:
+DRL uses 4 bit color. In 4 bit color consoles the lower four bits correspond to the foreground color while the upper four bits correspond to the background color (usually). When you assign a color using the color constants above the upper bits will equal zero, which is the default background color--black. You can change this by explicitly assigning the upper 4 bits a value using code similar to the following:
 <source lang="lua">color = LIGHTGRAY + (RED * 16)</source>
 The above statement will display <span style="color:silver; background:maroon">light gray text over a red background</span>. Officially this is unsupported. Unofficially it is used often enough that support for it will most likely continue. There is a caveat though--some combinations are used by the [[#Special Colors|special colors]] above and thus cannot be used for regular items.
@@ Line 21: / Line 21: @@
 * Dark Blue is hard to see on a black background and should be used sparingly, especially with beings who can be frustrating when hard to see.
 * Background colors should be used sparingly, if at all. The clear divides break immersion.
-* Be aware of common roguelike coloring customs, especially those used by NetHack and (obviously) DoomRL.
+* Be aware of common roguelike coloring customs, especially those used by NetHack and (obviously) DRL.
 == Color Sets ==
-A color set in DoomRL is an array in the form of '''{ ''red'', ''green'', ''blue'', ''alpha'' }'''.  Each value is a decimal between 0.0 and 1.0, though at present ''alpha'' is not used.
+A color set in DRL is an array in the form of '''{ ''red'', ''green'', ''blue'', ''alpha'' }'''.  Each value is a decimal between 0.0 and 1.0, though at present ''alpha'' is not used.
 === Coscolor ===

@@ Line 1: / Line 1: @@
 In console mode all game tiles are associated with a particular color. Choosing a good color scheme is an important part of modding, but the choice is limited--only 16 colors exist in the standard [http://en.wikipedia.org/wiki/VGA-compatible_text_mode VGA compatible console] which, when combined into foreground and background, results in only 256 possible combinations. There are some special engine colors as well to further complicate matters.
-== Color Definitions ==
+In graphics mode all game tiles are associated with a particular sprite.  The sprites obviously support more than 16 colors. They can also be further manipulated by engine effects, color overlays (both additive and subtractive), and outlines.
 {{Template:Color}}
-== Special Colors ==
+=== Special Colors ===
 {{Template:Special_Color}}
-== Background Colors ==
+=== Background Colors ===
 DoomRL uses 4 bit color. In 4 bit color consoles the lower four bits correspond to the foreground color while the upper four bits correspond to the background color (usually). When you assign a color using the color constants above the upper bits will equal zero, which is the default background color--black. You can change this by explicitly assigning the upper 4 bits a value using code similar to the following:
 <source lang="lua">color = LIGHTGRAY + (RED * 16)</source>
 The above statement will display <span style="color:silver; background:maroon">light gray text over a red background</span>. Officially this is unsupported. Unofficially it is used often enough that support for it will most likely continue. There is a caveat though--some combinations are used by the [[#Special Colors|special colors]] above and thus cannot be used for regular items.
-== Notes and Advice ==
+=== Notes and Advice ===
 * The [[Manual:color.lua|color.lua]] script can be used by players to customize tiles.
 ** Many objects have a color_id property that can be used to prevent unscrupulous players from distinguishing between items such as levers by color.
-* Colors are not always consistent. Brown in particular can vary a lot and more closely mimics orange in some environments.
+* Console colors are not always consistent. Brown in particular can vary a lot and more closely mimics orange in some environments.
 * Dark Blue is hard to see on a black background and should be used sparingly, especially with beings who can be frustrating when hard to see.
 * Background colors should be used sparingly, if at all. The clear divides break immersion.
 * Be aware of common roguelike coloring customs, especially those used by NetHack and (obviously) DoomRL.