UNO Console Game is a fully-featured, terminal-based recreation of the iconic UNO card game. Built with clean Object-Oriented Programming principles in Java, the game delivers a smooth and colorful CLI experience complete with ANSI-colored cards, typewriter animations, and an intelligent bot opponent.

Whether you want a quick solo game against the bot or a multiplayer session with friends gathered around one terminal, this project brings the fun of UNO to the command line.

🏠 Game Menu & Mode Selection

Choose between Player vs Bot, 2 Players, 3 Players, or 4 Players mode.

---

🎮 Turn Start Screen

Clean, focused UI for each player's turn with privacy protection in multiplayer.

View your hand, playable cards, and choose your next move. Cards are color-coded for easy identification.

• Java 17 or higher — Download here
• A terminal that supports ANSI color codes (Windows Terminal, Git Bash, macOS Terminal, Linux Terminal)

# 1. Clone the repository
git clone https://github.com/haroune-dev/UNO-Console-Game.git

# 2. Navigate to the project directory
cd UNO-Console-Game

# 3. Compile the source files (Linux/macOS or Git Bash)
javac -d bin src/**/*.java

# On Windows CMD, use explicit paths:
javac -d bin src\cards\*.java src\deck\*.java src\player\*.java src\enumTypes\*.java src\game\*.java


# 4. Run the game
java -cp bin game.Drive

1. Import the project into Eclipse (File → Import → Existing Projects)
2. Run Drive.java as a Java Application
3. Enjoy! 🎉

The project follows a clean, modular architecture using core OOP principles — inheritance, polymorphism, encapsulation, and abstraction.

UNO-Console-Game/
├── src/
│   ├── cards/                    # Card hierarchy (Abstract → Concrete)
│   │   ├── Card.java             # Abstract base class
│   │   ├── ColoredCard.java      # Abstract colored card
│   │   ├── NumberedColoredCard.java
│   │   ├── DrawTwoCard.java
│   │   ├── ReverseCard.java
│   │   ├── SkipCard.java
│   │   ├── WildCard.java         # Abstract wild card
│   │   ├── WildColorCard.java
│   │   └── WildColorDrawFourCard.java
│   │
│   ├── deck/                     # Deck management
│   │   ├── Deck.java             # Abstract deck
│   │   ├── DrawPile.java         # Draw pile with shuffle & refill
│   │   └── DiscardPile.java      # Discard pile
│   │
│   ├── player/                   # Player management
│   │   ├── Player.java           # Player entity (human & bot)
│   │   └── PlayerHand.java       # Hand management
│   │
│   ├── enumTypes/                # Game enumerations
│   │   ├── Color.java            # RED, BLUE, GREEN, YELLOW
│   │   └── Number.java           # ZERO through NINE
│   │
│   └── game/                     # Game engine
│       ├── Drive.java            # Entry point (main)
│       ├── GameController.java   # Core game logic & rules
│       └── GameSession.java      # UI, I/O, and session management
│
├── screenshots/                  # Project screenshots
└── README.md

UML Class Diagram showing the complete inheritance hierarchy and relationships.

• Abstract Card Hierarchy — Card → ColoredCard / WildCard → Concrete cards. Each card type implements its own matches() and applyEffect() logic via polymorphism.
• Separation of Concerns — GameController handles rules and state, GameSession manages UI and player interaction, and Drive serves as the entry point.
• Bot Strategy Pattern — The bot selects cards based on a scoring algorithm that evaluates color frequency and card type in its hand.
• Standard 108-Card Deck — Faithfully implements the official UNO deck composition.

1. Start the game and choose a game mode (Player vs Bot or Multiplayer)
2. Enter player names when prompted
3. On your turn:
   • View the top card on the discard pile
   • See your hand and playable cards
   • Select a card to play, or draw if you have no valid moves
4. Action cards trigger immediately:
   • Reverse — Changes the turn direction
   • Skip — Skips the next player
   • Draw Two — Next player draws 2 cards and loses their turn
   • Wild — Choose any color to continue
   • Wild Draw Four — Choose a color + next player draws 4 cards
5. Say UNO! — Type uno when finishing your turn with 1 card remaining, or face a 2-card penalty
6. Win by being the first player to empty your hand!

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Add network multiplayer support
• Implement a tournament mode
• Add card stacking rules (stack Draw Two on Draw Two)
• Create a difficulty setting for the bot AI
• Add save/load game functionality

• Haroune-dev
• ayoubgz1
• 0xraouf Abderraouf
• AbdelhadiZA