Un gioco di Leo Colovini per 2-4 giocatori.
Progetto realizzato da Riccardo Milici, Riccardo Motta e Matteo Negro.
Il software è suddiviso in due eseguibili (JRE 17 o superiori): client.jar e server.jar.
Per eseguire il client occorre lanciare direttamente il JAR stesso oppure, da riga di comando, la seguente istruzione:
java -jar client.jar
Di default, questo farà partire l'interfaccia grafica (GUI) del progetto. Se si desidera invece avere la scelta dell'interfaccia da lanciare, si possono passare i seguenti parametri:
| Parametro | Descrizione |
|---|---|
--cli o -c |
Lancia il programma da riga di comando (CLI). |
--gui o -g |
Lancia il programma da interfaccia grafica (GUI). |
Se durante la fase iniziale non si inseriscono i dati del server, l'indirizzo a cui il client cercherà di collegarsi
sarà localhost:36803 (o 127.0.0.1:36803, che è l'indirizzo a cui viene trasformata la stringa di prima).
Attenzione! Potrebbero esserci dei problemi di visualizzazione della CLI nel caso di terminali a bassa risoluzione o che non supportano i codici di escape ANSI. Per risolvere il primo problema, nel caso in cui dovesse insorgere, è consigliato ingrandire il terminale e/o rimpicciolire la dimensione del font dello stesso. Per una corretta visualizzazione dei colori, invece, e della formattazione, si consiglia di utilizzare Windows Terminal su Windows e iTerm2 su MacOS.
Per eseguire il server occorre lanciare da riga di comando la seguente istruzione:
java -jar server.jar
In automatico il server creerà una cartella database dove salva tutti i dati delle varie partite nella stessa cartella
in cui si trova in quel momento e si metterà in ascolto sulla porta 36803. Per cambiare questi parametri occorre
passare al comando uno (o entrambi) dei seguenti parametri:
| Parametro | Argomento | Descrizione |
|---|---|---|
--database o -db |
path |
Permette di cambiare il luogo dove verrà creata la cartella database, impostato un percorso assoluto o relativo. |
--port o -p |
int |
Permette di cambiare la porta sulla quale il server si metterà in ascolto delle connessioni dei client. |
Abbiamo implementato il gioco in modo tale che soddisfi tutte le regole di una partita (a.k.a. regole complete). Il tutto è fruibile interamente sia tramite intrefaccia grafica (GUI) sia da riga di comando (CLI).
| Funzionalità | Implementazione |
|---|---|
| Carte personaggio | 🟢 |
| Partita a 4 giocatori | 🟢 |
| Partite multiple | 🟢 |
| Persistenza | 🟢 |
| Resilienza alle disconnessioni | 🟡 |
🔴: funzionalità non implementata.
🟡: funzionalità implementa con qualche modifica.
🟢: funzionalità implementa secondo le specifiche.
Nota: per la funzionalità della resilienza alle disconnessioni abbiamo deciso di mettere in pausa la partita a tutti i giocatori collegati anziché saltare le rimanenti fasi di quest'ultimo.