User Interface Design

TRASE ProjectSoftware Engineering

Fall 2008

Configuration File (1)[GameBoard]

; Number and names of continents on the game board; The number of names listed shall match the number of continents; If the number of continent names does not match the number of continents,; the program will display an error, print the default config file, and exit.NumberOfContinents = 2NamesOfContinents = EndorNumenor

; Number and names of territories on the game board; The number of names listed shall match the number of territories; If the number of territory names does not match the number of territories,; the program will display an error, print the default config file, and exit.NumberOfTerritories = 7NamesOfTerritories =AndustarHarlindonForostarMittalmarMinhiriathOrrostarForodwraith

Configuration File (2); Matrix to represent territory adjacencies; This is a square matrix with the size equal to the number of territories; At each intersection, a 1 represents a connection between the intersecting; territories, and a 0 represents the lack of a connection between the; intersecting territories; Example:; 0 1 1; 1 0 0; 1 0 0; This adjacency matrix shows that territory 0 is connected to territory; 1 and territory 2. Territory 2 only connects to territory 1, and territory; 3 only connects to territory 1.; In general, if matrix[i][j] == 1, then territory i is connected to territory j.; NOTE: The matrix should be symmetrical about the upper-left to lower-right diagonal; The diagonal should contain all 0s.TerritoryAdjacencyMatrix =0 1 0 0 1 1 01 0 1 0 0 0 00 1 0 1 1 1 10 0 1 0 1 0 01 0 1 1 0 0 11 0 1 0 0 0 00 0 1 0 1 0 0

Configuration File (3); Matrix to represent territories contained within each continent; This is not a square matrix. The number of rows is equal to the number of; continents. The number of columns is equal to the number of territories.; Thus, rows are continents and columns are territories.; At each intersection, a 1 means that the territory is a member of that continent.; A 0 means that the territory is not a member of that continent.; Example: (2 continents, 3 territories); 0 1 1; 1 0 0; This means that continent 0 contains territories 1 and 2. Continent 1 contains; territory 0.; NOTE: A territory may only be the member of one continent. Thus, each column; of this matrix will contain a single 1; the rest of the rows for that column will; contain a 0.ContinentMatrix =0 1 0 0 1 0 11 0 1 1 0 1 0

; Reinforcement bonuses awarded for possession of each continent; The continents are listed in order (from continent 0 to continent x); The number for each continent represent the bonus reinforcements; awarded to the player at the beginning of their turn for the ownership; of all the territories which comprise the continent.ContinentReinforcement =2 4

Configuration File (4)[AI]

; Specifies the number of players to be defined.NumberOfPlayers = 4

; AI behavior is controlled by the strategies assigned to the AI; An AI is created by specifying (in order) the types of each strategy; Alliances may also be specified if desired.; ; Strategies (listed in order): Alliance, Card, Defense, Fortification, Offense; Strategy types: A = Aggressive, C = Conservative, R = Random; Numbers following Strategies denote allies (by player number); - Player number is determined by order listed, starting with 1; - Self-alliances will be ignored.; Example: A C R A C 2; - This player has an aggressive Alliance Strategy, conservative Card Strategy,; random Defense Strategy, aggressive Fortification Strategy, and conservative; Offense Strategy. This player is allied with player 2.; NOTE: The number of players specified here (i.e. the number of rows here); shall match the NumberOfPlayers specified above.Players =A A A A A 2A C C C A 1R R R R R 4C C R R R 3

Configuration File (5)[Statistics]

; (1 = Print, 0 = Do Not Print)

; >>Turn by Turn<< (Printed at end of each player's turn)

; List of continents owned by the playerContinentsOwned = 1

; Number of territories owned by player in each continentNumberOfTerritoriesPerContinent = 1

; Total number of territories owned by playerNumberOfPlayerTerritories = 1

; Number of Risk cards currently held by playerNumberOfRiskCards = 1

; Strength of player, based on current reinforcement potential w/o cardsPlayerStrength = 1

Configuration File (6); >>End of Game<< (Printed at the end of the game)

; First continent occupied for an entire roundFirstContinentOccupied = 1

; First player to occupy continent for an entire roundFirstContinentOccupier = 1

; Number of times a territory was occupied (i.e. changed hands) during the gameNumberOfTerritoryOccupations = 1

; For each continent, largest number of units in a territory in that continentLargestTerritoryGarrison = 1

Command Line Usage Message

Usage: java TRASE [arguments]

Arguments: -h Print this help message and create a sample config file -d Run in debug mode (detailed report of every decision made) -f FILENAME Specify the configuration file

Examples java TRASE -f configfile.dat -d java TRASE -h

Console OutputGame ConfigurationConfiguration file: configfile.txt

Game Initialization

Round 1

Round 2

Player 2 eliminated.

Round 3

...

Round 7

Player 3 wins.

Game EndDebug Report: report_debug.txtTurn Report: report_turn.txtGame Report: report_turn.txt

Note: This console output will only appear in debug mode. In normal mode the only console output will be error messages.

Turn ReportTRASE turn reportCreated on 23/10/2008 at 22:30:14

Turn #,Player #,Total # Territories Owned,# Cards,Strength,# of Territories Owned in Asia,# of Territories Owned in Australia,# of Territories Owned in Europe,# of Territories Owned in Africa,# of Territories Owned in South America,# of Territories Owned in North America,Continents Owned0,0,13,0,4,4,1,3,2,1,2,0,1,12,0,4,4,1,3,2,1,2,0,2,12,0,4,4,1,3,2,1,2,1,0,13,1,4,4,1,3,2,1,2,1,1,15,1,4,4,1,3,2,1,2,Australia1,2,11,0,3,4,1,3,2,1,2,2,0,13,2,4,4,1,3,2,1,2,Australia2,1,16,2,5,4,1,3,2,1,2,2,2,10,0,3,4,1,3,2,1,2,South America

End of Game ReportTRASE End of Game Reportcreated on 23/10/2008 at 23:16:26

Game winner: 2First continent occupied: AustraliaPlayer to occupy the first continent: 0Turn of first continent occupied: 1Largest number of troops ever in one territory: 65Territory with largest number of troops: SiamTurn of largest number of troops on one territory: 9Number of times each territory changed hands:

Asia-Siam 3-Ural 1-Japan 1-China 3-etc. 3

Africa-Madagascar 2-North Africa 6-Ethopia 3-etc. 7

Debug Report (1)-Game Configuration -----------------------------------------------------------

Configuration file: E:\configfile.txt

Number of players: 4

Player 1:Aggressive Card StrategyAggressive Offensive StrategyAggressive Defensive StrategyAggressive Fortification StrategyAggressive Alliance StrategyAlliances: 2 4

Player 4:Aggressive Card StrategyConservative Offensive StrategyAggressive Defensive StrategyRandom Fortification StrategyRandom Alliance StrategyAlliances: 1

Debug Report (2)-Game Initialization ----------------------------------------------------------

Initial Territory Distribution1: 01 04 10 15 20 252: 02 03 06 17 19 26

Initial Troop DistributionC01: 5C02: 1C03: 4C04: 1

Debug Report (3)-Round 1 ----------------------------------------------------------------------

- Player 1 Turn

Cards: A C C I

No cards turned in.

Total reinforcements: 12

Reinforcement placementC04: 1C10: 5C25: 6

Invade C04 with 5 troops (owned by P02)P01 -1P02 -1P01 wins

Move 3 troops from C01 to C04

- Player 2 Turn....

Debug Report (4)-Round 15 ---------------------------------------------------------------------

Player 4 eliminated.

Game over.

-Game End ---------------------------------------------------------------------

Winner: Player 2

Debug Report: E:\report_debug.txtTurn Report: E:\report_turn.txtGame Report: E:\report_turn.txt