🃏 chupate-dos
Chúpate Dos is a cooperative Java game developed for the AEDI course, faithfully recreating the classic Spanish card game “Chúpate dos”. Designed to be played in the terminal, this project emphasizes code clarity, documentation, and collaborative learning.
🎮 Game Overview
- Objective:
Compete with friends using the Spanish deck, following traditional “Chúpate dos” rules — draw two cards when challenged, strategize, and win!
- "Multiplayer":
Play with friends locally in the terminal.
- Classic Gameplay:
All original rules and cards from the Spanish deck are supported.
🛠️ Features
- Fully Terminal-Based:
Just run and play in your console.
- Well-Documented Code:
Easy to read and extend, with comprehensive inline documentation.
- Modular Design:
Organized codebase for easy enhancements and new features.
- Spanish Deck Support:
Faithfully implements almost all cards and actions.
🚀 Getting Started
-
Clone the Repository
git clone https://github.com/Biosbardos/chupate-dos.git
or click on "Download ZIP" (you will need to unzip it somewhere in your pc)
-
Move to the Correct Carpet
cd C:\Users\*your user*\Escritorio\chupate-dos\src\main\jar\
-
Run the Game
java -jar chupatedos.jar
(You will need to have previously installed at least java 21.0.2 or more to be sure this proyect works)
📂 Project Structure
chupate-dos/
├── src/
│ └── main/ # Code files
│ ├── classes/ # Compiled classes
│ ├── jar/ # Executable Jar (with MANIFEST.MF)
│ ├── java/ # Java source files
├── LICENSE # License information
├── README.md # This documentation
📝 Documentation
- All classes and methods include Javadoc comments.
- For more details, review the source code in the
java folder.
🤝 Contributing
This repository contains the final version of the development of this proyect-NOT FARTHER COMMITS WILL BE MADE. However, feel free to fork this code and improve it!
⚠️ Disclaimer
This project is for educational and entertainment purposes.
It was developed as part of the AEDI course requirements.
📜 License
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program in LICENSE. If not, see https://www.gnu.org/licenses/.
👥 Authors & Credits
- Developed by Biosbardos, Ivablavi and collaborators for AEDI.
💬 Contact
Questions, ideas, or feedback?
Open an issue, open a discussion or reach out via GitHub.