Is xiangqi hard to learn?

These answers restate the rules implemented by our open-source engine, which follows the WXF laws and is regression-tested against the official 110-diagram repetition casebook. Where an answer refers to a specific position, that position lives on the linked reference page, where the build verifies it against the engine before publishing.

Direct answer

The rules are easy — about fifteen minutes, and fewer special cases than chess, with no castling, no en passant and no promotion. What takes time is seeing the board: the cannon needs exactly one screen, and the horse can be blocked, so lines open and close in ways your eye is not trained for.

What beginners find hardest

  • The cannon's screen. A cannon aimed at a piece with nothing between them is not attacking it. Counting one piece, every time, is a habit that takes weeks.
  • The horse's leg. Blocked at the point it steps through, not the point it lands on. Chess players miss this constantly.
  • The flying general. Your own general attacks down its file, which is free help you will forget you have.

What is easier than chess

There is no promotion to track, no castling rights, no en passant, and the general cannot run: it is stuck on nine points. Endgames are shorter and more decisive because stalemate loses. Many players find xiangqi endgames far easier to learn than chess ones.

Related questions

Is xiangqi harder than chess?

Different, not harder. Xiangqi is sharper and more tactical early; chess has more positional slow play. See the full comparison.

How long until I stop losing badly?

Usually a few dozen games. Almost all early losses are hung pieces and missed cannon threats, both of which go away with volume.

Try it on a real board

Reading an answer is one thing; playing it is another. Free, instant, and nothing to install.