Introduction
This document explains how to add a new set of stack markers to Colossus.
Requirements
To add a new set you'll need to supply:
- A new Color, preferably one that cannot be confused with any other, and
that cannot be confused with the Masterboard Hexes.
- A two-letter identifier for the Color, that cannot be confused with any
other (see the file
net/sf/colossus/server/Constants.java
, the two variables
colorNames
and
shortColorNames
). It's better if it's meaningful, as it is displayed to the
player(s).
- A single letter color mnemonic used for Color selection. Must be
unique. See again
net/sf/colossus/server/Constants.java
, array
colorMnemonics
.
- Twelve 56x56 GIF or PNG files (see
Default/MarkersName
). Names must be the 2-letter color description followed by the marker
number (between 01 and 12), with the
.gif
or
.png
extension (lowercase) matching the image type.
Adding the set
- Add the color to
net/sf/colossus/util/HTMLColor.java
as a static member. The name must be the full color name with a
Colossus
suffix.
- Add the color name, short name and mnemonic to
net/sf/colossus/server/Constants.java
, in the three relevant arrays (
colorNames
,
shortColorNames
and
colorMnemonics
). Note that the order is important : the AI will choose the first 6 colors
before the others, and the order must be the same in all three arrays.
- Add the image files to the
Default/images/
directory.
- Add the names in
Default/MarkersName
; each name must be associated to the corresponding short description
(2-letter + number).
- Increment the
MAX_MAX_PLAYERS
constants in
net/sf/colossus/server/Constants.java
.
The Titan Chit is colored on the fly using the color specified in the
HTMLColor
file, so you don't have to worry about it.