This game is a programming assignment for CPS2002: Software Engineering, a course forming part of our B.Sc. in Mathematics and Computer Science.
A precompiled JAR file is present in the root directory, so all that is required to actually run the game is a working Java installation on Windows/OSX/Un*x.
Clone the repository, then open a terminal (or command line on Windows) and navigate to the directory where the repository files are present. Then run the command
java -cp game.jar edu.um.cps2002.tile_game.Launcher
which will present you with the console interface for the game. Enter the number of players and desired size of the map when prompted. Then you should notice that an HTML file has been generated for each player (map_player_1.html, map_player_2.html, etc) in the repository folder. Open these in a browser. After each round is played in the console, refresh the maps in the browser (hit F5) to see where the players have landed. The first player to discover the treasure tile is the winner.
The program is built using Maven, so if you wish to compile the code, navigate to the main directory in a terminal/command line (Windows) and type mvn clean install, which should produce an executable JAR file in the target directory. If Maven is not present on your system, you can download it from the main website (Windows/OSX) or open a Linux terminal and run
sudo apt-get install maven
Detailed documentation of the code can be found in the javadocs directory. Visit this webpage to view the documentation in your browser or pull the repository, navigate to the javadocs directory and open index.html for details about the classes/methods involved. Alternatively, one can generate Doxygen documentation for the project using the provided Doxyfile, by running the terminal command
doxygen
in the root directory.