LudoM

An implementation of a local multiplayer Parcheesi game for 2 to 4 players.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Installation
3. Usage
4. Contributing
5. License
6. Contact
7. Acknowledgments

About The Project

An excellent proposal for practicing object-oriented programming and the Model-View-Controller, State Machine, and Observer design patterns is with a playful idea. From here arises LudoM, a Java implementation of the famous Parcheesi game for 2 to 4 players.

This development was done within an academic framework where agile methodologies were put into practice, and relevant documentation was produced. The associated documents can be reviewed in the folder LudoM.Documentos.

(back to top)

Built With

• 
• 

(back to top)

Getting Started

Prerequisites

Access the installation instructions for the following dependencies.

• IntelliJ
• Java 17

Installation

1. Clone the repo

   git clone https://github.com/Fran-cio/ludoM.git

2. Open the project

3. Run Main

   

   Most likely, at this step, the appropriate JDK will be installed if you haven't installed it previously.

Usage

Once the program is started, the following subtle graphical interface is displayed, allowing you to select the number of players.

Once the number of players is selected, the game automatically begins with the player 1 rolling the dice until a 6 is rolled. From there, the conventional [rules](https://www.mastersofgames.com/rules/parchis-rules-instructions-guide.html) of Parcheesi are followed.

The game information is displayed on the right side of the screen, where it specifies the pieces in play, the piece number, its status on the board, and its position in coordinates.

The player makes their move by pressing the numbers from 1 to 4, indicating the piece with which they want to make the move.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the Beerware License🍻. See LICENSE.txt for more information.

(back to top)

Contact

Francisco Ciordia Cantarella - francisco.ciordia.cantarella@gmail.com

Project Link: https://github.com/Fran-Cio/ludoM

(back to top)

Acknowledgments

• Parcheesi what?
• MVC (Model, View, Controller)
• Observer Desing Pattern
• State Desing Pattern
• Pretty Badges
• Logo Generator
• Template of this readme

(back to top)