♟️ Chess Game 🧩

Yo, welcome to this epic Chess Game built with Python and Pygame! It’s a fully functional chess experience with slick visuals, sound effects, timers, and all the classic chess rules — from castling to en passant to pawn promotions. Whether you're a chess grandmaster or just here for the vibes, this game’s got you covered. 😎

---

🔥 Features

• ♟️ Classic Chess Gameplay – Full support for standard chess rules.
• ⏱️ 10-Minute Timers – Both players get 10 minutes; time runs only on your turn. Lose on time!
• 🖼️ Visual Vibes – Clean 8×8 board with alternating squares and a stylish captured-pieces display.
• 🔊 Sound Effects – Custom sounds for moves, captures, checks, checkmates, castling, and more.
• 👑 Pawn Promotion – Promote to a queen, rook, bishop, or knight when reaching the last rank.
• 🕳️ En Passant – Yes, the spicy pawn capture is implemented!
• 🏰 Castling – Both kingside and queenside castling are supported.
• 🏆 Checkmate & Stalemate Detection – Endgame logic with victory messages and screen dimming.
• 🔄 Restart Option – Press R to reset the board and play again after the game ends.
• 🔁 Auto-Flipping Board – The board flips after every move to show the active player’s perspective.
• 📄 PGN Export – Save your game history in PGN format after each match. Perfect for analysis or bragging rights.
• 📜 FEN Support – Load any chess position from Forsyth–Edwards Notation (FEN).

---

⚙️ Installation

1. Clone the repo

git clone https://github.com/Rayan581/Chess.git
cd chess-game

2. Install dependencies

Make sure you have Python 3.x and Pygame installed:

pip install pygame

3. Prepare assets

Ensure the following structure is present under the assets/ folder:

assets/
├── pieces/
│   ├── black/
│   │   ├── black-pawn.png
│   │   ├── black-knight.png
│   │   └── ...
│   └── white/
│       ├── white-pawn.png
│       ├── white-knight.png
│       └── ...
└── sounds/
    ├── move.mp3
    ├── capture.mp3
    ├── check.mp3
    ├── checkmate.mp3
    └── ...

If not included, you can grab free chess piece PNGs and sound effects online.

---

▶️ Running the Game

python main.py

---

🎮 How to Play

• Move Pieces: Click a piece to select it. Valid moves will be highlighted. Click again to move.
• 10-Minute Timer: Both players start with 10 minutes. The clock runs only during your turn. Time out = loss.
• Pawn Promotion: Reach the last rank and choose from queen, rook, bishop, or knight.
• Restart: After the game ends, press R to reset and start fresh.
• Quit: Press ESC or close the window to exit.
• View Flip: The board flips after each turn for an immersive perspective shift.

---

📄 PGN Export

After the game ends (via checkmate, stalemate, or timeout), the game automatically generates a .pgn file in the games folder inside the project folder.

You can:

• Open it in tools like lichess.org or chess.com/analysis
• Replay moves, review blunders, or save your finest victories

Each PGN includes:

• Player names
• Result (win/loss/draw)
• Termination reason (checkmate, timeout, etc.)
• Full move history in official notation

PGN file example: game_2025-07-15_19-34-22.pgn

---

📜 FEN Support

You can start from any position using a FEN string! Perfect for studying openings, recreating famous games, or resuming saved positions.

Example FEN strings:

• Starting position:

  rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1
  

• After 1. e4 e5 2. Nf3 Nc6:

  r1bqkbnr/pppp1ppp/2n5/4p3/4P3/5N2/PPPP1PPP/RNBQKB1R w KQkq - 2 3
  

To use it, just update the board setup in main.py with your FEN string, and the game will load from that position.

---

📁 Project Structure

chess-game/
├── main.py              # Game loop, input, and timer logic
├── classes/
│   ├── board.py         # Chess board state, rendering, and game rules
│   ├── piece.py         # Piece class and movement logic
│   └── sound_manager.py # Plays sound effects
└── assets/              # Piece images and sound files
└── games/               # PGNS of previously played games

---

🤝 Contributing

Wanna make this game even more lit? Fork the repo, make your changes, and submit a pull request! 💡

Ideas:

• Add a single-player mode with AI
• Move history or undo functionality
• Add increment-style clocks (e.g. +2 seconds per move)
• Animations, themes, and visual polish
• LAN or online multiplayer

---

📜 License

This project is licensed under the MIT License. Feel free to use, modify, and share — just be chill and give credit where it’s due. ✌️

---

Made with ❤️, caffeine, and dramatic blunders.

---