https://github.com/princelad/squarelogic
Square Logic is a chess game built using Python and Pygame. It features a visually appealing chessboard, piece movement validation, pawn promotion, and move history tracking. The game ensures smooth gameplay with optimized animations.
https://github.com/princelad/squarelogic
ai board-game chess chess-engines chess-game game-development game-programming pygame pyhton-game python
Last synced: about 1 month ago
JSON representation
Square Logic is a chess game built using Python and Pygame. It features a visually appealing chessboard, piece movement validation, pawn promotion, and move history tracking. The game ensures smooth gameplay with optimized animations.
- Host: GitHub
- URL: https://github.com/princelad/squarelogic
- Owner: Princelad
- License: mit
- Created: 2024-12-27T15:17:38.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-02-20T15:09:48.000Z (2 months ago)
- Last Synced: 2025-02-20T16:24:40.900Z (2 months ago)
- Topics: ai, board-game, chess, chess-engines, chess-game, game-development, game-programming, pygame, pyhton-game, python
- Language: Python
- Homepage:
- Size: 394 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Square Logic ♟️
A simple yet interactive chess game built using **Python** and **Pygame**. This project features an intuitive chessboard, move validation, and user interactions for a smooth chess-playing experience.
## 📌 Features
- **Interactive Chessboard** – Click-based movement with move validation.
- **Move Validation** – Checks for legal moves and prevents invalid ones.
- **Undo Move** – Press `Backspace` to undo the last move.
- **Reset Board** - Press `r` to reset the board.
- **Hover & Selection Highlights** – Enhances visual clarity of moves.
- **Last Move Highlights** - Shows the last move played
- **Pawn Promotion** – Automatically promotes pawns (default: Queen).
- **Smooth Animations** – Runs at up to 144 FPS for fluid visuals.
## 🛠️ Installation
1. **Clone the repository**
```bash
git clone https://github.com/Princelad/SquareLogic.git
cd SquareLogic
```
2. **Install dependencies**
```bash
pip install -r requirements.txt
```
3. **Run the game**
```bash
python src/main.py
```
## 🎮 How to Play
- Click on a piece to select it, then click on a valid square to move.
- Press `Backspace` to undo the last move.
- Press `r` to reset the board
- Hovering over squares will highlight them for better visibility.
## 📁 Project Structure
```
SquareLogic/
│── assets/ # Chess piece images
│ └── pieces/ # Individual piece images
│── screenshot/ # Screenshots of the game
│── src/ # Source code
│ ├── pieces/ # Piece-specific logic
│ │ ├── bishop.py
│ │ ├── king.py
│ │ ├── knight.py
│ │ ├── pawn.py
│ │ ├── piece.py
│ │ ├── queen.py
│ │ └── rook.py
│ ├── ai.py # AI Logic
│ ├── chess.py # Main game logic
│ ├── engine.py # Game state and move validation
│ ├── keymanager.py # Key event handling
│ ├── main.py # Entry point of the game
│ └── move.py # Move representation
│── .gitignore # Git ignore file
│── LICENSE # License file
│── README.md # Project documentation
└── requirements.txt # Dependencies
```
## 🖼️ Screenshots
### Game State
### Selected Square and Move Highlighting
### Checkmate
## 🚀 Future Improvements
- Add **AI opponent** for single-player mode.
- Enhance UI with **move history and timers**.
## 📜 License
This project is licensed under the **MIT License**.
---