Xiangqi Unblocked
Cannons that hop, horses that can be blocked and two Generals who must never see each other.
What is Xiangqi?
Xiangqi, also called Chinese chess, is a two-player strategy game played on the points of a 9x10 board divided by a river. Each side commands a General, advisors, elephants, horses, chariots, cannons and soldiers. Victory comes from checkmating the rival General or leaving your opponent with nothing legal to play.
- Category
- Strategy Games
- Players
- 1–2+ players (same screen)
- Plays on
- Phone, tablet & desktop
- Input
- Mouse, Touch, Keyboard
- Made by
- Christopher Müller
- Checked
Xiangqi looks familiar to chess players for about five seconds. Then you notice the pieces sit on line crossings, a river cuts the board in half, each General is boxed into a small palace, and the cannons capture by hopping over another piece. It plays faster and more tactically than many people expect. This unblocked Xiangqi comes from Christopher Müller’s PaperGames. Take either color against an AI with Easy, Medium and Hard settings, or invite a friend to share your device. A single button turns the Chinese characters into small pictures, which is a big help if you are new.
Meet the Pieces
Red opens the game. You capture by moving onto an enemy piece, and you win by checkmate or by leaving your opponent with no legal moves.
- General. One point orthogonally, never leaving the 3x3 palace.
- Advisor. One point diagonally, also confined to the palace.
- Elephant. Exactly two points diagonally. It cannot cross the river, and a piece on the midpoint blocks it.
- Horse. One point straight, then one diagonally outward. A piece on that first point stops it.
- Chariot. Slides as far as it likes along a row or column. The strongest piece on the board.
- Cannon. Travels like a chariot when not capturing. To take something, it must leap over exactly one piece, friend or foe, on the way to its victim.
- Soldier. One point forward. After crossing the river it may also step sideways.
Two special rules round it out. The two Generals are forbidden from staring at each other down a file with nothing in between, and the board refuses any move that would cause that. Forcing the same position a third time with nonstop checks or chases is also banned.
Xiangqi controls
| To do this | Keyboard | Mouse | Touch |
|---|---|---|---|
| Make a move | 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 |
| Swap Chinese characters for picture pieces | — | Click "Switch to symbols" or "Switch to characters" | Tap "Switch to symbols" or "Switch to characters" |
| Open or close the move record | — | Click "Moves" | Tap "Moves" |
| Pick a color and the AI level | — | Pick red or black and a level, then click "New game" | Pick red or black and a level, then tap "New game" |
| Take back or concede | — | Click "Undo" or "Resign" | Tap "Undo" or "Resign" |
Opening Ideas and Tactics
A classic start
Slide a cannon to the center file. From there it targets the opposing General, using the central soldier as its jumping platform, and your opponent has to react immediately. Follow up by bringing out a horse to protect your center soldier.
Develop before you attack
Horses get stuck easily behind their own pieces, so move them out early. Chariots want open files, where they can swing to either side of the river in one move.
Watch every screen
A cannon needs a platform. Whenever a single piece of any color stands on the line between a hostile cannon and one of your pieces, that piece is in danger. Before you move a piece onto a file or rank shared with an enemy cannon, check whether it would become the screen for a capture.
The facing Generals rule as a weapon
Your General can freeze an enemy piece on the central file: if that piece stepped aside, the Generals would have a clear line, which is illegal. Use that to freeze defenders in place.
Who It Suits
Xiangqi rewards players who enjoy chess tactics but want something fresh. The move list records each game in coordinate notation, Undo helps with study, and your current game is saved between visits. For Japan’s take on the chess family, try Shogi, or play the familiar version in Chess vs Computer.
Xiangqi: questions players ask
Is Xiangqi harder than Western chess?
Not harder, just different. Many pieces are more restricted, which makes the opening easier to grasp, but the cannon's jump capture and the blocking rules for horses and elephants take some games to get used to.
Can I play Xiangqi without reading Chinese?
Yes. Press 'Switch to symbols' and every piece becomes a small picture, so you can tell horses, elephants, chariots and cannons apart at a glance. The setting is remembered, so it stays that way on your next visit.
Is stalemate a draw in Xiangqi?
No. A player who has no legal move loses, even if they are not in check. The game applies this rule, so smothering the enemy General until it has no safe moves wins outright.
Why was my move refused?
It may expose your General to the enemy General along an open file, which is never allowed. Or it may bring about a position for the third time while you keep checking or keep hunting an undefended piece, and that kind of repetition is blocked.
Credits and license
Xiangqi was created by Christopher Müller and released as open source. FreezeNova hosts a lightly adapted copy on its own server, together with the original license file.
- Source code: github.com/YourChaosChris (original project)
- Code license: MIT
- Art & audio: Board and character pieces: MIT. Optional symbol pieces: CC BY 4.0, adapted by Christopher Müller from Kadagaden's xiangqi_wikipedia_intl_modded set (github.com/Kadagaden/chess-pieces), itself modified from Wikimedia Commons drawings by Inductiveload (public domain per Commons; listed as CC BY-SA in the PaperGames notice)
- Our changes: Only the PaperGames Xiangqi page is hosted here, in English. The service worker, language menu, an unused chess piece file and links to other pages of the original site were removed, and we added a license and credits file for the piece art. Rules and AI are unchanged.