## nonebot-plugin-cchess
适用于 [Nonebot2](https://github.com/nonebot/nonebot2) 的象棋插件。
### 安装
- 使用 nb-cli
```
nb plugin install nonebot_plugin_cchess
```
- 使用 pip
```
pip install nonebot_plugin_cchess
```
人机功能 需要使用遵循 [UCCI协议](https://www.xqbase.com/protocol/cchess_ucci.htm) 的引擎
需要在 `.env` 文件中添加 引擎的可执行文件的路径
```
cchess_engine_path=/path/to/your/engine
```
经试用可用的引擎：
- [Fairy-Stockfish](https://github.com/ianfab/Fairy-Stockfish/releases)
注意，Fairy-Stockfish 支持多种游戏，需要选择支持 `Xiangqi` 的发行版，即需要选带有 `largeboard` 的版本
### 使用
**以下命令需要加[命令前缀](https://nonebot.dev/docs/appendices/config#command-start-和-command-separator) (默认为`/`)，可自行设置为空**
@我 + “象棋人机”或“象棋对战”开始一局游戏；
可使用“lv1~8”指定AI等级，如“象棋人机lv5”，默认为“lv4”；
发送 中文纵线格式如“炮二平五” 或 起始坐标格式如“h2e2”下棋；
发送“结束下棋”结束当前棋局；
发送“显示棋盘”显示当前棋局；
发送“悔棋”可进行悔棋（人机模式可无限悔棋；对战模式只能撤销自己上一手下的棋）；
或者使用 `cchess` 指令：
可用选项：
- `-e`, `--stop`, `--end`: 停止下棋
- `-v`, `--show`, `--view`: 显示棋盘
- `--repent`: 悔棋
- `--reload`: 重新加载已停止的游戏
- `--battle`: 对战模式，默认为人机模式
- `--black`: 执黑，即后手
- `-l <LEVEL>`, `--level <LEVEL>`: 人机等级，可选 1~8，默认为 4
### 示例
<div align="left">
<img src="https://s2.loli.net/2022/04/30/RztCnIkFQqWKsUe.jpg" width="500" />
</div>
### 特别感谢
- [niklasf/python-chess](https://github.com/niklasf/python-chess) A chess library for Python
- [StevenBaby/chess](https://github.com/StevenBaby/chess) 基于 Pyside2 和 UCCI 引擎的中国象棋程序
- [walker8088/cchess](https://github.com/walker8088/cchess) cchess是一个Python版的中国象棋库
- [ianfab/Fairy-Stockfish](https://github.com/ianfab/Fairy-Stockfish) chess variant engine supporting Xiangqi and many more
Raw data
{
"_id": null,
"home_page": "https://github.com/noneplugin/nonebot-plugin-cchess",
"name": "nonebot_plugin_cchess",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "meetwq",
"author_email": "meetwq@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/6a/9a/3f52c1fc511f4385e514b434acbb668338470e88c4a6183e86d9c1af33f0/nonebot_plugin_cchess-0.4.0.tar.gz",
"platform": null,
"description": "## nonebot-plugin-cchess\n\n\u9002\u7528\u4e8e [Nonebot2](https://github.com/nonebot/nonebot2) \u7684\u8c61\u68cb\u63d2\u4ef6\u3002\n\n\n### \u5b89\u88c5\n\n- \u4f7f\u7528 nb-cli\n\n```\nnb plugin install nonebot_plugin_cchess\n```\n\n- \u4f7f\u7528 pip\n\n```\npip install nonebot_plugin_cchess\n```\n\n\n\u4eba\u673a\u529f\u80fd \u9700\u8981\u4f7f\u7528\u9075\u5faa [UCCI\u534f\u8bae](https://www.xqbase.com/protocol/cchess_ucci.htm) \u7684\u5f15\u64ce\n\n\u9700\u8981\u5728 `.env` \u6587\u4ef6\u4e2d\u6dfb\u52a0 \u5f15\u64ce\u7684\u53ef\u6267\u884c\u6587\u4ef6\u7684\u8def\u5f84\n\n```\ncchess_engine_path=/path/to/your/engine\n```\n\n\u7ecf\u8bd5\u7528\u53ef\u7528\u7684\u5f15\u64ce\uff1a\n\n - [Fairy-Stockfish](https://github.com/ianfab/Fairy-Stockfish/releases)\n\n\u6ce8\u610f\uff0cFairy-Stockfish \u652f\u6301\u591a\u79cd\u6e38\u620f\uff0c\u9700\u8981\u9009\u62e9\u652f\u6301 `Xiangqi` \u7684\u53d1\u884c\u7248\uff0c\u5373\u9700\u8981\u9009\u5e26\u6709 `largeboard` \u7684\u7248\u672c\n\n\n### \u4f7f\u7528\n\n**\u4ee5\u4e0b\u547d\u4ee4\u9700\u8981\u52a0[\u547d\u4ee4\u524d\u7f00](https://nonebot.dev/docs/appendices/config#command-start-\u548c-command-separator) (\u9ed8\u8ba4\u4e3a`/`)\uff0c\u53ef\u81ea\u884c\u8bbe\u7f6e\u4e3a\u7a7a**\n\n@\u6211 + \u201c\u8c61\u68cb\u4eba\u673a\u201d\u6216\u201c\u8c61\u68cb\u5bf9\u6218\u201d\u5f00\u59cb\u4e00\u5c40\u6e38\u620f\uff1b\n\n\u53ef\u4f7f\u7528\u201clv1~8\u201d\u6307\u5b9aAI\u7b49\u7ea7\uff0c\u5982\u201c\u8c61\u68cb\u4eba\u673alv5\u201d\uff0c\u9ed8\u8ba4\u4e3a\u201clv4\u201d\uff1b\n\n\u53d1\u9001 \u4e2d\u6587\u7eb5\u7ebf\u683c\u5f0f\u5982\u201c\u70ae\u4e8c\u5e73\u4e94\u201d \u6216 \u8d77\u59cb\u5750\u6807\u683c\u5f0f\u5982\u201ch2e2\u201d\u4e0b\u68cb\uff1b\n\n\u53d1\u9001\u201c\u7ed3\u675f\u4e0b\u68cb\u201d\u7ed3\u675f\u5f53\u524d\u68cb\u5c40\uff1b\n\n\u53d1\u9001\u201c\u663e\u793a\u68cb\u76d8\u201d\u663e\u793a\u5f53\u524d\u68cb\u5c40\uff1b\n\n\u53d1\u9001\u201c\u6094\u68cb\u201d\u53ef\u8fdb\u884c\u6094\u68cb\uff08\u4eba\u673a\u6a21\u5f0f\u53ef\u65e0\u9650\u6094\u68cb\uff1b\u5bf9\u6218\u6a21\u5f0f\u53ea\u80fd\u64a4\u9500\u81ea\u5df1\u4e0a\u4e00\u624b\u4e0b\u7684\u68cb\uff09\uff1b\n\n\n\u6216\u8005\u4f7f\u7528 `cchess` \u6307\u4ee4\uff1a\n\n\u53ef\u7528\u9009\u9879\uff1a\n\n - `-e`, `--stop`, `--end`: \u505c\u6b62\u4e0b\u68cb\n - `-v`, `--show`, `--view`: \u663e\u793a\u68cb\u76d8\n - `--repent`: \u6094\u68cb\n - `--reload`: \u91cd\u65b0\u52a0\u8f7d\u5df2\u505c\u6b62\u7684\u6e38\u620f\n - `--battle`: \u5bf9\u6218\u6a21\u5f0f\uff0c\u9ed8\u8ba4\u4e3a\u4eba\u673a\u6a21\u5f0f\n - `--black`: \u6267\u9ed1\uff0c\u5373\u540e\u624b\n - `-l <LEVEL>`, `--level <LEVEL>`: \u4eba\u673a\u7b49\u7ea7\uff0c\u53ef\u9009 1~8\uff0c\u9ed8\u8ba4\u4e3a 4\n\n\n### \u793a\u4f8b\n\n<div align=\"left\">\n <img src=\"https://s2.loli.net/2022/04/30/RztCnIkFQqWKsUe.jpg\" width=\"500\" />\n</div>\n\n\n### \u7279\u522b\u611f\u8c22\n\n- [niklasf/python-chess](https://github.com/niklasf/python-chess) A chess library for Python\n- [StevenBaby/chess](https://github.com/StevenBaby/chess) \u57fa\u4e8e Pyside2 \u548c UCCI \u5f15\u64ce\u7684\u4e2d\u56fd\u8c61\u68cb\u7a0b\u5e8f\n- [walker8088/cchess](https://github.com/walker8088/cchess) cchess\u662f\u4e00\u4e2aPython\u7248\u7684\u4e2d\u56fd\u8c61\u68cb\u5e93\n- [ianfab/Fairy-Stockfish](https://github.com/ianfab/Fairy-Stockfish) chess variant engine supporting Xiangqi and many more\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Nonebot2 \u8c61\u68cb\u63d2\u4ef6",
"version": "0.4.0",
"project_urls": {
"Homepage": "https://github.com/noneplugin/nonebot-plugin-cchess",
"Repository": "https://github.com/noneplugin/nonebot-plugin-cchess"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e6f7ef9e4a038b8d7a17b90762826ef607c0c9bfa99ecc39b6596d3f30b1420a",
"md5": "40666043a68390649217b1ac07d744a0",
"sha256": "f81676be1c6496d8b07d3e13d20802b70f12ac72d857162fd6a922014685e1a3"
},
"downloads": -1,
"filename": "nonebot_plugin_cchess-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "40666043a68390649217b1ac07d744a0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 1409087,
"upload_time": "2024-03-01T15:20:58",
"upload_time_iso_8601": "2024-03-01T15:20:58.978317Z",
"url": "https://files.pythonhosted.org/packages/e6/f7/ef9e4a038b8d7a17b90762826ef607c0c9bfa99ecc39b6596d3f30b1420a/nonebot_plugin_cchess-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6a9a3f52c1fc511f4385e514b434acbb668338470e88c4a6183e86d9c1af33f0",
"md5": "8f0fbe7badad4df826c42554981cc03f",
"sha256": "9803e55d0b92c59cedea2ee76e7377d85af904c4017138c2cbb8d7d3bdf2d905"
},
"downloads": -1,
"filename": "nonebot_plugin_cchess-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "8f0fbe7badad4df826c42554981cc03f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 1405348,
"upload_time": "2024-03-01T15:21:02",
"upload_time_iso_8601": "2024-03-01T15:21:02.201231Z",
"url": "https://files.pythonhosted.org/packages/6a/9a/3f52c1fc511f4385e514b434acbb668338470e88c4a6183e86d9c1af33f0/nonebot_plugin_cchess-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-01 15:21:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "noneplugin",
"github_project": "nonebot-plugin-cchess",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nonebot_plugin_cchess"
}
JSON
