Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/antoinegreuzard/chess-game
Chess game in ts
https://github.com/antoinegreuzard/chess-game
chess minimax typescript
Last synced: about 2 months ago
JSON representation
Chess game in ts
- Host: GitHub
- URL: https://github.com/antoinegreuzard/chess-game
- Owner: antoinegreuzard
- License: mit
- Created: 2024-10-26T15:42:22.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-12T20:14:15.000Z (about 2 months ago)
- Last Synced: 2024-11-12T21:23:27.788Z (about 2 months ago)
- Topics: chess, minimax, typescript
- Language: TypeScript
- Homepage: https://antoinegreuzard.github.io/chess-game/
- Size: 1.92 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Chess Game in TypeScript
This is a simple Chess game implemented in TypeScript, featuring a 2D graphical interface, animation for piece
movements, and rules enforcement.
## Features
- **Turn-based system** where players take turns playing as White.
- **Animation** for piece movements.
- **Legal move highlights**: When a piece is selected, all legal moves are highlighted.
- **Check indicator**: The board highlights when the King is in check.
- Enforced **Chess rules** for piece movements.
- **Timer** for each turn.
- **Capture of pieces** with visual updates.
- **Castling**, **En Passant**, and **Pawn Promotion** supported.
- **Stalemate** and **Checkmate** detection.
## Setup Instructions
### Prerequisites
- [Node.js](https://nodejs.org/en/) (version 20)
- npm (comes with Node.js)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/antoinegreuzard/chess-game.git
cd chess-game
```
2. Install the dependencies:
```bash
npm install
```
### Running the Game
1. Build the project:
```bash
npm run build
```
2. Start the development server:
```bash
npm run start
```
3. Open your browser and navigate to `http://localhost:5173` to play the game.
# Project Structure
- **src/**: Contains the TypeScript source code.
- **index.ts**: The main entry point of the application. Includes game logic and initialization.
- **canvas-renderer.ts**: Manages the rendering of the board and pieces, as well as user interactions.
- **piece.ts**: Defines the base class for different chess pieces and their movement rules.
- **board.ts**: Contains the board setup and logic for move validation.
- **game.ts**: Handles the main game logic, including rules and turn management.
- **timer.ts**: Manages the timer for each player's turn.
- **pieces/**: Folder containing individual TypeScript files for each chess piece type:
- **bishop.ts**: Defines the movement rules for the bishop.
- **king.ts**: Defines the movement rules for the king.
- **knight.ts**: Defines the movement rules for the knight.
- **pawn.ts**: Defines the movement rules for the pawn.
- **queen.ts**: Defines the movement rules for the queen.
- **rook.ts**: Defines the movement rules for the rook.
- **utils/**: Contains utility files:
- **pieceFactory.ts**: Factory for creating instances of chess pieces.
- **utils.ts**: Other helper functions used across the project.
### Implementing Capture of Pieces
To implement the capture of pieces:
1. The game validates moves and allows capturing of opponent's pieces if the move is legal.
2. Captured pieces are removed from the board and displayed in the "Captured Pieces" sidebar.
### Implementing Castling
To implement castling:
1. Conditions for castling have been added in the King’s move validation.
2. The King and the Rook involved must not have moved before.
3. There must be no pieces between the King and the Rook.
4. The King must not be in check before, during, or after castling.
### Implementing Special Chess Rules
- **En Passant**: This special pawn capture move is implemented, allowing pawns to capture opponents in specific
conditions.
- **Pawn Promotion**: When a pawn reaches the opponent's back rank, it can be promoted to another piece (Queen by
default, with options to choose another piece).
- **Stalemate**: The game correctly identifies situations of stalemate, leading to a draw.
- **50-Move Rule**: The game can end in a draw if 50 moves are made without a pawn move or a capture.
- **Check Indicator**: When the King is in check, the board visually highlights the King’s position.
### Scripts
- **`npm run build`**: Compiles the TypeScript code.
- **`npm run dev`**: Starts the development server using a local server.
## Additional Features
- **Insufficient Material**: The game detects situations where a checkmate is impossible due to insufficient material (
e.g., King vs. King).
## Contributions
Feel free to fork this repository and submit pull requests. Contributions are always welcome!
## License
This project is licensed under the MIT License.
[](https://depfu.com)
[](https://depfu.com/github/antoinegreuzard/chess-game?project_id=48982)
[](https://depfu.com/github/antoinegreuzard/chess-game?project_id=48982)