{"id":21703309,"url":"https://github.com/xmuli/chinesechess","last_synced_at":"2026-02-23T11:40:08.829Z","repository":{"id":37470456,"uuid":"166806448","full_name":"XMuli/ChineseChess","owner":"XMuli","description":"Cross-platform and online battle platform game based on Qt5 and Qt6: Chinese Chess. Also known as:『Xiangqi』『中国象棋』","archived":false,"fork":false,"pushed_at":"2026-02-04T10:30:10.000Z","size":45379,"stargazers_count":804,"open_issues_count":3,"forks_count":200,"subscribers_count":11,"default_branch":"master","last_synced_at":"2026-02-04T23:17:13.268Z","etag":null,"topics":["linux","macos","qt-chinesechess","windows","xiangqi"],"latest_commit_sha":null,"homepage":"https://www.bilibili.com/video/av45509758","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/XMuli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-01-21T11:56:59.000Z","updated_at":"2026-02-04T10:30:28.000Z","dependencies_parsed_at":"2023-01-19T12:30:47.508Z","dependency_job_id":"82df5101-97ab-4e8b-9fad-92f6ab5cda0b","html_url":"https://github.com/XMuli/ChineseChess","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/XMuli/ChineseChess","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XMuli%2FChineseChess","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XMuli%2FChineseChess/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XMuli%2FChineseChess/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XMuli%2FChineseChess/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XMuli","download_url":"https://codeload.github.com/XMuli/ChineseChess/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XMuli%2FChineseChess/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29741689,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-23T07:44:07.782Z","status":"ssl_error","status_checked_at":"2026-02-23T07:44:07.432Z","response_time":90,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","macos","qt-chinesechess","windows","xiangqi"],"created_at":"2024-11-25T21:30:40.779Z","updated_at":"2026-02-23T11:40:08.795Z","avatar_url":"https://github.com/XMuli.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ChineseChess\r\n\r\n\u003cdiv align=center\u003e\r\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/logo.svg\" height=\"240\" width=\"240\" /\u003e\r\n\u003c/div\u003e\r\n\r\n\r\n\u003cbr\u003e\r\n\r\n## Introduction\r\n\r\n\u003cp align=\"right\"\u003e\u003cbr\u003e\u003ca href=\"README.md\"\u003eEnglish\u003c/a\u003e | \u003ca href=\"README.zh_CN.md\"\u003e简体中文\u003c/a\u003e\u003c/p\u003e\r\n\r\n![](https://img.shields.io/github/license/XMuli/chineseChess) ![](https://img.shields.io/github/v/release/XMuli/ChineseChess?style=flat\u0026color=birightgreen)![](https://img.shields.io/badge/powered%20by-XMuli-ff69b4)![](https://img.shields.io/github/stars/XMuli/ChineseChess?style=social) ![](https://img.shields.io/github/forks/XMuli/ChineseChess?style=social\u0026label=Fork)\r\n\r\n[![macos-badge](https://github.com/xmuli/ChineseChess/workflows/MacOS/badge.svg)](https://github.com/xmuli/ChineseChess/workflows/MacOS/badge.svg)  [![win-badge](https://github.com/xmuli/ChineseChess/workflows/Windows/badge.svg)](https://github.com/xmuli/ChineseChess/workflows/Windows/badge.svg)  [![ubuntu-badge](https://github.com/xmuli/ChineseChess/workflows/Ubuntu/badge.svg)](https://github.com/xmuli/ChineseChess/workflows/Ubuntu/badge.svg)   ![](https://img.shields.io/github/languages/code-size/XMuli/ChineseChess)  ![](https://img.shields.io/github/downloads/XMuli/ChineseChess/total)\r\n\r\n[\u003cimg src=\"https://get.microsoft.com/images/zh-cn%20dark.svg\" width=\"260\"/\u003e](https://apps.microsoft.com/detail/9NK0TDS79DKG?mode=direct)\r\n\r\n\u003cbr\u003e\r\n\r\n\u003e - The Chinese chess online battle platform (including communication function) developed based on `Qt5.15 and Qt6.8` realizes the function of chess game in a single or networked state, no matter whether it is single or multiple players, regardless of whether the system is the same.\r\n\u003e - This project is included in: [product](https://product.xmuli.tech)\r\n\u003e - Video Effects: https://www.bilibili.com/video/av45509758\r\n\r\n\u003cbr\u003e\r\n\r\n\r\n\r\n## characteristic\r\n\r\n**The main functional modules of the project are divided into:**\r\n\r\nⅰ Players play against themselves\r\n\r\nⅱ Play against the computer AI\r\n\r\nⅲ Multiplayer network battle (can cross different systems)\r\n\r\nⅳ Battle timing\r\n\r\nⅴ Repent (multiple moves possible)\r\n\r\nⅵ track of chess moves\r\n\r\nⅵ About the work information\r\n\r\n\u003cbr\u003e\r\n\r\n# Run the demo\r\n\r\n\u003cfont color=#70AD47 size=4 face=\"幼圆\"\u003e**Video presentation:**\u003c/font\u003e \r\n[ChineseChess QT-based cross-platform online chess game demonstration](https://www.bilibili.com/video/av45509758)\r\n\r\n\u003cbr\u003e\r\n\r\n\u003cfont color=#D0087E size=4 face=\"幼圆\"\u003e**Win10 running example:**\u003c/font\u003e\r\n\r\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/20190709004321.gif\"  height=\"500\" width=\"800\"\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n\u003cfont color=#D0087E size=4 face=\"幼圆\"\u003e**Linux running example:**\u003c/font\u003e\r\n\r\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/20190709004216.gif\"  height=\"500\" width=\"800\"\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n\u003cfont color=#D0087E size=4 face=\"幼圆\"\u003e**MacOS running example:**\u003c/font\u003e\r\n\r\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/20190709004745.gif\"  height=\"500\" width=\"800\"\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n\u003cfont color=#70AD47 size=4 face=\"幼圆\"\u003e**Examples of cross-platform battles:**\u003c/font\u003e   **MacOS 10.14  vs  Win10**\r\n\r\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/20190709004454.gif\"  height=\"500\" width=\"800\"\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n\u003cfont color=#FE7207  size=4 face=\"幼圆\"\u003e**About the program:** \u003c/font\u003e \r\n\r\n \u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/about.png\" width=\"100%\"/\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n## Update (2019-2026 v7.x)\r\n\r\n### Features\r\n\r\n- Add regret function, unlimited regret\r\n- Show move track, current move\r\n- Restart game, click to restart\r\n- Code logic optimization, new comments\r\n- Update chess interface, use ancient chess characters\r\n- Update about program, add contributor name\r\n- Linux ARM Raspberry Pi support: [apt.raspbian-addons.org](https://apt.raspbian-addons.org/debian/pool/main/c/chinesechess/), both 32 and 64-bit\r\n\r\n\u003cbr\u003e\r\n\r\n### Show\r\n\r\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/ChineChess.gif\" width=\"90%\"/\u003e\r\n\r\n\u003cimg src=\"https://fastly.jsdelivr.net/gh/XMuli/xmuliPic@pic/2024/202401282117185.png\" width=\"80%\"/\u003e\r\n\r\n\u003cbr\u003e\r\n\r\n## Development tutorial\r\n\r\n- [Project actual combat: Qt5/C++: QT chess [Basic version]](https://xmuli.blog.csdn.net//article/details/80931400) \r\n\r\n- [QT5/C++ project: QT-based cross-platform online battle chess (1)](https://xmuli.blog.csdn.net//article/details/89284983)\r\n\r\n- [QT5/C++ project: QT-based cross-platform online battle chess (2)](https://xmuli.blog.csdn.net//article/details/89285968)\r\n\r\n- [QT5/C++ project: QT-based cross-platform online battle chess (3)](https://xmuli.blog.csdn.net//article/details/89286553)\r\n\r\n\u003cbr\u003e\r\n\r\nIn addition, the source code summary is accompanied by detailed code comments for easy understanding.\r\n\r\n\u003cbr\u003e\r\n\r\n## Build\r\n\r\n\u003e This project supports both Qt 5 and Qt 6 builds. \r\n\u003e\r\n\u003e For more project list: https://product.xmuli.tech\r\n\r\n\r\n\r\n- Environment: This project compiles successfully with both Qt 5.15.2 and 6.8.3 LTS versions. Tested minimum build version is Qt 5.12; lower versions are unverified.\r\n- IDE: We recommend using Qt Creator directly to open CMakeLists.txt for building.\r\n- Other: You may also convert CMake to .sln manually and build using Visual Studio 2022.\r\n\r\n\r\n\r\n### Windows Build\r\n\r\n1. Install Qt (recommended: Qt 5.15 or Qt 6.8 LTS)\r\n2. Open CMakeLists.txt directly in the Qt Creator IDE\r\n3. Click Build \u003e Compile in the bottom-left corner\r\n4. You should see it run successfully. Enjoy~\r\n\r\n\r\n\r\n### Linux / Mac Build\r\n\r\n1. Using Debian and Ubuntu as examples, install Qt (recommended: Qt 5.15 or Qt 6.8 LTS) Execute:\r\n\r\n   ```bash\r\n   $ sudo apt install cmake qtbase5-dev qt5-default libqt5svg5-dev qtmultimedia5-dev qttools5-dev libqt5x11extras5-dev\r\n   ```\r\n\r\n2. Run commands:\r\n\r\n   ```bash\r\n   $ git clone https://github.com/XMuli/ChineseChess.git\r\n   $ cd ChineseChess\r\n   $ mkdir build \u0026\u0026 cd build\r\n   $ cmake ..\r\n   $ make\r\n   ```\r\n\r\n3. Alternatively, you can skip Step 2 and directly use Qt Creator for compilation and execution, which is more convenient.\r\n\r\n\r\n\u003cbr\u003e\r\n\r\n## Contributor\r\n\r\nThanks for the contributions submitted by the friends 🥳🥳:\r\n\r\n\u003cbr\u003e\r\n\r\n\u003ctable frame=void\u003e\r\n    \u003ctr\u003e\r\n      \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/XMuli\"\u003e\r\n          \u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2020/20201101220931.png\" width=\"50px\"\u003e\u003cbr\u003e            \r\n          \u003csub\u003eXMuli\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n      \u003c/th\u003e        \r\n      \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/Bruce-Ch\"\u003e\r\n          \u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2020/20200709204616.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003eBruce-Ch\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n      \u003c/th\u003e\r\n      \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/BlueArvin\"\u003e\r\n          \u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2020/20200727212509.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003eBlueArvin\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n      \u003c/th\u003e\r\n         \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/Ubuntuser2012\"\u003e\r\n          \u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2020/20201101215738.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003eUbuntuser2012\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n      \u003c/th\u003e\r\n         \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/kira-yamatoo\"\u003e\r\n          \u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/20210911163133.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003ekirayamatoo\u003c/sub\u003e\r\n      \u003c/th\u003e\r\n         \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/hmsjy2017\"\u003e\r\n          \u003cimg src=\"https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/20211227232947.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003ehmsjy2017\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n    \u003c/tr\u003e\r\n         \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/ryanfortner\"\u003e\r\n          \u003cimg src=\"https://cdn.jsdelivr.net/gh/XMuli/xmuliPic@pic/2022/71036629.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003eryanfortner\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n       \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/zjuyk\"\u003e\r\n          \u003cimg src=\"https://fastly.jsdelivr.net/gh/XMuli/xmuliPic@pic/2024/202401282118007.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003ezjuyk\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n       \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://github.com/sum2012\"\u003e\r\n          \u003cimg src=\"https://fastly.jsdelivr.net/gh/XMuli/xmuliPic@pic/2026/202602050959732.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003esum2012\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n       \u003cth align=\"center\" style=\"width: 80px;\"\u003e\r\n        \u003ca href=\"https://openai.com/codex\"\u003e\r\n          \u003cimg src=\"https://fastly.jsdelivr.net/gh/XMuli/xmuliPic@pic/2026/202602051002745.png\" width=\"50px\"\u003e\u003cbr\u003e\r\n          \u003csub\u003eCodex\u003c/sub\u003e\r\n        \u003c/a\u003e\r\n     \u003c/tr\u003e\r\n  \u003c/thead\u003e\r\n\u003c/table\u003e\r\n\r\n\r\n\r\n\r\n\r\n\r\nIf it helps you, or find it useful, \u003cfont color=#FE7207  size=4 face=\"幼圆\"\u003eyou can click on the item's \u003cfont color=#D0087E size=4 face=\"幼圆\"\u003e**⭐Star** **🍴 Fork** \u003c/font\u003e of the two icons, conveniently lift the hand between, said a point of praise the hand,\u003c/font\u003e There is a fragrance in your hand；The next best thing is to buy me a cold Coke.\r\n\r\n\u003cbr\u003e\r\n\r\n## Author\r\n\r\n[![alt text](https://img.shields.io/badge/QQ-%E5%81%95%E8%87%A7-brightgreen)](https://sighttp.qq.com/authd?IDKEY=31f3ef7312b39e2c8dc822ae2f4c3b3118e1a6f31cc83373) [![alt text](https://img.shields.io/badge/GitHub-XMuli-brightgreen)](https://github.com/XMuli) [![alt text](https://img.shields.io/badge/Blog-%E5%81%95%E8%87%A7%E7%9A%84%E5%B0%8F%E7%AB%99-ff69b4)](https://ifmet.cn/) \r\n\r\n\u003cbr\u003e\r\n\r\n## Tutorial Series\r\n\r\n[QtExamples](https://github.com/XMuli/QtExamples) Welcome to `star` ⭐ and `fork` 🍴 This series of `C++ / QT / DTK` studies, where you can learn how to write this kind of software yourself, is a complete series of tutorials. And **FREE**!\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxmuli%2Fchinesechess","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxmuli%2Fchinesechess","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxmuli%2Fchinesechess/lists"}