_____           _        _                          
 |  __ \         | |      | |                         
 | |__) |__  _ __| |_ __ _| |___                      
 |  ___/ _ \| '__| __/ _` | / __|                     
 | |  | (_) | |  | || (_| | \__ \                     
 |_|   \___/|_|   \__\__,_|_|___/                     
					   _____           _        _     
			   ___    |  __ \         | |      | |    
			  ( _ )   | |__) |__  _ __| |_ __ _| |___ 
			  / _ \/\ |  ___/ _ \| '__| __/ _` | / __|
			 | (_>  < | |  | (_) | |  | || (_| | \__ \
			  \___/\/ |_|   \___/|_|   \__\__,_|_|___/
			  
			  
	  
===========================================================================

README

V1.0 (Released 19th Aug 2017)
                                   
===========================================================================

TABLE OF CONTENTS

	1)	Introduction
	2)	Running Instructions
	3)	Features
	4)	Known Issues

===========================================================================

1)	Introduction
	------------

	A modern adaptation of the popular board game “Snakes and Ladders”, 
	Portals & Portals is set to shake up family time with hours of gameplay
	that will keep you on the edge! Snakes away - portals will make or 
	break your journey to the top as you attempt to traverse the gruelling 
	40 tile gameboard to win the ultimate prize and become the portal 
	master! Each portal is connected regenerating randomly at anytime and
	anywhere, warping players between connected tiles that will leave 
	players with the bitter taste of despair or an over-inflated sense 
	of achievement as victory nears. Face off against your friends in 
	multiplayer mode or take on the ruthless AI bot army - you will 
	surely not be able to put this game back in the box!

===========================================================================

2)	Running Instructions
	------------

	User must have Python 3.0 or above installed

	By default, text mode can be explicitly ran using:
	
		a) Run Command Prompt (cmd)
		b) Execute "Python [dir]\Portals.py"
	
	To launch the graphical user interface:
	
		a) Run Command Prompt (cmd)
		b) Execute "Python [dir]\Portals.py -g"
	
	Failing to append the -g command will cause the program to run in text
	mode.

===========================================================================

3)	Features
	------------

	The below noted features have been delivered as part of v1.0
	
	[Feature-1] Menu
	[Feature-2] Player Setup
	[Feature-4] Game Board Initiation
	[Feature-5] Game Board Rendering
	[Feature-6] Die Roll and Randomisation
	[Feature-7] Determine order of players with dice roll
	[Feature-8] Define Game Board Rules
	[Feature-9] Create Game Board Logic
	[Feature-10] Player advancement on board
	[Feature-11] Placement of Portals
	[Feature-12] Portal Logic
	[Feature-13] Define End Game Conditions (win / withdraw)
	[Feature-14] Portal randomisation rules
	[Feature-15] Portal randomisation placement
	[Feature-16] Interactive elements artwork
	[Feature-17] Buttonise all player choices
	[Feature-18] Player token selection
	[Feature-20] Command line arguments to choose UI mode
	[Feature-21] Token artwork
	[Feature-22] Game board artwork
	[Feature-23] Portal Artwork
	[Feature-24] Splash screen artwork
	[Feature-25] GUI logic
	[Feature-26] Documentation (readme)

===========================================================================

	4)	Known Issues
	------------

	No animations have been included in the game distribution. Will be considered in a future release (v2).