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.
Choose Human Play to move both sides manually. This still follows move rules; use the position editor to rearrange pieces.
With AI Plays Red you play Black; with AI Plays Black you play Red. Automatic moves happen only on the AI turn.
AI vs AI moves both sides automatically. AI Infinite Analysis studies the current position without making the move for you.
Desktop has board, moves, and thinking columns. On mobile use the mode selector and bottom controls. Return to Human Play to end automatic play.
A Smart Link is a one-time email sign-in link without a password. Settings sync, daily-puzzle identity claiming, and linking uploaded records are separate operations.
Open the account page, enter your email, open the emailed link and confirm sign-in as prompted. Never forward that link.
On your original device choose Sync local data. On another device sign into the same account and choose Load account data; read the on-page notice before loading.
Claim daily-puzzle identity from its own page. For uploaded records explicitly confirm linking this browser’s records to the current account; signing in alone does not do this.
Check the current email after changing accounts. Public player IDs and browser IDs are labels, not passwords or standalone recovery credentials.
The account page separates games saved from the homepage or a room from uploaded complete records. Available actions and formats differ between the lists.
Use Save to account for a homepage or room game. Complete sign-in if needed, then check the account list.
Find imported files or text under Uploaded game records. Guests can expand Records saved with this browser. Use Load more for later entries.
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.
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.
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.
Open the 3D Chinese Chess page and wait for the WebGL scene and board to finish loading.
Choose human vs AI or local two-player hot-seat mode, or simply explore the default opening position.
If the device cannot run WebGL 2, use the page's 2D board link to keep playing.
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.
Choose Top View for a complete board close to the traditional 2D reading angle.
Choose 3D View to return to the default 45-degree museum composition.
Choose Edge View for the low-angle floating effect; drag with the mouse to orbit and use the wheel to zoom.
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.
Choose Play Red or Play Black in the right panel, or choose Manual for local two-player play.
Click one of your pieces, then click a glowing legal destination; move validation reuses Sachess's mature Xiangqi rules.
Use History to review moves, Flip or Mirror to change the reading direction, and FEN controls to save or restore a position.
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.
In Thinking Details, choose Smart Cinematic, Full Cinematic, Light Effects, or Off under Capture Effects.
Choose Full Cinematic to see the complete light, particle, knockback, and camera feedback for horse, rook, and cannon captures.
Lower-end devices automatically reduce particles and post-processing; this changes visual quality only, not rules, AI, or game data.
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.
In AI Infinite Analysis choose Stop Thinking to inspect the retained result. Select analysis again when you want to resume.
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.
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.
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.
On desktop read the right thinking column. On mobile open the thinking panel and expand it if needed.
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.
Follow the continuation alongside the board and actual moves. Changing the current position changes the analysis target. Use the score guide for evaluation terminology.
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.
Start analysis, read the newest depth, elapsed time and line, then compare older entries below it.
Older entries refresh automatically. Hovering, scrolling or focusing the reading area pauses following so the text does not move while you read.
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.
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.
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.
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.
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.
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.
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.
Select a move or use start, previous, next and end controls. Move buttons support Left/Right and Home/End. Long lines can be paged.
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.
Open the commentary icon to read the original text. Open long comments in the dialog; a hover preview is not the full comment.
Previewing does not start AI automatically. Save first, then deliberately choose AI full-game analysis from the record viewer.
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.
Check the preview, choose Save and create share link, wait for success and copy the link. Selecting a file alone does not upload it.
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.
For cross-device access, sign into the intended account and explicitly confirm linking this browser’s records. Signing in alone is not confirmation.
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.
A saved record link retains its main line, variations and commentary. Anyone holding the link can read it and forward it to other people.
Copy the link after a successful save or later from the record viewer. Recipients do not need an account to read it.
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.
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.
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.
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.
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.
When preview succeeds but saving fails, distinguish illegal moves, size limits and service unavailability. Merely renaming the extension will not repair the record.
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.
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.
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.
Play a few moves or load a position with moves. Use the middle moves column on desktop or open history on mobile.
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.
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.
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.
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.
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.
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.
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.
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.
Copy a Chinese move list starting from the standard position.
Open the Blunder Checker and paste the move list; do not submit a private game to the cloud service.
Start analysis to review every score, best move, and mistake label. Use the Analysis input only when you want the final position.
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.
Upload or paste a clear board photo and inspect the detected boundary. If needed adjust the corner points manually and confirm again.
Check every piece and board orientation. Use the editor to correct missing, extra or misidentified pieces, and set the side to move.
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.
Use record upload for existing game files. If clipboard access is unavailable, use the manual-paste entry or file picker.
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.
Open Create Room, choose time control and load a starting FEN if needed. Check any position prefilled from another tool.
Adjust pieces in the editor, choose the side to move and verify the FEN matches the board. Correct inline errors before creating the room.
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.
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.
After a game choose replay or a rematch. Check that the game you want to keep has been saved before starting another.
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.
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.
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.
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.
Open Daily Puzzle, check today’s position and press Start. The page shows roughly how long remains until the next UTC puzzle.
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.
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.
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.
Retry a loading failure as directed. Season practice with ?level=N or opening AI assistance does not itself complete the daily puzzle.
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.
Open classic S1 or new S1 and start at level 1.
Find the winning Red move and advance.
Unlock later seasons in order within the selected collection.
Share the current position or a whole game with friends, documents, or social media.
Choose a position link, full record or room invite
A FEN position link, a saved complete-record link and a room invitation serve different purposes. Decide what you want the recipient to do.
Copy FEN or a position link to discuss one position. FEN with moves can restore that sequence, but does not preserve all original branches and commentary.
Import and save a complete record when sharing its main line, variations and original notes, then copy the viewer’s share link.
Use a room invitation for real-time play. Images and GIFs are convenient to view, but do not offer full-record interaction or management.
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.
For an initial download inspect progress and connectivity. At a timeout choose Continue Waiting or Retry as directed, avoiding repeated restarts.
For unsupported or embedded browsers use the external-browser option with Chrome, Edge, Firefox or Safari. Changing thread count cannot supply missing browser capabilities.
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.
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.
The contact form is below the friend-play page. You can also use [email protected] as listed on the About page.
Open friend play, scroll to the contact form, enter salutation, name, email, subject and description, and complete the on-page verification before sending.
Include the page, device, browser and reproducible steps. For engine problems attach the diagnostic ID and copied diagnostic information.
Remove sensitive material from screenshots and records. Never send passwords, one-time login links or unrelated personal information.
📖 Engine HistoryQA-LEARN-03page opens; core explanation is visible
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.