The xiangqi rules, explained plainly: the board and river, how each piece moves and captures, check and checkmate, and the quirks that decide close games.
Here are the xiangqi rules in a nutshell: two players move one piece per turn across a nine-by-ten grid, Red goes first, and you win the moment the enemy General can't escape capture. Pieces sit on the intersections. A river runs across the middle. The General and its Advisors are trapped in a small palace and never come out. Everything past that is detail — important detail, but detail.
The good news is that the xiangqi rules are logical almost to a fault. There's very little to memorize by rote; once you see why a rule exists, you rarely forget it. I'll go through the board, the pieces, how you win, and the handful of special rules that quietly decide close games — the ones new players break without even realizing.
The board, and why it's not squares
Nine lines across, ten lines down, pieces on the crossings — 90 points in all. That's more room than a chessboard's 64 squares, and because you play on the lines, the outer edges are fully in play too. If you're coming from chess, this is the rule your eyes have to relearn first.
The river is the blank strip across the center. It's not just scenery: Elephants can't cross it, and Soldiers only unlock sideways movement once they do. At each end is the palace, the little three-by-three box with the diagonal cross. The General and both Advisors stay inside it for the entire game — no exceptions, no emergencies, no stepping out to run away.
Files are usually counted from each player's own right-hand side, which matters once you start reading move notation, but you don't need any of that to play your first game. For now, just train your eye to see the grid as a web of points, with the river splitting it in two and a palace anchored at either end. That picture is most of the battle.
How every piece moves and captures
The General moves one point straight and stays home in the palace. Each Advisor moves one point diagonally, also palace-bound. The Elephant moves two points on the diagonal, can't wade across the river, and is blocked cold if anything sits on the midpoint of its path — the elephant's eye. Those three form your defensive knot around the General.
The Horse steps one straight then one diagonal, but it's not a true knight — set a piece on the point directly beside it and it can't make that move at all. That's hobbling the leg, and learning to do it to the enemy's Horse is a genuine skill. The Chariot is a straight-line slider, exactly like a rook, capturing the first enemy piece it meets. The Cannon slides the same way, but here's the twist: to capture, it has to hop over exactly one piece — a screen — and land on the target on the far side. One screen, no more, no fewer.
The Soldier goes one point forward and nothing else until it crosses the river; after that it can also slide one point left or right. It never retreats and it never promotes. Every piece captures by landing on the enemy's point — the Cannon's leap is the one exception to how capturing normally works.
Check, checkmate, and the stalemate trap
Threaten to take the enemy General next move and you've put it in check. Your opponent has to deal with it right now — move the General, block the attack, or capture the attacker. There's no such thing as ignoring a check to do something else; you answer it or you've lost. Run them out of every one of those options and it's checkmate. Game over, you've won.
Here's a rule that catches chess players badly: stalemate is a loss, not a draw. If it's your opponent's turn and they have no legal move at all, they lose. That flips how endgames work — sometimes you win not by checking, but by quietly taking away every square they have left. Keep an eye on it when the enemy pieces start running out of room.
The flying general and the repetition rules
The famous one: the two Generals can never face each other straight down an open file with nothing between them. That's the flying-general rule. Any move that would leave them eye to eye is simply illegal, which means your General projects an invisible line down its file — a piece caught between the two Generals often can't move at all without exposing its own boss.
This isn't trivia; it wins endgames. You can march your General up to face the enemy's and freeze a defender in place, or spring a mate that seems to come out of nowhere. Before any move, glance down your General's file and check you're not about to open that fatal line yourself.
There's also a limit on endless checking. You can't just check the enemy General forever to force a draw — the player giving perpetual check is generally made to change the move, and refusing can cost you the game. The same spirit applies to relentlessly chasing an undefended piece. The rules are built to keep games moving toward a real result.
The rules beginners break most
A few honest ones I see all the time: trying to move a General diagonally (it can't), sliding an Advisor or General out of the palace to escape (never allowed), expecting a Soldier to move sideways before it has crossed the river (not yet), and forgetting the flying-general line until it's too late. None of these are hard — they just aren't the rules chess taught you.
Get these straight and you'll never make an illegal move again, which frees up all your attention for the actual game. The surest way to lock them in is to just play — start a game on XiangqiPlay, and after a handful of matches the rules stop being rules and start being instinct.