## 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.