ttrts/README.md

# TTRTS
*The Tiny Terminal RTS where the players write their AIs*

------------------------------------------------------------------------------------
## Introduction
We aim to create a simple terminal based rts where a user can program an AI to control their army

------------------------------------------------------------------------------------
## Gameplay
1. TTRTS clients are run from the command line
2. clients will connect and confirm initial board state
 1. clients output a text file with game data for this turn
 2. a player, or program, reads the game data file and outputs an instructions file
 3. clients read the instructions file, simulates the turn 
 4. game state is verified between clients and output
 5. repeat until an end state is reached
3. once game is finished, host and clients disconnect and a winner is notified

*see [the game directory](game) for full game rules*

------------------------------------------------------------------------------------
## Source


### Targets
##### ttrts
Main TTRTS executable , runs from the command line and can act as host or client

##### ttrts-test
Test executable, to be compiled and run to test various functionality

##### player
Custom player AI code, this should contain examples and test code to help newcomers begin their journey


### Libraries
##### game
Implementation of the RTS rules and simulation. [game](game) has full information on it's implementation.

##### net
Net code for hosting the server and communicating with clients

##### ui
Wrapper for user interface for the terminal, this only really needs three stages
* Initialise the game with settings and connect the clients
* Run the game simulation to it's conclusion
* Display the game result
* Acsii Colour wrapper for separate teams 

##### maths
simple maths library for 2D calculations and types