Questo repository contiene codice sorgente e documentazione di un videogioco sviluppato in Java. Il gioco prende il nome e le caratteristiche dall'omonimo gioco da tavolo Maestri del Rinascimento, che è qui implementato via software secondo un'architettura distribuita che utilizza il pattern MVC. Il gioco può essere avviato agevolmente tramite il JAR (vedi sotto). Se si vuole importare il progetto in un IDE, le classi main da eseguire saranno il 'Server', il 'PhaseClient' per la CLI e il 'MainMenu' per la GUI.
Per creare una Lobby bisogna avviare un Server. Un Client può chiedere quindi di creare una Lobby di grandezza arbitraria. Gli verrà fornito il numero della stanza, che potrà fornire ai suoi amici. Se non tutti i giocatori si collegano entro un tempo prestabilito (di default 30 secondi), la Lobby viene cancellata dal Server.
Se tutti i giocatori di una Lobby si scollegano, la Lobby viene cancellata dal Server.
La GUI è stata implementata usando SWING.
Sono state implementate le funzionalità aggiuntive di Partita Locale, Riconnessione a una partita in corso, Partite Multiple.
Uno screenshot della copertura del codice da parte dei casi di test può essere trovato cliccando qui.
Ultima versione del 21-jun-2021.
Il programma è stato testato su una macchina virtuale Windows pulita con installata una JDK 11 LTS di Oracle.
Il programma è stato testato anche su un Mac con installata una OpenJDK 15 di Amazon.
Non sono sorti problemi durante le prove, tuttavia non possiamo essere certi della piena compatibilità per versioni JDK inferiori alla 15.
Il programma è stato scritto usando una JDK 15 Oracle. È pertanto consigliato l'utilizzo di una JDK 15 o superiore.
Per giocare con interfaccia grafica, è richiesta una risoluzione dello schermo di almeno 1920x1080p.
Per giocare in linea di comando, è necessario utilizzare un terminale che supporti i codici colori. Mac li supporta nativamente, Windows tramite il Windows Terminal li supporta.
Assicuratevi che il comando java sia funzionante nel terminale di sistema.
Per eseguire il programma usando il JAR bisogna scaricare e posizionare il jar in una cartella sul vostro computer
Dirigetevi tramite il terminale di sistema nella cartella dove avete scaricato il JAR.
Da qui basta scrivere:
java -jar GC31.jar
Per avviare il server (di default sulla porta 43210)
java -jar GC31.jar server
Per avviare il server su una porta customizzata (ad esempio la 343)
java -jar GC31.jar server 343
Per avviare il client in CLI (una volta avviato scrivere help per una lista di comandi)
java -jar GC31.jar cli
Per avviare il client in GUI
java -jar GC31.jar gui
This repository contains the source code and documentation of a videogame developed in Java. The game is named after the physical version of the board game Masters of Renaissance, which is implemented via software according to the MVP paradigm and using a networking, distribuited architecture. The game can be launched using the JAR. If you want to import the project in an IDE, the main classes to be executed will be the 'Server', the 'PhaseClient' for the CLI and the 'MainMenu' for the GUI.
To create a Lobby a Server must be started. A Client can then ask to create a Lobby of arbitrary dimension. A Lobby Number will be given to the Client, which can then share it with his friends. If not all players connect to that Lobby within a certain amount of time (by default 30 seconds), the Lobby will be deleted from the Server.
If all the players of a Lobby have disconnected, the Lobby will be deleted from the Server.
The GUI was implemented using SWING.
Additiona functionalities of Local Game, Reconnect to an existing Game, Multiple Games were implemented.
A screenshot regarding code coverage by the test cases can be found here.
Last version of 21-jun-2021.
The program was also tested on a fresh Windows VM, on which a JDK 11 by Oracle was installed.
The program was also tested on a Mac using an Amazon OpenJDK 15.
The tests did not present any problem, but we cannot guarantee full compatibility for JDKs less than 15.
The program was coded using an Oracle JDK 15.
We encourage you to utilize a JDK 15 or later.
To play using the graphical user interface, a 1920x1080p resolution is required.
To play in command line, it is necessary to use a terminal that supports color codes. Mac supports them natively, Windows can handle them using Windows Terminal.
Make sure the command java is working in the system terminal.
To run the program using the JAR you must download and place the jar in a folder on your computer.
The program is then launched by the terminal.
Use the terminal to navigate the directories and locate the folder where you have downloaded the program.
From here, it is enough to type:
java -jar GC31.jar
To launch the server (by default the port is 43210)
java -jar GC31.jar server
To launch the server using a custom port (for example 343)
java -jar GC31.jar server 343
To launch the client in CLI (you can then write help to see a list of available commands anytime)
java -jar GC31.jar cli
To launch the client in GUI
java -jar GC31.jar gui