# ChessAI

A complete chess sandbox for Minecraft.

Build a real 8x8 board, place the pieces, configure the clock, and play either against another player or against the AI.

ChessAI adds:
- board square blocks
- full chess piece items and blocks
- chess clock and double chess clock
- Player vs Player mode
- Player vs AI mode
- optional FIDE-style clock
- untimed casual mode
- server-side match commands
- in-game board detection and match management

This is not just decoration.
It is a playable chess system inside Minecraft.

---

## Features

### Full chess sandbox
Create a proper chess setup directly in your world with dedicated board blocks, piece blocks, and clock blocks.

### Real match flow
- 8x8 board detection
- legal move validation
- check
- checkmate
- stalemate
- resignation
- time loss
- draw handling

### Clock system
Play with:
- FIDE clock enabled
- or casual mode without clock

The mod also supports clock interaction and turn confirmation during timed games.

### PvP and PvAI
Choose between:
- Player vs Player
- Player vs AI

The AI plays Black in PvAI mode and supports multiple difficulty levels.

### AI improvements in 2.0
Version 2.0 makes the AI more aggressive about avoiding drawish play and improves practical strength scaling across difficulty levels. It also adds animated AI moves and visual difficulty avatars.

### Cleaner game handling
Version 2.0 also hardens AI scheduling and lifecycle handling, preventing overlapping AI actions and cleaning pending computations correctly when games stop or boards are removed.

---

## Included content

The mod includes:
- White and Black board squares
- full White and Black chess sets
- checkers pieces
- chess clock
- double chess clock
- GUI for clock configuration
- English and French localization

---

## Why install ChessAI?

Because sometimes you do not want another fantasy boss fight.

Sometimes you want a wooden board, a ticking clock, a bad decision on move 12, and an AI that punishes your optimism.

---

## Version Info

- Mod: ChessAI
- Version: 2.0
- Minecraft: 1.20.1
- Forge: 47+

---

## Notes

- Detects and manages a full 8x8 board before starting
- Supports both timed and untimed matches
- Designed for in-world chess play, not just visual roleplay

Install it, place the board, start the clock, and find out whether your strategy is brilliant or just confidently wrong.

# ChessAI

Un sandbox d’échecs complet dans Minecraft.

Construisez un vrai plateau 8x8, placez les pièces, configurez l’horloge, puis jouez soit contre un autre joueur, soit contre l’IA.

ChessAI ajoute :
- des blocs de cases pour le plateau
- un set complet de pièces d’échecs en items et blocs
- une horloge d’échecs et une double horloge
- un mode Joueur contre Joueur
- un mode Joueur contre IA
- une horloge de style FIDE en option
- un mode casual sans horloge
- des commandes serveur pour gérer les parties
- la détection du plateau et la gestion de match en jeu

Ce n’est pas juste décoratif.
C’est un vrai système d’échecs jouable dans Minecraft.

---

## Fonctionnalités

### Un vrai sandbox d’échecs
Créez un véritable échiquier directement dans votre monde grâce aux blocs du plateau, aux pièces et aux horloges dédiées.

### Déroulement réel de partie
- détection du plateau 8x8
- validation des coups légaux
- échec
- échec et mat
- pat
- abandon
- perte au temps
- gestion des nulles

### Système d’horloge
Vous pouvez jouer :
- avec horloge FIDE activée
- ou en mode libre sans horloge

Le mod gère aussi l’interaction avec l’horloge et la confirmation des tours en partie chronométrée.

### PvP et PvAI
Choisissez entre :
- Joueur contre Joueur
- Joueur contre IA

En mode PvAI, l’IA joue les Noirs et propose plusieurs niveaux de difficulté.

### Améliorations de l’IA en 2.0
La version 2.0 rend l’IA moins portée sur les parties nulles, améliore la progression réelle de difficulté, et ajoute des animations pour les coups de l’IA ainsi que des avatars visuels selon le niveau.

### Gestion de partie plus robuste
La version 2.0 renforce aussi la gestion interne des calculs IA, évite les chevauchements d’actions et nettoie correctement les calculs en attente quand une partie s’arrête ou qu’un plateau disparaît.

---

## Contenu inclus

Le mod comprend :
- cases blanches et noires pour le plateau
- set complet de pièces blanches et noires
- pièces de dames
- horloge d’échecs
- double horloge d’échecs
- interface de configuration de l’horloge
- localisation anglaise et française

---

## Pourquoi installer ChessAI ?

Parce que parfois, on n’a pas besoin d’un boss démoniaque ou d’une explosion de particules.

Parfois, on veut juste un plateau en bois, une horloge qui tourne, une erreur au 12e coup, et une IA qui transforme ton excès de confiance en leçon tactique.

---

## Informations de version

- Mod : ChessAI
- Version : 2.0
- Minecraft : 1.20.1
- Forge : 47+

---

## Notes

- Détecte et gère un plateau complet 8x8 avant le lancement
- Compatible avec parties chronométrées ou non
- Conçu pour jouer réellement aux échecs en jeu, pas seulement pour décorer

Installe-le, pose le plateau, démarre l’horloge, et découvre si ta stratégie est brillante… ou juste très sûre d’elle pour rien.

Chess AI