Skip to content

tinker-chinese-chess

A polished 3D Chinese chess game for TINKER, built with Three.js.

Screenshot

Highlights

  • Classic Xiangqi rules — play on a standard 9×10 board with palaces, river lines, flying generals, check, checkmate, and stalemate
  • Play your way — local two-player mode or a computer opponent with Beginner, Steady, and Master difficulty
  • Thoughtful computer opponent — opening gambit book, alpha-beta search, iterative deepening, and move ordering
  • Tactile 3D board — wood-textured board and pieces, subtle drop animations, contact shadows, and orbit controls
  • Flexible controls — mouse, touch, keyboard, WASD, and gamepad support with move and capture sound effects

Installation

Play directly in browser, or install via TINKER: download from https://tinker.liriliri.io/, then run npm i -g tinker-chinese-chess.

How to Play

  1. Choose local two-player mode or play against the computer, then select a difficulty.
  2. Click a piece to see its legal moves, then click a highlighted position to move.
  3. Use the arrow keys, WASD, or a gamepad to move the cursor and confirm with Space or Enter.
  4. Drag the board to rotate the view, or use the right mouse button to pan.

Released under the AGPL-3.0 License.