Playing guide
These options and rules describe the current JoyPip version. Choose a mode above before starting; rules are also available during play.
Step-by-step examples
Select a step to see what changes. These are partial examples, not full starting positions.
Practice options
- Bot difficulty
- Beginner · Amateur · Professional · Master
- Play as
- Cho (moves first) · Han (moves second, +1.5 points) · Random
Private room options
- Main time
- 5 minutes · 10 minutes · 20 minutes
- Move timer
- 20 seconds · 30 seconds · 60 seconds
Detailed rules and controls
How the pieces move
- General (Cho/Han) and guards: one step along the palace lines, diagonals included; they never leave the palace
- Chariot: any distance in a straight line; also along the palace diagonals
- Cannon: moves or captures by jumping exactly one piece (the screen), in straight lines or along the palace diagonals; the screen cannot be a cannon, and a cannon cannot capture a cannon
- Horse: one step straight, then one step diagonally; blocked if the first point is occupied
- Elephant: one step straight, then two steps diagonally; blocked if either point on the way is occupied; it may cross into the enemy half
- Soldier: one step forward or sideways, never backward; inside the enemy palace also forward along the diagonals
Setup
- The four setups are read left to right from your own side: Horse-Elephant-Horse-Elephant (right elephants), Elephant-Horse-Elephant-Horse (left elephants), Horse-Elephant-Elephant-Horse (inner elephants), Elephant-Horse-Horse-Elephant (outer elephants)
- Both players choose at the same time without seeing each other’s choice; online you have 30 seconds, after which Horse-Elephant-Elephant-Horse is used
Winning and scoring
- Checkmate wins. When in check you must answer it: no passing, and no move may leave your general in check
- Material points: chariot 13, cannon 7, horse 5, elephant 3, guard 3, soldier 2; Han gets another 1.5, so scores never tie
- Bikjang (the generals facing each other on an open file) only counts after the first capture. Creating it offers a decision on points: if the opponent does not break it with the next move (passing included), the game ends on material points
- Consecutive passes, the same position three times, 200 moves in total (passes included), or only generals and guards left on both sides: decided on material points
- Notation uses two-digit points: rank first (1–9, 0 counting from Han’s back rank), then file (1–9 from the left), with the piece letter in between, e.g. 02H83
Controls
- Tap your piece, then its destination: green dots are points you can reach, dashed outlines are pieces you can capture
- Material points are shown under the board, with the Pass button on the right
- Keyboard: arrow keys move the cursor, Enter or Space selects and moves, Esc cancels the selection
Frequently asked questions
How does the Janggi cannon differ from the Xiangqi cannon?
A Janggi cannon needs a screen even for a non-capturing move. It cannot use another cannon as that screen or capture a cannon. An apparently open line can therefore be unusable.
Do I need a download or a linked email?
Play directly in your browser without a download. Linking email is an optional way to recover your account. Before clearing browser data, consider whether you need to keep your account or local records.
Do matches earn or spend coins?
Earn coins by checking in and spend them on cosmetics. Matches never cost or award coins.
