https://github.com/xmuli/chinesechess
Cross-platform and online battle platform game based on Qt: Chinese Chess. Also known as:『Xiangqi』『中国象棋』
https://github.com/xmuli/chinesechess
linux macos qt-chinesechess windows xiangqi
Last synced: 9 months ago
JSON representation
Cross-platform and online battle platform game based on Qt: Chinese Chess. Also known as:『Xiangqi』『中国象棋』
- Host: GitHub
- URL: https://github.com/xmuli/chinesechess
- Owner: XMuli
- License: gpl-3.0
- Created: 2019-01-21T11:56:59.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-28T13:27:49.000Z (about 2 years ago)
- Last Synced: 2025-04-12T14:56:31.946Z (10 months ago)
- Topics: linux, macos, qt-chinesechess, windows, xiangqi
- Language: C++
- Homepage: https://www.bilibili.com/video/av45509758
- Size: 42.1 MB
- Stars: 745
- Watchers: 13
- Forks: 193
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ChineseChess
## Introduction
  
[](https://github.com/xmuli/ChineseChess/workflows/MacOS/badge.svg) [](https://github.com/xmuli/ChineseChess/workflows/Windows/badge.svg) [](https://github.com/xmuli/ChineseChess/workflows/Ubuntu/badge.svg)  
> The Chinese chess online battle platform (including communication function) developed based on `Qt5` 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.
## characteristic
**The main functional modules of the project are divided into:**
ⅰ Players play against themselves
ⅱ Play against the computer AI
ⅲ Multiplayer network battle (can cross different systems)
ⅳ Battle timing
ⅴ Repent (multiple moves possible)
ⅵ track of chess moves
ⅵ About the work information
# Run the demo
**Video presentation:**
[ChineseChess QT-based cross-platform online chess game demonstration](https://www.bilibili.com/video/av45509758)
**Win10 running example:**

**Linux running example:**

**MacOS running example:**

**Examples of cross-platform battles:** **MacOS 10.14 vs Win10**

**About the program:**

## Update (2022-2024 v6.x)
### Features
- Add regret function, unlimited regret
- Show move track, current move
- Restart game, click to restart
- Code logic optimization, new comments
- Update chess interface, use ancient chess characters
- Update about program, add contributor name
- Linux ARM Raspberry Pi support: [apt.raspbian-addons.org](https://apt.raspbian-addons.org/debian/pool/main/c/chinesechess/), both 32 and 64-bit
### Show


## Development tutorial
- [Project actual combat: Qt5/C++: QT chess [Basic version]](https://blog.csdn.net/qq_33154343/article/details/80931400)
- [QT5/C++ project: QT-based cross-platform online battle chess (1)](https://blog.csdn.net/qq_33154343/article/details/89284983)
- [QT5/C++ project: QT-based cross-platform online battle chess (2)](https://blog.csdn.net/qq_33154343/article/details/89285968)
- [QT5/C++ project: QT-based cross-platform online battle chess (3)](https://blog.csdn.net/qq_33154343/article/details/89286553)
In addition, the source code summary is accompanied by detailed code comments for easy understanding.
## Build
1. Install Qt (Qt >= 5.12.11)and other dependencies
For Debian and Ubuntu, run:
```bash
$ sudo apt install cmake qtbase5-dev qt5-default libqt5svg5-dev qtmultimedia5-dev qttools5-dev libqt5x11extras5-dev
```
2. Run the command::
```bash
$ git clone https://github.com/XMuli/ChineseChess.git
$ cd ChineseChess
$ mkdir build && cd build
$ cmake .. # or qmake
$ make
```
Or you can skip the second step and use Qt Creator to compile and run.
## Contributor
Thanks for the contributions submitted by the friends 🥳🥳:

XMuli

Bruce-Ch

BlueArvin

Ubuntuser2012

kirayamatoo

hmsjy2017

ryanfortner

zjuyk
If it helps you, or find it useful, you can click on the item's **⭐Star** **🍴 Fork** of the two icons, conveniently lift the hand between, said a point of praise the hand, There is a fragrance in your hand;The next best thing is to buy me a cold Coke.
## Author
[](https://sighttp.qq.com/authd?IDKEY=31f3ef7312b39e2c8dc822ae2f4c3b3118e1a6f31cc83373) [](https://github.com/XMuli) [](https://ifmet.cn/)
## Tutorial Series
[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**!