SUIT21 - A Java Card Game

Overview

SUIT21 is a card game implemented in Java, supporting 2 to 6 players, including AI opponents. The goal is to maximize the value of cards in a single suit while playing strategically to reach a sum of 21. The game supports multiple rounds and maintains a leaderboard.

Features

• Supports 2 to 6 players (including AI opponents)
• Dynamic card dealing and swapping
• AI decision-making for computer players
• Multiple game rounds with a scoring system
• Replay feature for reviewing past rounds
• Unit tests to ensure game functionality

How to Play

1. Run the program and specify the number of games (1-5).
2. Enter the number of players (2-6) and their names (or type Computer for AI players).
3. Each player receives an initial hand of 5 cards.
4. Players take turns swapping one card per round.
5. If a player reaches a suit total of 21, they win the round.
6. Points are awarded, and the game continues until all rounds are played.
7. The final leaderboard is displayed at the end of all rounds.

Installation and Execution

Prerequisites

• Java 8 or later
• A terminal or command prompt

Steps to Run the Game

1. Clone the repository:

   git clone https://github.com/bnyari196/Suit-21-Card-Game.git
   

2. Navigate to the project directory:

   cd suit21
   

3. Compile the Java files:

   javac *.java
   

4. Run the game:

   java Main
   

Enjoy the game!