cools maths gamesSurprise me

Xiangqi

Chinese chess on a 9x10 point board, against a three-level computer or a friend sharing your screen.

Xiangqi title screen
  • Works on mobile
Report a problem

Xiangqi is Chinese chess, played on the points where lines meet rather than inside squares. The 9x10 board has a river across the middle and a small palace on each side. Your goal is to checkmate the enemy General, and you can play against a three-level computer or a friend.

How Xiangqi Works

Red moves first, and each turn you move one piece. Landing on an enemy piece captures it. You win by checkmate, or by leaving the other side without any legal move.

Every piece moves its own way. The General steps one point straight and the Advisors one point diagonally, and both stay in the palace. Elephants move two points diagonally and cannot cross the river. Horses move one point straight then one diagonally, but a piece on that first point blocks them. Chariots slide any distance in a straight line. Cannons move like chariots but capture by jumping exactly one piece. Soldiers step forward, and after crossing the river they can also step sideways.

The two Generals may never face each other on an open file, and the game will refuse any move that allows it. Forcing a repeated position with endless checks or chases is not allowed either.

Your First Few Minutes

  1. Pick red and the Easy level, then click “New game”.
  2. Click “Switch to symbols” if the Chinese characters are new to you.
  3. Move a cannon to the center file to aim at the enemy General.
  4. Bring out a horse before the board gets crowded.
  5. Open the Moves list to look back over the game.

Controls for Xiangqi

Keyboard, mouse and touch controls for Xiangqi
To do thisKeyboardMouseTouch screen
Move a pieceTab to the board, arrow keys to reach a point, Enter on your piece and again on its targetClick your piece, then click the point it should move toTap your piece, then tap its target point
Switch between character and symbol piecesnot usedClick "Switch to symbols" or "Switch to characters"Tap "Switch to symbols" or "Switch to characters"
Show or hide the move listnot usedClick "Moves"Tap "Moves"
Choose side and opponentnot usedPick red or black and a level, then click "New game"Pick red or black and a level, then tap "New game"
Undo or resignnot usedClick "Undo" or "Resign"Tap "Undo" or "Resign"

What It Trains

Xiangqi is deep strategy. You plan several moves ahead, watch for cannon screens and horse blocks, and think about what your opponent wants next. Learning the special rules, like the facing Generals, gives you extra tactics to use.

Strategy Notes

  • Use a central cannon. It aims at the enemy General from the start.
  • Free your horses early. A horse blocked by its own pieces is weak.
  • Get chariots onto open lines. They are the strongest pieces on the board.
  • Mind the cannon screens. Any piece in between, even your own, lets a cannon capture.
  • Pin with your General. The facing rule can freeze an enemy piece on the center file.

Good to Know

It plays with mouse, touch or keyboard and includes Undo and Resign. Xiangqi comes from Christopher Müller’s open-source PaperGames collection.

Xiangqi questions and answers

Is Xiangqi hard to learn?

The basic moves take a short while to learn, especially the cannon jump and the blocked horse. Getting good takes much longer. The symbol pieces and the Easy computer make the early games much friendlier.

How does a game end?

You win by checkmating the enemy General or by leaving your opponent with no legal move. Some repeated positions end in a draw, and either player can resign at any time.

Can two people play on one device?

Yes. Choose the two-player option and take turns on the same screen. Red always moves first, so decide who takes which side before you start.

Is my game saved?

Yes. The game in progress is stored in your browser, so you can close the page and continue on a later visit on the same device. Your choice of character or symbol pieces is remembered too.

Games that use planning ahead like Xiangqi

Different rules, same kind of thinking.

Try something from another shelf