FINAL PROJECT OF SOFTWARE ENGINEERING 2019/2020

Implementation of Santorini© board game in Java language, which idea was conceived by Gordon Hamilton and was later published thanks to Kickstarter by Roxley Games.

Instructions on how to play the board game: https://cdn.1j1ju.com/medias/fc/ec/5d-santorini-rulebook.pdf

GROUP DESCRIPTION

  • Mangano Davide ------- https://github.com/Davismanghi , https://github.com/DavideMangano
  • Messori Alessandro --- https://github.com/AlessandroMessori
  • Nespoli Matteo ------- https://github.com/MattNes
  • LIST OF FUNCTIONALITIES

    We decided to implement the complete rules + CLI + GUI + Socket + 1 AF, so to therorically reach 30 as maximum mark possible. The advanced functionality we chose is the multiple games on one server.

    INSTRUCTIONS ON HOW TO CORRECTLY USE THE .jar FILE

    On Ubuntu/Debian/MacOS[1]:

    Step 1) Checking if you already have java installed.
    To work properly, the .jar needs to be opened in an OS with already a JRE and a JDK installed. Open the terminal with the CTRL+ALT+T combination, write down java -version and see the result. If the Java version is already 13 or more, you can jump directly to Step 4. Otherwise, go to the next step.

    Step 2) Installing Java.
    Start by typing sudo apt-get install default-jre to download the JRE. After that, type sudo apt_get install openjdk-13-jdk to install Java JDK 13.

    Step 3) Confirmation.
    Always on the terminal, now type again java -version. You should see Java 13, that means everything has gone correctly. Otherwise there could be some errors in the previous phases, but the terminal should explain you how to solve them.

    Step 4) Downloading the actual game.
    Now you have to get the actual file to play with. First, open the deliveries/final/jar folder in this repo. From there, download either the CLI client or the GUI client, depending on you wanting to play a more vintage gameplay or a more modern, graphical one. After you have decided, you now have the .jar file in your PC. But how to run it?

    Step 5) Open the game.
    Open the terminal, reach the folder in your system containing the downloaded .jar file, and write java SantoriniGUI.jar -jar.

    Step 6) Congratulations!
    Now you can play your Santorini.jar file without problems.

    On Windows[2]:

    Step 1) Downloading Java.
    If you already have Java installed, you can skip to Step 4. Otherwise, you have to download JRE and JDK 13 (or later). To do so, you can search the links here indicated to have all you need to play:
    JRE: https://www.java.com/it/download
    JDK: https://download.java.net/openjdk/jdk13/ri/openjdk-13+33_windows-x64_bin.zip.

    Step 2) Downloading the actual game.
    When you're done with Java, you can see the Step 4 in the Ubuntu/Debian/MacOS guide.

    Step 3) How to run the .jar
    To run the .jar without problems, Windows gets a bit tricky. Open the Terminal, and go to the folder where you saved your Santorini.jar file (with a series of cd). Now write the path to the folder where you saved the JDK previously downloaded together with the .jar name in this way:
    /Example/Folder/WhereYouHaveJDK/bin/Java -jar Santorini.jar.

    Step 4) Congratulations!
    Now you can play your Santorini.jar file without problems.

    Enjoy the game!

    [1] WARNING! On some Windows devices there's a default display option that scales up the images by 125% automatically. This doesn't stop you from playing the game, but it could severely ruin your experience since some in-game possible choices are in the corners or, sometimes, really down/up the screen. To solve this: you can simply go in Settings>System>Display and the first option is the layout one. From the default 125% you can change it to 100%, and of course if you don't like it you can turn it back whenever you want.