♟️ JavaFX Chess Game

🚀 Advanced Chess Engine & Interactive GUI Built with JavaFX

---

♚ Strategic Chess Experience Powered by JavaFX ♚

💻 A fully interactive JavaFX Chess Game implementing complete chess mechanics, intelligent move validation, smooth graphical gameplay, and modern object-oriented architecture.

👨‍💻 Developed By

Muhammad Nouman

🚀 Built with passion for software engineering, game development, and problem solving.

---

⚡ Professional Desktop Chess Experience

Built using Java, JavaFX, and Object-Oriented Programming principles.

---

🌟 Project Highlights

✨ Interactive JavaFX GUI

✨ Complete Chess Rules Implementation

✨ Accurate Move Validation System

✨ Dynamic Piece Rendering

✨ Real-Time Check & Checkmate Detection

✨ Smooth Turn-Based Gameplay

✨ Modern Object-Oriented Architecture

✨ Professional Asset Management

✨ Beginner-Friendly Yet Scalable Code Structure

---

📸 Game Preview

♟️ Main Gameplay

---

⚔️ Mid Game Battle

---

♚ Checkmate Screen

---

🎮 Gameplay Features

♙ Pawn Logic	♖ Rook Logic	♘ Knight Logic
♗ Bishop Logic	♕ Queen Logic	♔ King Logic
⚔️ Piece Capturing	🧠 Move Validation	🚫 Illegal Move Prevention
♚ Check Detection	🏆 Checkmate Detection	🔄 Turn Management
🎨 GUI Rendering	🖱️ Mouse Interaction	⚡ Real-Time Updates

---

🛠️ Technologies Used

Technology	Purpose
☕ Java	Core Programming Language
🎨 JavaFX	GUI Development
🧠 OOP	Code Architecture
♟️ Chess Logic	Gameplay Mechanics
⚡ Event Handling	User Interaction
💻 Desktop Application	Application Environment

---

📂 Project Structure

JavaFX-Chess-Game/
│
├── src/
│   │
│   ├── Main.java
│   │
│   └── ASSETS/
│       │
│       ├── board.png
│       │
│       ├── pieces/
│       │   ├── wp.png
│       │   ├── wr.png
│       │   ├── wn.png
│       │   ├── wb.png
│       │   ├── wq.png
│       │   ├── wk.png
│       │   ├── bp.png
│       │   ├── br.png
│       │   ├── bn.png
│       │   ├── bb.png
│       │   ├── bq.png
│       │   └── bk.png
│       │
│       └── game_end/
│           ├── white_wins.png
│           ├── black_wins.png
│           └── draw.png
│
├── PICTURES/
│   ├── gameplay.png
│   ├── midgame.png
│   └── checkmate.png
│
├── README.md
├── LICENSE
└── .gitignore

---

⚙️ JavaFX Setup Guide

✅ Requirements

Before running the project, install:

• ☕ Java JDK 17 or higher
• 🎨 JavaFX SDK
• 💻 IntelliJ IDEA

---

📥 Download JavaFX SDK

Download JavaFX SDK from:

https://gluonhq.com/products/javafx/

After downloading:

1️⃣ Extract the folder 2️⃣ Remember the JavaFX SDK location

Example:

C:\javafx-sdk-24

---

⚙️ Configure JavaFX in IntelliJ IDEA

1️⃣ Open Project Structure

File → Project Structure

---

2️⃣ Add JavaFX Library

Go to:

Libraries → + → Java

Select:

javafx-sdk-24/lib

Press OK ✅

---

3️⃣ Configure VM Options

Go to:

Run → Edit Configurations

Inside VM Options, paste:

--module-path "YOUR_JAVAFX_LIB_PATH" --add-modules javafx.controls,javafx.fxml

Example:

--module-path "C:\javafx-sdk-24\lib" --add-modules javafx.controls,javafx.fxml

---

📦 Assets Placement Guide

⚠️ All images and assets MUST remain inside:

src/ASSETS/

---

♟️ Chess Piece Images

Store all chess piece PNG files inside:

src/ASSETS/pieces/

Required files:

wp.png
wr.png
wn.png
wb.png
wq.png
wk.png

bp.png
br.png
bn.png
bb.png
bq.png
bk.png

---

🏆 Game End Screens

Store game result images inside:

src/ASSETS/game_end/

Required files:

white_wins.png
black_wins.png
draw.png

---

🧩 Chess Board Image

Board image location:

src/ASSETS/board.png

⚠️ Do NOT rename asset files unless updating image paths in code.

---

🚀 How To Run The Project

📥 Clone Repository

git clone https://github.com/Nouman-Irfan/JavaFX-Chess-Game.git

---

💻 Open Project

1️⃣ Open IntelliJ IDEA 2️⃣ Click Open 3️⃣ Select project folder 4️⃣ Configure JavaFX SDK 5️⃣ Run Main.java

---

📚 Learning Objectives

This project was developed to strengthen understanding of:

• 🧠 Object-Oriented Programming
• 🎨 GUI Development using JavaFX
• ⚡ Event Handling
• ♟️ Chess Algorithms
• 💻 Software Architecture
• 🚀 Game Development
• 🔍 Problem Solving
• 📦 Resource Management

---

🔒 License

This project is licensed under the GNU GPL v3 License 📜

---

👨‍💻 Authors

Muhammad Nouman

💻 Computer Science Students 🚀 Aspiring Software Engineers ♟️ Java & Game Developers

⭐ If you like this project, consider giving it a star on GitHub!

🚀 “Great developers don’t just write code — they build systems.”