All the games you need

Setting up the board…

How to play xiangqi

Play xiangqi free against the computer at three levels, with a friend on the same screen, or with a friend on their phone, who joins with a party code or the link you send. No ads, no sign-up. How the board games work.

The board and the goal

Xiangqi is played on the points where the lines cross, not in the squares: nine files by ten ranks, ninety points in all. Across the middle runs the river, written 楚河 漢界, "the Chu river, the Han border", which splits the board into each side's own half. At each end is the palace, the three by three points marked with a cross.

Each side has sixteen pieces: a general, two advisors, two elephants, two horses, two chariots, two cannons and five soldiers. Red moves first, then the players take turns, one move each. The goal is to checkmate the other general: to attack it so that it has no way out.

Reading the pieces

The pieces are flat discs with their names written on them, in red for Red and black for Black. Some pieces have a different character on each side, but they move the same way.

General: 帥 (Red), 將 (Black). Advisor: 仕, 士. Elephant: 相, 象. Horse: 傌, 馬. Chariot: 俥, 車. Cannon: 炮, 砲. Soldier: 兵, 卒.

The general and the advisors

The general moves one point at a time along a line, forwards, backwards or sideways, and may never leave its palace.

The advisors move one point at a time diagonally, along the palace's cross, and may never leave the palace either. They stand guard beside the general.

The elephants

An elephant moves exactly two points diagonally, like the corner of a square two points wide. It cannot jump: if a piece stands on the point between (the elephant's eye), the move is blocked. Elephants may never cross the river, so they only ever defend.

The horses

A horse moves one point along a line and then one point diagonally outward, landing two points one way and one the other, like a chess knight. Unlike a knight it cannot jump: if a piece stands on the point next to the horse in the direction it starts out (its leg), that way is blocked. A horse can be hobbled from one side and still move freely to the other.

The chariots and the cannons

The chariot moves any number of points along a file or a rank, as long as nothing is in the way, and captures the first piece of the other side it meets. It is the strongest piece on the board.

The cannon moves exactly like a chariot when it does not capture. To capture, it must jump over exactly one piece of either side (its screen) on the line, landing on the first piece of the other side beyond it. With no screen, or with two, it cannot capture.

The soldiers

A soldier moves one point straight forward. Once it has crossed the river it may also move one point sideways, but never backwards. A soldier that reaches the far rank stays a soldier and can then only move sideways; there is no promotion.

Check, and the generals facing

A general that is attacked is in check, and the player must get it out at once: by moving it, by capturing the attacker, or by putting a piece in the way (or taking away a cannon's screen). No move may leave or put your own general in check.

The two generals may never face each other on the same file with nothing between them. A move that would leave them facing is not allowed, so the general works like a chariot down its file: it holds the other general off that file.

Checkmate and stalemate

When a general is in check and there is no way out, it is checkmate and the side that gave it wins.

Unlike chess, stalemate is not a draw: a player who has no legal move on their turn, even without being in check, has lost.

Repetition and draws

When the same position stands for the third time with the same player to move, the moves in between are looked at. A player who gave check with every one of their moves while the other did not has been checking for ever (perpetual check), and loses. Otherwise, when both sides checked all the time or neither did, the game is a draw.

Tournament rules also forbid chasing the same piece for ever; this table does not judge chases, and treats such a repetition as a draw.

The game is also drawn after sixty moves by each side without a capture, unless the last of them gives mate, and at once when neither side has a chariot, horse, cannon or soldier left, since advisors and elephants never cross the river and no one could mate. A player may resign, and the players may agree a draw.

Writing the moves down

The moves list uses the notation of the World Xiangqi Federation. The files are counted 1 to 9 from each player's own right, so the same file has a different number for Red and for Black. A move is written as the piece (K general, A advisor, E elephant, H horse, R chariot, C cannon, P soldier), the file it starts on, + for forward, − for backward or = for sideways, and last the file it lands on, or for a piece moving straight up or down a file, the number of points it moves.

So C2=5 is the cannon on file 2 moving across to the central file, the commonest first move, and H8+7 a horse from file 8 jumping forward to file 7. When two pieces of a kind stand on one file, + and − (the front and the rear one) take the file's place: R+=4.

Playing the computer

Easy looks only at its move and your reply, and often picks a move short of its best, but it will take a piece you leave hanging. Medium looks two moves ahead for each side and punishes most mistakes. Hard thinks for up to a second and a half each move, sees combinations many moves deep, and never misses a short mate.

Questions people ask

Is stalemate a draw in xiangqi?
No. In xiangqi a player with no legal move loses, whether or not their general is in check. Trapping the other side so it cannot move is as good as mate.
Can the two generals face each other?
No. The generals may never stand on the same file with nothing between them, so a move that would leave them facing is illegal. This "flying general" rule lets a general help to mate the other from across the board.
How does the cannon capture?
By jumping over exactly one piece, of either side, on its line and landing on the piece it takes beyond it. Without a screen it cannot capture, and it never jumps when it moves without capturing.
Can elephants and advisors cross the river?
No. Elephants stay on their own side of the river and advisors stay in the palace, with the general. Only chariots, horses, cannons and soldiers can attack the other side.
What happens with perpetual check?
The side giving it loses. When a position repeats for the third time and one player gave check with every move while the other did not, the checking player loses. If both sides checked every move, or neither did, the game is a draw.
Why do the red and black pieces have different characters?
Tradition: several pieces are written with a different character on each side (帥 and 將 for the general, 相 and 象 for the elephant, 兵 and 卒 for the soldier), but they are the same piece and move the same way.
Do soldiers promote when they reach the end?
No. A soldier on the last rank stays a soldier and can only move sideways, one point at a time. It is still useful next to the palace, but it is usually best kept a rank or two short of the end.
What does a move like C2=5 or H8+7 mean?
It is WXF notation: the piece, the file it is on counted from the mover's right, the direction (+ forward, − back, = sideways) and the file it reaches or, for a straight move along a file, how many points it goes. C2=5 moves the cannon on file 2 across to the middle file.

More board games