mdiluz/ttrts
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Even more cleanup and removal of legacy code

Browse source
This commit is contained in:
Marc Di Luzio 2014-12-18 13:58:21 +00:00
parent 157e6285eb
commit 5a56a400c5
8 changed files with 40 additions and 182 deletions

58
README.md
View file

@ -1,55 +1,17 @@
# 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
A simple terminal based RTS game that uses txt files to communicate game state and unit commands. TTRTS was
------------------------------------------------------------------------------------
-------------------------------------------------------------------------------
## Gameplay
1. ttrts clients are run from the command line
2. ttrts-server is launched from the command line
3. clients will connect to server 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 server
5. repeat until an end state is reached
4. once game is finished, host and clients disconnect and a winner is notified
*see [game](game) for full game rules*
------------------------------------------------------------------------------------
## Source
### Targets
##### ttrts
Main TTRTS executable , runs from the command line and acts as client
##### ttrts-server
TTRTS server executable, runs from the command line acting as server
##### player
Custom player AI code, this should contain examples and test code to help newcomers begin their journey
##### ttrts-test
Test executable, to be compiled and run to test various functionality
### 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
* ASCII Colour wrapper for separate teams
##### maths
simple maths library for 2D calculations and types
1. The ttrts client is run from the command line with initial parameters
2. The client outputs a gamestate text file
3. A player, program or cat reads the state and outputs instructions for their units.
4. The client reads in instructions and processes the turn
5. If no winner is reached, skip back to step 2
6. The game client outputs a final summary file with the winner
*see [game](game) for full game rules*