CODEX - IS24AM14

The project

This Java project is a porting of the boardgame CODEX by Cranio Creations. It is being realized as final project of the Software Engineering course at Politecnico di Milano.

The team

Group 14 (Prof. Alessandro Margara)

• Matteo Delogu (@Orbital01)
• Vittorio Pio Remigio Cozzoli (@justvicthor)
• Stefan Bogdanovic (@SteBog)
• Niccolò Francesco Basile (@BasicNickPolimi)

---

Status of the work

Functionality	Status
Basic rules	✅
Complete rules	✅
Socket connection	✅
RMI connection	✅
CLI	✅
GUI	✅
Multiple games	✅
Persistence	❌
Resilience	❌
Chat	✅

Legend

Symbol	Functionality status
✅	Completed
☑️	Planned, not started yet
🚧	Work in progress
❌	Not planned to be implemented

---

How to play

Requirements

• Java 21.0.0
• it is recommended to use a unicode-compatible terminal

Run the game

1. Clone the repository

2. Open a terminal and navigate to the folder

3. Build the project with the following command:

   mvn clean package

   This will create a .jar file in the target folder

4. You can run the app with the following command:

   java -jar IS24-AM14-1.0-jar-with-dependencies.jar

   it will have the following default parameters:

   • CLI user interface
   • LoopBack IP address 🔁
   • 12345 socket port
   • 12346 RMI port

5. If you want to change the parameters, you can use the following options as arguments:

   • --address xxx.xxx.xxx.xxx
     • where xxx.xxx.xxx.xxx is the IP address of the server
   • --socket-port xxxxx
     • where xxxxx is the port of the server
   • --rmi-port xxxxx
     • where xxxxx is the port of the server
   • --mode
     • 0 for GUI
     • 1 for CLI
     • 2 for Server

Example

-> starting the client

java -jar IS24-AM14-1.0-jar-with-dependencies.jar --address 192.168.0.1 --socket-port 12345 --rmi-port 12346 --mode 1

-> starting the server

java -jar IS24-AM14-1.0-jar-with-dependencies.jar --address 192.168.0.1 --socket-port 12345 --rmi-port 12346 --mode 2

⚠️ Note: The server must be launched in order to play the game

⚠️ Note: Both socket and RMI ports must be set to the same value on the server and the client

⚠️ Note: If there's only one input missing, the default value will be used for the missing one

⚠️ Note: If the address is invalid, the default value will be used 🔁

In Game Screenshots

Legal

Codex è un gioco da tavolo sviluppato ed edito da Cranio Creations Srl. I contenuti grafici di questo progetto riconducibili al prodotto editoriale da tavolo sono utilizzati previa approvazione di Cranio Creations Srl a solo scopo didattico. È vietata la distribuzione, la copia o la riproduzione dei contenuti e immagini in qualsiasi forma al di fuori del progetto, così come la redistribuzione e la pubblicazione dei contenuti e immagini a fini diversi da quello sopracitato. È inoltre vietato l'utilizzo commerciale di suddetti contenuti.