You have just taken home your new bookshelf and now it is time to put your favorite items in the display: books, boardgames, portraits... Who will show the best organized shelfie?
This repository contains the Java Implementation of the game board My Shelfie (Cranio Creations Srl), developed for the Final Project 2022/2023 of the Software Engineering course.
| Members 👤 | Github Nickname  |
Institutional Mail 📧 |
|---|---|---|
| Irene Lo Presti | @irelop | irene.lopresti@mail.polimi.it |
| Matteo Lussana | @matteo-lussana | matteo.lussana@mail.polimi.it |
| Riccardo Lodelli | @ilrechh | riccardo.lodelli@mail.polimi.it |
| Andrea Giacalone | @andreagiacalone | andrea1.giacalone@mail.polimi.it |
| Feature | Impl |
|---|---|
| Complete Rules | ✅ |
| Socket | ✅ |
| RMI | ✅ |
| TUI | ✅ |
| GUI | ✅ |
| Multiple Parallel Games | ✅ |
| Persistence | ✅ |
| Disconnection Resilience | ✅ |
| Chat | ❎ |
📖 Complete Rules : the game implements the complete set of rules, including the employment of common goal cards, whose achievement gives the player the possibility to increase even more his/her personal score.
DISCLAIMER : these goals are implemented following the italian rules available on the Cranio Website
DISCLAIMER : in this project the number of port is already set to 9999.
🔀 RMI : the client-server communication is also implemented employing the RMI network protocol.
DISCLAIMER : in this project the number of port where the RMI is already set to 1099.
⌨️ TUI : the user can choose to interact with a Text User Interface.
🖱️ GUI : the user can choose to interact with a Graphic User Interface implemented with JavaFx.
Following here, the description of each FA.
🎮 Multiple Parallel Games : the server can manage multiple parallel games, each one separated from the others. When a player wants to connect to game whose lobby is already full, the server will create a new one.
💾 Persistence : when starting the game and at the end of each turn, the server saves the game status on txt files, in particular:
- a txt file is created and managed for each player.
- a txt file is created and managed for each game. If a player disconnects, he/she can reconnect and retrieve his/her game status loading this data. For further info, you can check it out how game data are stored here
DISCLAIMER : only when a game finishes, all txt files related to that game are deleted, otherwise the server continues to keep track of them. This feature has the purpose to retrieve players and games after a crash of the server or a disconnection of the player.
📶 Disconnection Resilience : when connection drops or the client crashes, players can reconnected to their game and continue from where they left. In the meanwhile, other players can still play skipping the disconnected player rounds. If there is only player connected to the game, a countdown timer of 30 seconds will be set and, if no reconnections notifies it, the game will end declaring the last player connected as the winner.
💬 Chat : each one of the connected players can send messages to the others.
DISCLAIMER : due to formatting reasons and limits of the TUI, the chat can be accessed only at the end of a turn, with a maximum limit of 3 available messages which can be send, avoiding possible time wasting of a player. In GUI, this processed is implemented in real-time and messages can be sent and shown in every moment. In CLI there is also the possibility to send private messages to the others.
For further details, you can check it out here
In order to properly execute the MyShelfie_server.jar, you can insert in the command line console the following command:
java -jar .\MyShelfie_server.jar.
The server will be ready to listen for new connections.
TIP : in order to dive into a full good experience with the Text User Interface we suggest the user to follow these few steps:
- Run intl.cpl (which opens the regional settings in Control Panel);
- Activate the Administrative tab;
- Click on the Change System Locale button;
- Enable the Unicode UTF-8 option. This sets the ANSI code page to 65001, the UTF-8 code page in order to make all future console window show correct colours and symbols. For further informations, check it out here We strongly recommend the use of a more recent version of PowerShell, changing the background colour to a different one than black in order to experience a proper visualization.
You are now able to execute your MyShelfie_client.jar through the comand:
java -jar .\MyShelfie_client.jar.
Enjoy your game!
My Shelfie is a board game developed and published by Cranio Creations Srl. The graphic contents of this project attributable to the board editorial product are used with the prior approval of Cranio Creations Srl for educational purposes only. The distribution, copying or reproduction of the contents and images in any form outside the project is prohibited, as is the redistribution and publication of the contents and images for purposes other than the aforementioned. Furthermore, the commercial use of these contents is prohibited.
We would like to thank our professor Pierluigi San Pietro, our project managers Alessandro Bertani and Tommaso Paladini, our tutors Silvia Marino and Patrick Niantcho, who have helped us during the project development.