Chinese Chess (Xiangqi)

🌐 English | 简体中文

---

Chinese Chess (Xiangqi) is a traditional two-player strategy game that originated in China. Similar to international chess, it has a long and rich history. Due to its simple equipment and engaging gameplay, it is widely popular throughout China and many other regions.

Xiangqi uses a square-grid board with 32 circular pieces in total—16 for each side (red and black). Pieces are placed and moved on the intersections (not inside the squares). Players take turns to move their pieces, and the player who checkmates the opponent's general (帥/将) wins the game.

This porageam uses Chinese Chess Lib

🎮 How to Play?

📜 Game Rules

Click here to learn the rules

🎲 Game Modes

The game features three basic modes, one extended mode, and one hidden (debug) mode:

• Player vs AI: Battle against the computer.
• Two-player Local: Two players share the same device to play.
• Online Mode: Play over the network with another player on a different device.
• Endgame Challenge: Load a Xiangqi file or choose from the preset endgame library via the menu to start an endgame scenario.
• Test Mode: Two AIs play against each other for testing purposes. To activate, close the "Mode Selection" window and press Ctrl + T.

Now, start your own battlefield and enjoy the fight!

🔧 How to Build?

This project is written in Python and C++.

Build C++ Lib

Prerequisites

• CMake

Steps

mkdir build && cd build
cmake ..

Build Python GUI

Prerequisites

• Python 3.10+
• tkinter
• pyinstaller

Steps

Run

pip3 install -r chinese_chess/requirements.txt
pyinstaller -F chinese_chess/main.py -n chinese_chess --icon=chinese_chess/logo.ico --uac-admin
cp chinese_chess/audio dist/audio -r
cp logo.ico dist

---

Enjoy the game, and feel free to contribute or open issues!

简体中文

🌐 English | 简体中文

---

中国象棋起源于中国，是一种类似于国际象棋的二人对抗性游戏，拥有悠久的历史。由于用具简单，趣味性强，成为流行极为广泛的棋艺活动。

中国象棋使用方形格状棋盘，圆形棋子共有32个，红黑二色各有16个棋子，摆放和活动在交叉点上。双方交替行棋，先将对方的将（帥）“将死”的一方获胜。

此程序使用了Chinese Chess Lib

🎮 如何游玩？

📜 游戏规则

请看这里

🎲 游戏模式

游戏分为三个基本模式、一种扩展模式和一种隐藏（调试）模式：

• 人机模式：玩家和电脑对局
• 双人模式：两个玩家在同一台设备上对局
• 联机模式：两个玩家在两台设备上对局
• 残局模式：导入象棋文件，或者点击菜单栏内的棋局库，即可开启“残局挑战”模式
• 测试模式：两个电脑之间的对局，用于调试。启动程序时，关闭“选择模式”窗口并按下“Ctrl+t”组合键以开启

最后，开始一场属于你的战争吧！

🔧 如何构建?

这个项目使用Python和C++编写。

构建C++库

需要

• CMake

步骤

mkdir build && cd build
cmake ..

构建Python GUI

需要

• Python 3.10+
• tkinter
• pyinstaller

步骤

运行

pip3 install -r chinese_chess/requirements.txt
pyinstaller -F chinese_chess/main.py -n chinese_chess --icon=chinese_chess/logo.ico --uac-admin
cp chinese_chess/audio dist/audio -r
cp logo.ico dist

---

祝您玩得愉快，欢迎参与贡献或提交问题反馈!