Chess AI

# Changelog

## 2.1.0 - 2026-04-04

- Version bump to `2.1.0`.
- Added configurable clock max time in pre-game setup:
  - adjustable range through presets from `1` to `180` minutes per side
  - left/right click cycling in clock menu
  - current value displayed in the setup UI header
  - value persisted in match NBT save/load
- Updated timed-mode runtime to use configured per-side max time (knockout style) instead of fixed FIDE preset.
- Added explicit status/broadcast/localization support for time-limit configuration and timed mode labels.
- Added difficulty avatar tracking behavior:
  - generated avatar now rotates to follow nearest player movement while staying physically in place.

## 2.0 - 2026-03-31

- Version bump to `2.0`.
- AI strategy update to reduce draw tendency:
  - dynamic contempt bias (position and phase aware)
  - draw-avoidance scoring integrated into move ordering/evaluation
- AI strength profile reworked for levels `1..10` with practical target mapping from ~`500 Elo` to ~`2000 Elo`.
- Added visual difficulty avatars (non-AI mobs) bound to IA level:
  - level 1->10 mapped to progressively more threatening entities
  - avatars are persistent, silent, invulnerable, and cleaned on mode/board lifecycle transitions
- Added piece movement animation system using temporary visual entities.
- Animation flow refined for PvAI:
  - player moves are now applied instantly (no player-side animation)
  - IA moves are animated only
  - IA animation duration is now distance-based between `1.0s` and `2.0s`
  - IA move application is delayed until animation completion, then board state sync + result broadcast
- Internal clock/block-entity lifecycle hardening:
  - pending IA computation and pending IA animated move are both canceled/cleared on stop/remove/break
  - scheduling guard prevents overlapping IA turn computation while an IA animation is pending

## 1.3.0 - 2026-03-28

- Version bump to `1.3.0`.
- Fixed AI board orientation setup by anchoring board alignment to the placed white queen before game start.
- Added board orientation variants and orientation persistence during active games to keep square mapping stable.
- Added draw detection for:
  - threefold repetition
  - insufficient material
  - 75-move rule
- Added dedicated repetition hashing (`repetitionKey`) to avoid move-counter pollution in repetition detection.
- Added score notation display in end-state messages and status:
  - `1-0`
  - `0-1`
  - `1/2-1/2`
- Updated nearby AI/game-result broadcast from chat-only to action-bar display (`displayClientMessage(..., true)`).
- Added new `en_us` and `fr_fr` localization keys for the new draw outcomes.
- Updated project docs/version labels for `1.3.0` (`README.md`, Gradle properties).

## 1.2.0 - 2026-03-14

- Integrated chess piece resource pack visuals directly into the mod assets (no external pack required).
- Added an in-chat thank-you message when a valid board is detected and match initialization succeeds:
  - Credit to `noyj` ([planetminecraft.com/member/noyj](https://www.planetminecraft.com/member/noyj/)).
- Improved clock interaction reliability:
  - `sneak + right-click` now reliably opens the clock configuration menu.
- Documentation refresh:
  - Updated `README.md` for version `1.2.0`.
  - Added integrated resource-pack/credits section.