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
- Pick red and the Easy level, then click “New game”.
- Click “Switch to symbols” if the Chinese characters are new to you.
- Move a cannon to the center file to aim at the enemy General.
- Bring out a horse before the board gets crowded.
- Open the Moves list to look back over the game.
Controls for Xiangqi
| To do this | Keyboard | Mouse | Touch screen |
|---|---|---|---|
| Move a piece | Tab to the board, arrow keys to reach a point, Enter on your piece and again on its target | Click your piece, then click the point it should move to | Tap your piece, then tap its target point |
| Switch between character and symbol pieces | not used | Click "Switch to symbols" or "Switch to characters" | Tap "Switch to symbols" or "Switch to characters" |
| Show or hide the move list | not used | Click "Moves" | Tap "Moves" |
| Choose side and opponent | not used | Pick red or black and a level, then click "New game" | Pick red or black and a level, then tap "New game" |
| Undo or resign | not used | Click "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.















