README.md · yanjunyi8/ChineseChess

# ChineseChess

## Introduction

<a href="README.md">English</a> | <a href="README.zh_CN.md">简体中文</a>

![](https://img.shields.io/github/license/XMuli/chineseChess) ![](https://img.shields.io/github/v/release/XMuli/ChineseChess?style=flat&color=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&label=Fork)

![](https://img.shields.io/github/workflow/status/XMuli/ChineseChess/Windows?style=flat&logo=windows) ![](https://img.shields.io/github/workflow/status/XMuli/ChineseChess/MacOS?style=flat&logo=apple) ![](https://img.shields.io/github/workflow/status/XMuli/ChineseChess/Linux?style=flat&logo=linux) ![](https://img.shields.io/github/languages/code-size/XMuli/ChineseChess) ![](https://img.shields.io/github/downloads/XMuli/ChineseChess/total)

> 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.

# linglong-玲珑适配

### update: 2023.11.02

本次适配都是在 Deepin V23.02  环境下适配成功；

```cpp
// 编译项目的环境
sudo apt install gcc g++ cmake git tree qtcreator qtbase5-dev qttools5-dev-tools qttools5-dev libqt5x11extras5-dev libqt5svg5-dev libqt5xml5 
// 适配玲珑包的环境
sudo apt install linglong-builder
    
// 进入源码的根目录下的 tech.xmuli.flipped 文件夹，执行如下适配命令
ll-builder build
    
// Note:，第一次执行安装会很慢，发现和网络有关，linglong 自生会下载很多东西；稍等即可编译成功。但实测发现项目使用 git submodule 引入三方开源库，而 玲珑脚本自生没有处理这这一部分，会导致编译失败。若此原因和项目自生无关。

```

#### Note:

- 整个项目的编译和玲珑适包配是在 Deepin V23.2 中实现，成功编译和运行；若是单独编译，在Windows、MacOS、Linux 下都是成功编译、运行、打包的，成品下载和体验可。
  - GitHub : [https://github.com/XMuli/ChineseChess](https://github.com/XMuli/ChineseChess)    | [gitee 镜像](https://gitee.com/XMuli/ChineseChess)

REF：

- [https://linglong.dev/guide/ll-builder/build.html](https://linglong.dev/guide/ll-builder/build.html)
- [https://atomgit.com/linglong](https://atomgit.com/linglong)

## 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 v6.0+)

### 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 🥳🥳:

<table frame=void>
 <tr>
 <th align="center" style="width: 80px;">
 <a href="https://github.com/XMuli">
 <img src="https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2020/20201101220931.png" width="50px"> 
 XMuli
 </a>
 </th> 
 <th align="center" style="width: 80px;">
 <a href="https://github.com/Bruce-Ch">
 <img src="https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2020/20200709204616.png" width="50px"> 
 Bruce-Ch
 </a>
 </th>
 <th align="center" style="width: 80px;">
 <a href="https://github.com/BlueArvin">
 <img src="https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2020/20200727212509.png" width="50px"> 
 BlueArvin
 </a>
 </th>
 <th align="center" style="width: 80px;">
 <a href="https://github.com/Ubuntuser2012">
 <img src="https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2020/20201101215738.png" width="50px"> 
 Ubuntuser2012
 </a>
 </th>
 <th align="center" style="width: 80px;">
 <a href="https://github.com/kira-yamatoo">
 <img src="https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/20210911163133.png" width="50px"> 
 kirayamatoo
 </th>
 <th align="center" style="width: 80px;">
 <a href="https://github.com/hmsjy2017">
 <img src="https://cdn.jsdelivr.net/gh/xmuli/xmuliPic@pic/2021/20211227232947.png" width="50px"> 
 hmsjy2017
 </a>
 </tr>
 <th align="center" style="width: 80px;">
 <a href="https://github.com/ryanfortner">
 <img src="https://cdn.jsdelivr.net/gh/XMuli/xmuliPic@pic/2022/71036629.png" width="50px"> 
 ryanfortner
 </a>
 </tr>
 </thead>
</table>

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

[![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/)

## License

This project is distributed and used based on the `GNU General Public License v3.0` protocol. For more information, please refer to [Agreement File](/LICENSE).

yanjunyi8/ChineseChess

简介

发行版

贡献者

近期动态

yanjunyi8/ChineseChess .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

yanjunyi8/ChineseChess