Chess AI

# Changelog

## 2.2.0 - 2026-04-15

- Stabilization release branch finalized as `2.2.0`.
- Opening/strength package completed:
  - integrated weighted opening book with Elo-aware usage and variation depth
  - improved level 9/10 strategic evaluation for ~2000 Elo target (middlegame/endgame terms)
  - stronger draw-avoidance behavior in balanced positions
- Board/clock placement improvements:
  - automatic fallback to the opposite flank if the preferred side is blocked
- Captured-piece presentation:
  - captured pieces are displayed on the side opposite the clock
  - display layer is fixed at `boardY + 1`
  - capture displays refresh correctly on sync/load/stop/removal
  - captured pieces are persisted in NBT and restored after reload
- AI opponent presentation:
  - difficulty avatar placement is now board-orientation aware 
- Stabilization scope restrictions:
  - wood set disabled in active gameplay for this release
  - wood content removed from creative tab and wood recipes removed
  - wood registry IDs kept for save compatibility
- Large clock availability reduced for stability:
  - removed from player-facing recipe flow
  - excluded from creative tab

## 2.1.0 - 2026-04-04

- Added configurable initial clock time in setup UI:
  - preset range from `1` to `180` minutes per side
  - left/right cycling in clock menu
  - persisted through NBT save/load
- Updated timed mode to use configured knockout limits instead of fixed presets.
- Added status/broadcast localization for time-limit and timed-mode states.
- Added difficulty avatar tracking:
  - avatar tracks nearest player with head/body rotation while staying in place.

## 2.0.0 - 2026-03-31

- Reworked AI progression across levels `1..10` with practical target range ~500 to ~2000 Elo.
- Added draw-avoid strategy layer:
  - dynamic contempt and draw pressure integrated into evaluation/order flow.
- Added difficulty avatars (non-AI mobs) mapped by level.
- Added piece-move visual animation pipeline.
- PvAI animation behavior update:
  - player moves apply instantly
  - AI moves are animated only
  - AI animation duration scales with move distance (`1.0s` to `2.0s`)
  - move commit is delayed until animation end, then synced/broadcast
- Hardened lifecycle safety for async AI:
  - pending AI compute/animation tasks canceled on stop/remove/break
  - guard against overlapping AI scheduling

## 1.3.0 - 2026-03-28

- Fixed white-side orientation bootstrap:
  - board alignment now anchors to the placed white queen.
- Added orientation persistence for active matches.
- Added draw detection:
  - threefold repetition
  - insufficient material
  - 75-move rule
- Added repetition hash key (`repetitionKey`) to isolate repetition logic from move counters.
- Added score notation in final game status:
  - `1-0`
  - `0-1`
  - `1/2-1/2`
- Updated nearby result messages to action bar (`displayClientMessage(..., true)`).
- Added localization keys (`en_us`, `fr_fr`) for draw outcomes.

## 1.2.0 - 2026-03-14

- Embedded chess piece visuals directly in mod assets (no external resource pack required).
- Added in-chat resource credit message on successful board detection/start.
- Improved clock interaction reliability (`sneak + right-click` config open).
- Documentation refresh for integrated assets/credits.