🎲 Multiplayer Dice Game

A professional Java Swing application demonstrating Object-Oriented Programming principles and modern GUI development.

🎯 Overview

This multiplayer dice game is a complete Java Swing application built to showcase software development skills. It features a clean MVC architecture, intuitive UI, and demonstrates core OOP principles including encapsulation, inheritance, polymorphism, and abstraction.

Perfect for:

• ✅ GitHub portfolio projects
• ✅ Resume enhancement
• ✅ Learning Java Swing
• ✅ Understanding game development logic
• ✅ Practicing OOP concepts

✨ Features

• 👥 2-6 Player Support - Play with friends in hot-seat multiplayer
• 🎲 Interactive Dice - Click to hold/unhold dice between rolls
• 🏆 Score Tracking - Real-time scoreboard with active player highlighting
• 🎯 Multiple Scoring Combos - Five of a Kind, Straights, Full House, and more
• 💾 Customizable Settings - Adjust target scores and game rules
• 🎨 Modern Dark UI - Clean, professional interface with smooth interactions
• 📊 Turn Management - Automatic turn progression and winner detection
• ⚙️ Menu System - Easy access to game controls and help

📸 Screenshots

Add screenshots of your game here after running it!

[Main Game Screen]     [Scoreboard]     [Winner Screen]

🎮 Game Rules

Objective

Be the first player to reach the target score (default: 10,000 points)!

Scoring Combinations

Combination	Score	Description
Five of a Kind	5000	All five dice show the same number
Four of a Kind	2000	Four dice show the same number
Straight	1500	1-2-3-4-5 or 2-3-4-5-6
Three of a Kind	1000	Three dice show the same number
Full House	750	Three of one number + two of another
Two Pairs	500	Two different pairs
Single 1	100	Each 1 is worth 100 points
Single 5	50	Each 5 is worth 50 points

How to Play

1. Roll the Dice - Click "Roll Dice" to roll all five dice
2. Hold Dice - Click on individual dice to hold them for the next roll
3. Re-roll - You get up to 3 rolls per turn
4. End Turn - Click "End Turn" to add your score and pass to next player
5. Win - First player to reach the target score wins!

🚀 Installation

Prerequisites

• Java JDK 11 or higher
• Maven (recommended) or Gradle
• Git

Clone the Repository

git clone https://github.com/yourusername/multiplayer-dice-game.git
cd multiplayer-dice-game

Build and Run

Using Maven (Recommended)

# Compile the project
mvn clean compile

# Run the game
mvn exec:java -Dexec.mainClass="com.dicegame.Main"

# Create executable JAR
mvn clean package
java -jar target/multiplayer-dice-game-1.0.0.jar

Using Gradle

# Build the project
./gradlew build

# Run the game
./gradlew run

# Create executable JAR
./gradlew jar
java -jar build/libs/multiplayer-dice-game-1.0.0.jar

Using IDE

1. Import the project into IntelliJ IDEA, Eclipse, or VS Code
2. Wait for dependencies to resolve
3. Run Main.java from src/main/java/com/dicegame/

📁 Project Structure

multiplayer-dice-game/
├── src/
│   └── main/
│       └── java/
│           └── com/
│               └── dicegame/
│                   ├── Main.java                    # Application entry point
│                   ├── models/                      # Data models
│                   │   ├── Player.java              # Player entity
│                   │   ├── Dice.java                # Single die
│                   │   ├── DiceSet.java             # Set of 5 dice
│                   │   └── ScoreCalculator.java     # Scoring logic
│                   ├── controllers/                 # Business logic
│                   │   └── GameController.java      # Game state manager
│                   ├── views/                       # UI components
│                   │   ├── MainFrame.java           # Main window
│                   │   ├── GamePanel.java           # Game display
│                   │   ├── DicePanel.java           # Dice visualization
│                   │   ├── ControlPanel.java        # Game controls
│                   │   └── ScoreBoardPanel.java     # Score display
│                   └── utils/                       # Utilities
│                       ├── Constants.java           # App constants
│                       └── ColorScheme.java         # UI colors
├── pom.xml                                          # Maven config
├── build.gradle                                     # Gradle config
├── .gitignore                                       # Git ignore rules
└── README.md                                        # This file

🎓 OOP Concepts Demonstrated

Encapsulation

• Private fields with public getters/setters in Player and Dice classes
• Data hiding and controlled access to internal state

Inheritance

• All view panels extend JPanel with customized behavior
• Demonstrates code reuse and hierarchical relationships

Polymorphism

• Different scoring strategies can be implemented
• Mouse event handling with overridden methods

Abstraction

• ScoreCalculator provides high-level scoring interface
• Complex scoring logic hidden behind simple methods

Composition

• GameController contains Players, DiceSet
• MainFrame composed of multiple panel components

MVC Pattern

• Models: Player, Dice, DiceSet, ScoreCalculator
• Views: MainFrame, GamePanel, DicePanel, ControlPanel, ScoreBoardPanel
• Controllers: GameController

🛠️ Technologies

• Java 11+ - Core programming language
• Swing - GUI framework
• Maven/Gradle - Build automation
• Git - Version control
• MVC Architecture - Design pattern

📚 Learning Resources

This project demonstrates:

• ✅ Java Collections (ArrayList, HashMap)
• ✅ Exception Handling
• ✅ Event-Driven Programming
• ✅ GUI Layout Managers
• ✅ Custom Component Painting
• ✅ State Management
• ✅ Algorithm Implementation