Sachess › Help Center

Sachess Help: How to Use Every Xiangqi Feature | Chinese Chess

Step-by-step tutorial for every Sachess xiangqi feature: 3D Chinese chess, AI analysis, cloud book, game review, blunder check, photo-to-FEN, puzzles, and friends play.

Start with the five homepage modes, then learn file and text import, variations and commentary, browser saving, account linking and complete-game sharing. Continue to AI analysis, photo recognition, daily puzzles or friend play. Each task has ordered instructions, recovery advice and a direct tool link; saving, linking and syncing are explained separately. This page is built for Chinese chess (xiangqi).

Author: Sachess Development Team · Updated: 2026-11-18 · 0 Sources

Chaining features: end-to-end workflows

Many features chain together — the easiest usage to miss. Jump from one feature to the next without copy and paste.

Import → check → save → share → AI full-game analysis

Parse a file or text locally and check variations and comments. Save deliberately for a share link; open full-game analysis only when you want move-by-move scoring.

Browser save → explicit account link → another device

Guests can save. Confirm the intended account in the original browser, then sign in elsewhere. Keep links before clearing data; public IDs cannot restore management rights.

Daily challenge → completion → faster time → rankings

Start triggers the timer; repeat wins only improve a faster daily time. Daily identity claiming, season progress sync and uploaded-record linking are separate.

Photo to FEN to AI analysis

Recognize a FEN from a photo, then click Analyze to open the AI page and start analyzing automatically.

Chinese moves to full-game scoring to blunder check

Paste a plain Chinese move list and get per-move AI scores with mistakes and turning points marked.

FEN to board image or GIF

A FEN with moves can generate a static board image or an animated GIF replay in one click.

🚀 Getting Started

Learn the board, the five modes, optional Smart Link accounts, and offline use.

Five homepage modes and which side you play

The desktop mode bar offers Human Play, AI Plays Red, AI Plays Black, AI vs AI, and AI Infinite Analysis. A color in the button names the AI side, not your side.

  1. Choose Human Play to move both sides manually. This still follows move rules; use the position editor to rearrange pieces.
  2. With AI Plays Red you play Black; with AI Plays Black you play Red. Automatic moves happen only on the AI turn.
  3. AI vs AI moves both sides automatically. AI Infinite Analysis studies the current position without making the move for you.
  4. Desktop has board, moves, and thinking columns. On mobile use the mode selector and bottom controls. Return to Human Play to end automatic play.
Five homepage modes and which side you play →

Find and manage the two kinds of saved games

The account page separates games saved from the homepage or a room from uploaded complete records. Available actions and formats differ between the lists.

  1. Use Save to account for a homepage or room game. Complete sign-in if needed, then check the account list.
  2. Find imported files or text under Uploaded game records. Guests can expand Records saved with this browser. Use Load more for later entries.
  3. Open a complete record to copy its share link or start AI full-game analysis. Delete appears only for an owner. Do not assume that every uploaded format offers an original-file download.
  4. Keep a local backup before deleting. Clearing browser data does not delete server records. Retry a failed list request instead of importing the same file again.
Find and manage the two kinds of saved games →

Core tools need no registration

Core tools are free and work without registration or a download; an optional Smart Link account syncs selected data and saved games across devices.

  1. Open any tool page and use it immediately.
  2. Progress and board preferences are saved locally in your browser.
  3. Use email Smart Link only when you want cross-device sync.
About us →

Offline use and install to home screen

After the engine loads, basic analysis works offline; the site can be installed as a PWA.

  1. Let the engine finish loading on first use.
  2. On your phone use the browser menu and choose Add to Home Screen.
  3. Review, position analysis, and board editing keep working without a network.
About offline support →

URL shortcuts

URL parameters load a position or start analysis directly: ?fen= loads a position and ?analysis=1 starts the AI automatically.

  1. Append ?fen=<encoded FEN> to the homepage or FEN page URL to open that exact position.
  2. Add ?analysis=1 to auto-start engine analysis when the page opens.
  3. Use ?mode=editor to open a shared FEN directly in the editor.
Try a FEN link →

🎮 3D Chinese Chess

An isolated 3D play page that puts the Xiangqi board, pieces, camera, and capture feedback into a rotatable space.

What is 3D Chinese chess?

The 3D page uses an isolated Three.js scene for the redwood board, solid pieces, real-time lighting, and cinematic feedback. It does not add 3D scripts or image requests to the homepage. The move rules, FEN history, and Pikafish AI remain the same as on the lightweight 2D board.

  1. Open the 3D Chinese Chess page and wait for the WebGL scene and board to finish loading.
  2. Choose human vs AI or local two-player hot-seat mode, or simply explore the default opening position.
  3. If the device cannot run WebGL 2, use the page's 2D board link to keep playing.
Open the 3D board →

Top, angled, and edge camera views

The 3D page has top, angled, and edge presets. Top view feels close to a 2D board, angled view shows the board thickness and museum lighting, and edge view looks along the board surface so the pieces feel more suspended in space.

  1. Choose Top View for a complete board close to the traditional 2D reading angle.
  2. Choose 3D View to return to the default 45-degree museum composition.
  3. Choose Edge View for the low-angle floating effect; drag with the mouse to orbit and use the wheel to zoom.
Try the camera views →

Play on the 3D board

The 3D page supports playing Red or Black against AI, local two-player hot-seat, AI difficulty levels, legal-move hints, board flip and mirror, FEN import/export, undo, and history replay. After selecting a piece, glowing points show its legal destinations.

  1. Choose Play Red or Play Black in the right panel, or choose Manual for local two-player play.
  2. Click one of your pieces, then click a glowing legal destination; move validation reuses Sachess's mature Xiangqi rules.
  3. Use History to review moves, Flip or Mirror to change the reading direction, and FEN controls to save or restore a position.
Start a 3D game →

Capture effects and quality modes

Cannon captures use a projectile, explosion, and shockwave; horse captures use a rule-aware “horse moves in a 日 shape” energy slash; rook captures use a straight energy corridor and rectangular impact wall. Other pieces keep the standard capture presentation. Smart Cinematic mode shortens repeated special captures, while Full Cinematic always shows the complete performance.

  1. In Thinking Details, choose Smart Cinematic, Full Cinematic, Light Effects, or Off under Capture Effects.
  2. Choose Full Cinematic to see the complete light, particle, knockback, and camera feedback for horse, rook, and cannon captures.
  3. Lower-end devices automatically reduce particles and post-processing; this changes visual quality only, not rules, AI, or game data.
See the 3D effects →

🤖 AI Engine Analysis

The Pikafish engine runs directly in your browser, ready to analyze any position.

Start and stop AI Infinite Analysis

Infinite analysis studies the position without playing moves.

  1. Play moves or load FEN and check the side to move.
  2. Select AI Infinite Analysis on desktop or the analysis entry on mobile.
  3. Use Stop Thinking to finish; automatic play requires a separate game mode.
Start and stop AI Infinite Analysis →

Stop thinking, stop AI, or move immediately

The stop button follows the active mode. Analysis stops its search; during an AI turn it can finish searching and try to play the legal best move already found.

  1. In AI Infinite Analysis choose Stop Thinking to inspect the retained result. Select analysis again when you want to resume.
  2. During the AI turn in a game or AI vs AI, choose Stop and Move Now. Wait while the button reports that it is finishing; avoid repeated clicks.
  3. Return to Human Play to stop further automatic moves. If no legal best move was available, check the position and select the mode again to retry.
Stop thinking, stop AI, or move immediately →

Thinking details: depth, score and principal variation

Thinking details show the best move, search depth, score and predicted continuation for the current search. A predicted line is not the game’s played history.

  1. On desktop read the right thinking column. On mobile open the thinking panel and expand it if needed.
  2. Read the best move and depth, then the Red-perspective score: positive favors Red and negative favors Black. Mate scores differ from ordinary evaluation numbers.
  3. Follow the continuation alongside the board and actual moves. Changing the current position changes the analysis target. Use the score guide for evaluation terminology.
Thinking details: depth, score and principal variation →

Read thinking history by search depth

Desktop retains lines from different depths of the current search, with the newest depth separate from older entries. Search depth is not the number of moves played.

  1. Start analysis, read the newest depth, elapsed time and line, then compare older entries below it.
  2. Older entries refresh automatically. Hovering, scrolling or focusing the reading area pauses following so the text does not move while you read.
  3. Use the panel’s follow/latest control to catch up. A new position or search has its own results. Mobile uses an expandable thinking panel.
Read thinking history by search depth →

Best move and hint arrow

While analyzing, the board shows an arrow for the engine best move so you can spot the key line quickly.

  1. After starting analysis, read the best move in Thinking Details.
  2. Enable Show Best Move Arrow and a hint arrow appears on the board.
  3. Turn the arrow off anytime to see the list only.
Open analysis →

Evaluation bar

The vertical bar beside the board shows the current red/black advantage ratio and score.

  1. Start analysis and watch the bar update as the engine searches.
  2. A positive number favors Red; a negative one favors Black.
Open analysis →

Engine settings: threads, depth, time, rules

Adjust threads, search mode, depth, time, and repetition rules in the settings dialog.

  1. Click the gear icon in the top toolbar to open Settings.
  2. Adjust threads, depth-first or time-first mode, and the depth/time level.
  3. Choose Asian rules or Chinese rules and save.
Engine docs →

How to read engine scores

Scores are relative judgments, not absolute conclusions; understanding swings and candidates helps your review.

  1. Open the How to Read Engine Scores guide.
  2. Learn what the sign, the magnitude, and the swings mean.
  3. Practice on the analysis page.
Read the guide →

☁️ Cloud Book

The cloud book (ChessDB) collects real game statistics so you can see what most people play.

Open the cloud book

Open the cloud panel to see the most common moves for the current position with scores and win rates.

Note: Privacy: the current position FEN is sent to the third-party ChessDB cloud book; do not submit sensitive games.

  1. Click the Cloud tab in the side panel (tap Cloud in the bottom dock on mobile).
  2. The panel queries the current position and shows common moves, scores, and win rates.
  3. Click a row to play that move on the board.
Open cloud book →

Cloud book vs engine

The cloud book shows real game samples; the engine judges the position itself. Looking at both is safer.

  1. Read Cloud Book vs Engine to understand the difference.
  2. When analyzing, turn on both the cloud and the engine to compare.
Learn the difference →

Opening analysis

Analyze openings with the cloud book plus the engine: main lines, sidelines, and opening mistakes at a glance.

  1. Open the Opening Analysis page.
  2. Load your opening position and review the main lines with cloud data.
  3. Use the engine to verify sidelines.
Open opening analysis →

🗂️ Review and Blunder Check

Break a game apart and find the moves that decided it.

Import files, paste text and select a CBL game

Open XQF, CBL, CBR, PGN or TXT, or paste PGN, Chinese moves or FEN plus UCI. Selecting a file parses it in the browser; only an explicit save submits it to the server.

  1. Choose a record file, or select a text format, paste and parse the preview. PGN/TXT must be UTF-8. PGN accepts Xiangqi ICCS or Chinese notation, not international-chess SAN or English WXF.
  2. For CBL browse the game list, select and confirm one game. Each save keeps only that game, not the whole library or its other games. Keep the original library locally.
  3. Check the starting position, players, moves, variations and parser notices. A successful import replaces the static example with one game; cancelling file selection preserves the current display.
  4. Use Photo to FEN for images. Browser source reading is limited to 32 MiB; saving also requires server size and chess-rule validation. A successful preview is not a successful save.
Import files, paste text and select a CBL game →

Replay moves, choose variations and read commentary

Upload previews and shared records reuse the same board and move layout. Original author commentary is record content, not an automatically generated AI conclusion.

  1. Select a move or use start, previous, next and end controls. Move buttons support Left/Right and Home/End. Long lines can be paged.
  2. Select a move with a variation marker to open its variation rail. Choose a branch, then return to its starting point to switch back to the main line; branch origin and current move are marked separately.
  3. Open the commentary icon to read the original text. Open long comments in the dialog; a hover preview is not the full comment.
  4. Previewing does not start AI automatically. Save first, then deliberately choose AI full-game analysis from the record viewer.
Replay moves, choose variations and read commentary →

Save without sign-in and explicitly link an account

Saving uses a server-verified identity for the current browser. Its public browser ID is a label. Saved with this browser does not mean the file exists only on your device.

  1. Check the preview, choose Save and create share link, wait for success and copy the link. Selecting a file alone does not upload it.
  2. Without signing in, expand the records saved with this browser. Before linking, clearing browser data, changing browsers or switching devices may lose the management entry point.
  3. For cross-device access, sign into the intended account and explicitly confirm linking this browser’s records. Signing in alone is not confirmation.
  4. Share links stay unchanged after linking. The association cannot be transferred to another account. If the browser is already linked elsewhere, use the original account to find those records.
Save without sign-in and explicitly link an account →

Share a complete game and delete your own record

A saved record link retains its main line, variations and commentary. Anyone holding the link can read it and forward it to other people.

  1. Copy the link after a successful save or later from the record viewer. Recipients do not need an account to read it.
  2. Check comments and player details before sharing, remove passwords or contact information, and ensure you may share the content. Links do not provide invite-only private access.
  3. Only a server-verified owner can delete a record. Open your own record and confirm deletion after keeping a local backup. A public browser ID or share link is not a deletion credential.
  4. Read the upload/account page’s current storage policy or expiry state. Do not rely on online storage or a room invitation link as your only permanent backup.
Share a complete game and delete your own record →

Recover from import, save and share errors

Local preview and server saving are separate stages. The server rechecks the source, position, moves and size; bypassing an error or silently truncating content is not a remedy.

  1. For parser errors check format, encoding and file integrity. Some undecodable comments in old XQF files may be skipped with a warning; compare important commentary with the original.
  2. When preview succeeds but saving fails, distinguish illegal moves, size limits and service unavailability. Merely renaming the extension will not repair the record.
  3. A save timeout may mean the outcome is unconfirmed. Keep the preview, check saved records or retry on the same page rather than repeatedly selecting the file and creating duplicate imports.
  4. Refresh and check the account if the saving identity changes. For a broken share link check the full URL and whether the record was deleted or expired. Public IDs cannot recover management access.
Recover from import, save and share errors →

Desktop, mobile and keyboard replay

Homepage move history contains played moves, not the engine’s predicted continuation. Desktop replay controls sit below the move list; mobile keeps its bottom controls and history entry.

  1. Play a few moves or load a position with moves. Use the middle moves column on desktop or open history on mobile.
  2. Select a move to revisit its position and use start, previous, next and end controls. Switch the list between Chinese, traditional Chinese and UCI notation.
  3. Focus the board and use arrow keys to move, Enter to select or play, or Space to select or play. For record move-button shortcuts see the replay guide.
Desktop, mobile and keyboard replay →

Open a complete record in AI full-game analysis

Blunder checking compares each played move with reference best moves using the cloud book and local engine. It is different from a read-only upload preview.

Note: Privacy: blunder analysis sends the game to the ChessDB cloud book; do not paste private records.

  1. Paste Chinese moves or FEN plus moves. For a saved shared record choose AI full-game analysis in its viewer, check the imported preview and main line, then start.
  2. Read the overview, score graph and per-move results. Select important nodes to position the board. Local engine calculation can fill cloud-book gaps; watch for incomplete or unavailable results.
  3. Keep original author comments, temporary handwritten notes and engine scores distinct. Adding a note or analysis variation does not mean the original shared record has been rewritten.
  4. Start infinite analysis deliberately to study a node, then stop or change position. Cloud analysis sends the game to ChessDB; do not submit sensitive records.
Open a complete record in AI full-game analysis →

Chinese move list → blunder check

For per-move scoring of a whole game, use the Blunder Checker. The Analysis page input parses a move list and opens the final position for single-position AI analysis.

  1. Copy a Chinese move list starting from the standard position.
  2. Open the Blunder Checker and paste the move list; do not submit a private game to the cloud service.
  3. Start analysis to review every score, best move, and mistake label. Use the Analysis input only when you want the final position.
Check a move list →

Review workflow

Locate the turning points, then check the score changes and the cloud reference to turn review into an actionable checklist.

  1. Open the How to Review a Game Fast guide.
  2. Follow the flow to locate turning points and classify mistakes.
  3. Practice on the analysis page.
Read the review guide →

Endgame analysis

Use the engine to analyze endgames: win or draw, mating nets, and conversion lines.

  1. Open the Endgame Analysis page.
  2. Load an endgame position and start analysis.
  3. See the engine verdict on the result and the best mating line.
Open endgame analysis →

🧰 Position Tools

FEN is the portable format for sharing positions across tools; these utilities cover setup, recognition, and images.

Photo recognition, board corners and piece corrections

Recognition reconstructs one position, not a full game’s move history. Images are sent to the recognition service; check their contents before submitting.

Note: Privacy: the photo is uploaded to the recognition service; do not upload images containing personal information.

  1. Upload or paste a clear board photo and inspect the detected boundary. If needed adjust the corner points manually and confirm again.
  2. Check every piece and board orientation. Use the editor to correct missing, extra or misidentified pieces, and set the side to move.
  3. Resolve rule conflicts on the board and confirm a legal position before copying FEN or continuing to AI analysis. Recognition is not guaranteed to be correct.
  4. Use record upload for existing game files. If clipboard access is unavailable, use the manual-paste entry or file picker.
Photo recognition, board corners and piece corrections →

Load and export FEN

Load or export a FEN string from the FEN page or the board for saving and sharing a position.

  1. Open the FEN Load and Export page.
  2. Paste a FEN in the input box and click Generate Board Image.
  3. Click Export FEN on the board to copy the current position.
Open the FEN page →

Understand the FEN format

FEN records the board, side to move, and history in one line — the common way to share positions across platforms.

  1. Open the What Is Xiangqi FEN guide.
  2. Learn what each field means.
  3. Practice loading and exporting on the FEN page.
Read the FEN guide →

FEN examples library

Curated examples: the starting position, teaching positions, endgames, and FEN-with-moves review formats — copy and go.

  1. Open the FEN Examples page.
  2. Copy the example you need.
  3. Paste it on the FEN page to generate a board image.
Open examples →

Online position editor

Set up positions online, generate FEN, save them, and jump into AI analysis — great for teaching, puzzles, and review.

  1. Open the Position Editor page.
  2. Place red and black pieces, or adjust with move/delete/clear tools.
  3. Set whose turn it is, then copy the FEN or start analysis.
Open the editor →

Paste FEN to automatic AI analysis

Great for grabbing a FEN from a stream, app, or screenshot and seeing the best move instantly — analysis starts on load.

  1. Open the FEN to AI page.
  2. Paste a FEN (moves allowed); the page validates the moves, restores history, and starts Pikafish.
  3. Read the best move, depth, and score, or revisit a history node and continue analysis.
FEN to AI →

Generate a board image from FEN

On the FEN page, generate a static board image of any loaded position to save or share.

  1. Open a FEN page with the position (a shared link works directly).
  2. Click the Board Image button to generate the image.
  3. Save or copy the image.
Open the FEN page →

FEN with moves to animated GIF

When the FEN includes a moves sequence, generate an animated GIF replay with move highlights and Chinese notation.

  1. Open a FEN share link that contains moves.
  2. Click Generate Animated GIF and set speed and loop.
  3. Preview and download the GIF.
Try the GIF →

⚔️ Playing

Play against the engine in your browser, or create a room and play friends in real time.

Play the AI: choose the AI color

A mode’s color names the AI side, not your own.

  1. Choose AI Plays Black to play Red, or AI Plays Red to play Black.
  2. Choose depth or time in settings, play your turn and wait for the reply.
  3. During the AI turn you can stop and move now. Return to Human Play to stop automatic moves.
Play the AI: choose the AI color →

AI vs AI and returning to manual play

AI vs AI plays both colors, unlike analysis-only infinite thinking.

  1. Select AI vs AI and watch the moves and thinking line.
  2. You can finish a search and move now; wait while finishing.
  3. Return to Human Play to stop subsequent automatic moves, then choose another mode if needed.
AI vs AI and returning to manual play →

Create a friend room from a custom position

A room can start from the standard opening or a custom position for shared endgame study. A room invitation is not a complete saved record.

  1. Open Create Room, choose time control and load a starting FEN if needed. Check any position prefilled from another tool.
  2. Adjust pieces in the editor, choose the side to move and verify the FEN matches the board. Correct inline errors before creating the room.
  3. Send its link or code and explain whether your friend should play or spectate. Use account saving or record sharing separately for long-term retention.
Create a friend room from a custom position →

Room replay, account saving and invitation links

A room link lets someone join or spectate a retained room; it is not a promise of permanent game storage. Save deliberately when you need a record.

  1. After a game choose replay or a rematch. Check that the game you want to keep has been saved before starting another.
  2. Use Save to account in the room, sign in and provide a title, then verify it on your account page. FEN is useful for exchanging a position or move sequence.
  3. For a complete game that others can reopen, use a saved record’s share link. Do not keep only the room invitation as your archive.
Room replay, account saving and invitation links →

Play friends in a room

Create a free room and invite a friend for real-time play — no registration.

  1. Open the Play with Friends page and click Create Room.
  2. Send the room link or code to your friend.
  3. Play once both of you have joined.
Create a room →

Custom time controls, draws, and resign

Choose base time and per-move increment (Fischer) when creating a room; offer a draw or resign during play.

  1. Set the time control when creating the room.
  2. Offer a draw or resign from the in-game menu.
  3. Start a rematch or review after the game ends.
Play friends →

Auto-reconnect and spectating

If your connection drops, the page reconnects automatically; others can watch once a room is full.

  1. The page retries automatically on network hiccups.
  2. Spectators can join and watch.
  3. Unused rooms are cleaned up after a while.
Play friends →

Room chat and spectator interaction

Both players and spectators can use room chat to discuss the position or suggest the next idea.

  1. Open the chat area in the room side panel.
  2. Type and send a message; spectators can chat but cannot move.
  3. Do not share sensitive information in a public room.
Enter a friends room →

In-room voice and video calls

Only the two players can join an in-browser voice/video call inside the room; spectators can watch but cannot join the call.

Note: Limit: only the two players can join a call; spectators can watch only. Calls are not recorded, and the browser may use TURN relay.

  1. As Red or Black, click Join Call in the room side panel and allow the microphone.
  2. Turn the camera on or off anytime; spectators do not get call controls.
  3. Leaving the call releases your devices. Calls are not recorded, but the browser may use TURN relay.
Play friends →

AI handicap: start with an advantage

If a standard AI game feels too demanding, start with an advantage and practise converting it into a win.

With material odds, the AI gives up pieces and moves first as Black. With two, three or four opening moves already set up, you move first as Red.

Try one-rook odds first. Use the campaign map to advance: a win unlocks the next level, a draw does not. In unranked free play, choose any level, undo moves or choose which side the AI gives up pieces on where offered.

Progress stays in this browser. An invitation shares the starting position, not a live room, and AI replies may differ.

Start AI Handicap

⛰️ Endgame Puzzles

Red-to-move endgame challenges: you play Red, the AI plays Black, and you must win to advance.

Daily puzzle, timer, rankings and streaks

Daily puzzles are independent of season challenges. Everyone receives the same position for each UTC date; Red moves first and the timer starts only after Start.

  1. Open Daily Puzzle, check today’s position and press Start. The page shows roughly how long remains until the next UTC puzzle.
  2. Your first win completes the day. Repeat practice is allowed, but only a faster time updates that day’s score; it does not add another completion.
  3. Check today’s time, current streak, best streak and total-completion leaderboards, including your own rank. A gap in consecutive dates restarts the next streak at one.
  4. Before switching devices, sign in on the original browser and claim its daily identity as prompted; sign into the same account elsewhere and load data. A public player ID is not a recovery credential, and this claim differs from linking uploaded records.
  5. Retry a loading failure as directed. Season practice with ?level=N or opening AI assistance does not itself complete the daily puzzle.
Daily puzzle, timer, rankings and streaks →

Classic and new seasons and unlock order

The classic S1-S4 collection has 300 levels; the new S1-S11 collection has 720. Finish one season within its collection to unlock the next; classic and new progress are independent.

  1. Open classic S1 or new S1 and start at level 1.
  2. Find the winning Red move and advance.
  3. Unlock later seasons in order within the selected collection.
Start the challenge →

Ancient manual: Shi Qing Ya Qu

120 red-to-move mate endgames from the Ming-dynasty manual, independent of the classic and new collections.

  1. Open the Shi Qing Ya Qu page.
  2. Win each red-to-move mate to advance.
  3. Finish Season 1 to unlock Season 2 advanced positions.
Ancient challenge →

Practice mode with ?level=N

Jump straight to any level via the ?level=N URL parameter; practice wins never count toward completion.

  1. Add ?level=12 to the challenge page URL to open that level.
  2. Practice moves never affect your official progress.
Start the challenge →

AI engine assist

Stuck on a level? Send its initial FEN to AI analysis in one click to see the best move.

  1. Click AI Engine Assist beside the level board.
  2. A new tab analyzes that level FEN automatically.
FEN to AI →

Invite a friend to study

Create a friends room from the current puzzle position and study it together.

  1. Click Invite a Friend to Study.
  2. Once your friend joins, discuss the position together.
Play friends →

New Tiantian Xiangqi Chu–Han Contention Challenge

Practice the updated Tiantian Xiangqi Chu–Han Contention screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Five Hegemons of the Spring and Autumn Period Challenge

Practice the updated Tiantian Xiangqi Five Hegemons of the Spring and Autumn Period screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Seven Warring States Challenge

Practice the updated Tiantian Xiangqi Seven Warring States screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Romance of the Three Kingdoms I Challenge

Practice the updated Tiantian Xiangqi Romance of the Three Kingdoms I screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Romance of the Three Kingdoms II Challenge

Practice the updated Tiantian Xiangqi Romance of the Three Kingdoms II screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Heroes of Sui and Tang Dynasties I Challenge

Practice the updated Tiantian Xiangqi Heroes of Sui and Tang Dynasties I screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Heroes of Sui and Tang Dynasties II Challenge

Practice the updated Tiantian Xiangqi Heroes of Sui and Tang Dynasties II screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Heroes of Sui and Tang Dynasties III Challenge

Practice the updated Tiantian Xiangqi Heroes of Sui and Tang Dynasties III screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Golden Age of the Tang Dynasty I Challenge

Practice the updated Tiantian Xiangqi Golden Age of the Tang Dynasty I screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Golden Age of the Tang Dynasty II Challenge

Practice the updated Tiantian Xiangqi Golden Age of the Tang Dynasty II screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

New Tiantian Xiangqi Golden Age of the Tang Dynasty III Challenge

Practice the updated Tiantian Xiangqi Golden Age of the Tang Dynasty III screenshot-backed endgames.

  1. Open the new challenge page.
  2. Find Red's winning move and advance.
Open challenge →

🎨 Board and Personalization

Tune the board look and interaction feedback to your habits.

Board styles and piece styles

The top toolbar switches between several board styles and piece styles (including text pieces).

  1. Click the board/pieces buttons in the top toolbar.
  2. Pick a style you like from the menu.
  3. Your preference is saved automatically.
Open the board →

Dark and light themes

Switch between dark and light themes in one click.

  1. Click the theme button in the top toolbar.
  2. Toggle between dark and light.
Open the board →

Sound effects toggle

Mute move, capture, check, and game-end sounds in one click.

  1. Click the sound button in the top toolbar.
  2. Click again to restore sound.
Open the board →

Flip or mirror the board

Rotate the board 180 degrees or mirror it horizontally for the black-side view or your notation habit.

  1. Click Flip Board or Mirror Board in the action area.
  2. Click again to restore.
Open the board →

📤 Share and Export

Share the current position or a whole game with friends, documents, or social media.

Copy the board image

Render the current board as an image and copy it to the clipboard for documents or chats.

  1. Open the share menu and choose Copy Board Image.
  2. Paste it into a chat or document.
Open the FEN page →

GIF animation and board image export

See the Position Tools group for generating board images and GIFs from a FEN.

  1. Open a FEN share page with a position.
  2. Choose to generate an image or a GIF.
Try exporting →

🔧 Engine and Troubleshooting

Pikafish runs inside the browser; follow these steps if anything goes wrong.

Distinguish downloading, timeout and unsupported browsers

Diagnostics show download progress, capability checks and the failure stage. Reports should include the diagnostic ID and event history.

  1. For an initial download inspect progress and connectivity. At a timeout choose Continue Waiting or Retry as directed, avoiding repeated restarts.
  2. For unsupported or embedded browsers use the external-browser option with Chrome, Edge, Firefox or Safari. Changing thread count cannot supply missing browser capabilities.
  3. If it still fails, copy diagnostics and report your device, browser version, steps and diagnostic ID. Do not send passwords or email sign-in links.
  4. You can continue without the engine when appropriate. Cloud book, uploads, saving, account sync and photo recognition have their own network needs; caching does not make every feature work offline.
Distinguish downloading, timeout and unsupported browsers →

Contact form and useful problem reports

The contact form is below the friend-play page. You can also use [email protected] as listed on the About page.

  1. Open friend play, scroll to the contact form, enter salutation, name, email, subject and description, and complete the on-page verification before sending.
  2. Include the page, device, browser and reproducible steps. For engine problems attach the diagnostic ID and copied diagnostic information.
  3. Remove sensitive material from screenshots and records. Never send passwords, one-time login links or unrelated personal information.
Contact form and useful problem reports →

How the engine loads and browser requirements

Pikafish runs in the browser via WebAssembly and needs a modern browser with SharedArrayBuffer support.

  1. Open the Pikafish docs.
  2. Use the latest Chrome, Edge, Firefox, or Safari.
  3. The engine loads automatically the first time it is needed.
Engine docs →

Offline engine cache

Engine assets are cached on demand, so basic analysis keeps working offline after the first load.

  1. Load the engine successfully once.
  2. Basic analysis keeps working without a network afterward.
Engine docs →

📖 Rules and Learning

Start from the rules, or first work out how Chinese chess differs from international chess.

Chinese chess rules for beginners

From the board layout and piece moves to checkmate and special rules — start here.

  1. Open the Chinese Chess Rules guide.
  2. Learn the board, the piece moves, and how to win.
  3. Learn the common special rules, then practice on the board.
Learn the rules →

Chinese chess vs international chess

Compare the board, pieces, and win conditions of both games to decide which suits you.

  1. Open the comparison article.
  2. Understand the board, piece, and rule differences.
  3. Pick one to learn first and practice on the board.
See the comparison →

Player profiles hub

Browse career timelines, classic games, and interactive replays for grandmasters Wang Tianyi, Hu Ronghua, Xu Yinchuan, and Zheng Weitong.

  1. Open the Player Profiles hub.
  2. Pick a player to explore their career timeline and selected games.
  3. Click a game title to replay it on the interactive board.
Browse players →

Xiangqi engine history

From the earliest chess programs to Pikafish — trace the technical evolution and milestones of Chinese chess AI engines.

  1. Open the Engine Development History article.
  2. Learn how engines evolved from commercial software to open source.
  3. Compare the strengths and achievements of different engines.
Read the history →

Full Feature Checklist

Every tool page grouped below — handy for newcomers to browse and for testers to verify feature by feature.

AI Engine Analysis

Cloud Book

Review and Blunder Check

Position Tools

Playing

Endgame Puzzles

Rules and Learning

Frequently Asked Questions

Do I need to register or sign in?

Core tools are free and work without registration. An optional Smart Link account syncs selected settings and saved games across devices.

How is 3D Chinese chess different from the 2D homepage board?

The 3D page is an isolated Three.js experience with a three-dimensional board, camera presets, floating perspective, and cinematic capture effects. The homepage stays lightweight, while both views reuse the same move rules, FEN history, and Pikafish integration.

Does it work on mobile and desktop?

Yes. The pages are optimized for touch on phones, tablets, and desktop, and it is an offline-capable PWA.

Does AI analysis run on a server?

Core Pikafish analysis runs in your browser via WebAssembly. Cloud-book queries send the current FEN to third-party ChessDB, blunder checking sends the game to ChessDB, and photo recognition sends the image to the recognition service.

Can I use it offline?

Yes. After the engine loads once, basic AI analysis, review, and board editing keep working without a network.

I cannot remember every feature. What should I do?

This page groups every feature by scenario with direct links; bookmark it and come back any time.