IS23-AM02

Developers

• 10766393 Alberto Cantele (@CntAlberto)
  alberto.cantele@mail.polimi.it

• 10713858 Andrea Cioccarelli (@cioccarellia)
  andrea.cioccarelli@mail.polimi.it

• 10792907 Giulia Bortone (@GiuliaBortone)
  giulia.bortone@mail.polimi.it

• 10790205 Marco Carminati (@MarcoCarminati)
  marco9.carminati@mail.polimi.it

Progress status

Functionality	State
Basic rules	🟢
Complete rules	🟢
Socket	🟢
RMI	🟢
GUI	🟢
CLI	🟢
Multiple games	🔴
Persistence	🟢
Resilience	🟣
Chat	🟢

Compilation

Requirements

The project uses as the intended language level 19 preview ⚠️.
To compile and execute the project, you'll need a jdk with 19 preview features support. We recommend using any version of openjdk-19.

Compiling

Run the maven clean and then package command to generate a jar file for the project.

mvn clean -f pom.xml
mvn package -f pom.xml

The output jar will be located in artifacts/shelfie.jar.

Executing

Once the jar file has been compiled, you can run it (assuming your java uses a jdk 19 with preview-features enabled) using one of the launch modes described below. A script to generate command line arguments is present (gen_args_nix.sh) to expedite this process.

Wizard

The wizard is invoked when no/not enough parameters are given (as program arguments), and will ask through a CLI interface to provide them until an exhaustive configuration is reached, and the corresponding module is started.

java --enable-preview -jar myshelfie-all.jar

Server

Template for starting the server. The server address is the IP of the machine executing it.

Parameter	Value	Description
Target	SERVER	Specifies that the server should be started
TCP port	12000	Port used for TCP connections
RMI port	13000	Port used for RMI connections

java --enable-preview -jar myshelfie-all.jar --target SERVER --server-tcp-port 12000 --server-rmi-port 13000

Client

Template for starting the client.

Parameter	Value	Description
Target	CLIENT	Specifies that the server should be started
Server address	127.0.0.1 / 192.168.1.X	Address of the server hosting the game. Can be the loopback or local (LAN)
Client mode	CLI/GUI	Whether starting the client in CLI or GUI mode
Client proto	TCP/RMI	Specifies which communication protocol is used for this client
Server TCP port	12000	Port used for TCP connections
Server RMI port	13000	Port used for RMI connections

java --enable-preview -jar myshelfie-all.jar --target CLIENT --server-address 127.0.0.1 --client-mode CLI --client-protocol RMI --server-tcp-port 12000 --server-rmi-port 13000

Copyright Note

My Shelfie è 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 Sr
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.