<?xml version="1.0" encoding="iso-8859-1"?> <html> <head> <meta name="generator" content="HTML Tidy for Linux/x86 (vers 1st July 2002), see www.w3.org" /> <!-- $Id: Variant-HOWTO.html 3678 2009-02-28 13:54:07Z dolbeau $ --> <title>Colossus Variant HOWTO</title> </head> <body> <P> <h2>The Variant Pack</h2> <P> <h4>How do I use a Variant Pack ?</h4> Just use the <b>Load External Variant</b> button and open the XML-based <b>VAR</b> file inside the variant directory, then start a new game. That should be enough. Alternatively, many variants are now supplied in the standard distribution ; simply use the pop-up menu to select which variant to play ( <b>Default</b> is the Classic Titan ruleset). <h4>What's in a Variant Pack ?</h4> A Variant Pack should be a directory (folder) containing: <ul> <li>A mandatory XML-based <b>VAR</b> file, that describes the other files</li> <li> Optionals XML-based <b>CRE</b> , XML-based <b>TER</b> and XML-based <b>MAP</b> files that describe the variant</li> <li>An optional <b>Battlelands</b> subdirectory that contains the new and/or changed Battlelands</li> <li>An optional <b>images</b> subdirectory that contains the new and/or changed pictures.</li> <li>A mandatory <b>Hint</b> Java source file that helps the AI play your variant. This is <b>required</b> if you have non-standard Tower numbers. (If you don't know Java, ask for help on the colossus-developers list.) </ul> The various files are either XML-based or Java code, and at the moment there is no proper description of the formats. Sorry. <h4>How do I create a Variant Pack ?</h4> There's no user-friendly way yet. The easiest way is to build the directory and copy the default files in it, then you can change them with any text editor. Warning: almost no sanity checks are performed, and some combinations might give strange and/or unexpected results, particurly in Battlelands (slope next to a tree, or cliff between two bogs...). Also, ensuring consistency between the files is up to the variant author. Battlelands can also be created using the graphical tool <b>BattlelandsBuilder</b> . There may be an easier (read: graphical) way later for <b>CRE</b> , <b>TER</b> and <b>MAP</b> files, but don't hold your breath, as nobody is working on it yet.<p> You can also use other variants as examples: <ul> <li> The Default variant represent the default rules set. It's a good starting point to undesrtand the file format, and all the files in there can be used from any variant, you only have to point at their names (in the XML-based VAR file), or for images and Battlelands, it's automatic. <li> The variants starting in TG only replace the Battlelands, it's the easiest of all the possible modifications. Create the directories, add a README or README.html file, copy the DefaultVar.xml file and change the name (the XML tag name in the variant element). Now, you only have to create new Battlelands with BattlelandsBuilder and put them in the Battlelands subdirectory. NOTE: For the Battlelands to work, the filename and the terrain attribute of the Battlelands element must match one of the default Titan Battelands. Again, use one of the TG variants as an example. <li> The variant Badlands also modify the content of the masterboard to exploit a larger number of Battlelands. This means using modifying the XML-based MAP file, modifying the XML-based TER file (to include the new terrains), and adding a Hint implementation for the AI to exploit intelligently (well, not excessively dumbly, anyway) the new terrains. <li> The variant ExtTitan uses a larger masterboard, and new creatures, thus requiring a XML-based CRE file and new images. The Battelands are the default ones here. <li> Some variants (like Abyssal6) basically extends everything using the default rules. This is the harder of the 'reasonably safe to use' level of variants. <li> Finally, there is Balrog. This one implements some of the Java interface of the code to alter the basic Titan ruleset. An advice: before trying to do the same, contact the developers on the mailing-list and discuss your ideas, because that kind of variant is very hard to create and even harder to maintain (that's why there's only one yet). </ul> <h2>Frequently Asked Questions</h2> <ul> </ul> </body> </html>