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 PNG files (see
Default/MarkersName
). Names must be the 2-letter color description followed by the marker
number (between 01 and 12), with the .png extension (lowercase).
Note that the colored part of your images should be transparent white
rather than your color, because we support changing the color of
markers on the fly (for when they're captured).
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 and Angel chits are colored on the fly using the color specified in
the HTMLColor
file, so you don't have to worry about them.