AlphaJong 项目使用教程

AlphaJong 项目使用教程

AlphaJong A Mahjong AI for Mahjong Soul 项目地址: https://gitcode.com/gh_mirrors/al/AlphaJong

1. 项目目录结构及介绍

AlphaJong 项目是一个 Mahjong AI，用于 Mahjong Soul 游戏。以下是项目的目录结构及其简单介绍：

AlphaJong/
├── .github/              # GitHub 工作流和配置文件
│   └── workflows/
├── doc/                  # 项目文档
├── src/                  # 源代码目录
├── test/                 # 测试代码
├── .gitignore            # Git 忽略文件
├── LICENSE               # 项目许可证文件
├── build.py              # 构建脚本
├── readme.md             # 项目自述文件
├── readme_cn.md          # 中文自述文件
└── readme_jp.md          # 日文自述文件

• .github/workflows/：包含项目的 GitHub Actions 工作流文件，用于自动化处理如代码提交等事件。
• doc/：存放项目文档的目录。
• src/：源代码目录，包含了项目的主要逻辑。
• test/：测试代码目录，用于项目的单元测试和功能测试。
• .gitignore：指定 Git 忽略的文件和目录。
• LICENSE：项目的许可证书文件，本项目采用 GPL-3.0 许可。
• build.py：构建脚本，用于构建项目。
• readme.md 及其他语言版本的自述文件：提供了关于项目的详细信息和说明。

2. 项目的启动文件介绍

项目的启动主要是通过浏览器扩展（如 Tampermonkey）来实现的。具体步骤如下：

• 安装一个支持运行用户脚本的浏览器扩展，例如 Tampermonkey。
• 获取项目的最新发布版本，并在浏览器扩展中安装。
• 打开 Mahjong Soul 游戏并确保已登录。
• 在游戏界面点击 "Start Bot" 以启动机器人。
• 可以勾选 "Autostart" 选项，让机器人在新游戏开始时自动启动。
• 详细的日志信息可以在浏览器的控制台中查看。

3. 项目的配置文件介绍

项目的配置主要是通过修改源代码中的某些常量来实现的。以下是一些主要的配置选项：

• Performance Mode：决定机器人玩牌的速度和准确性，0 是最快但准确度较低，4 是最慢但准确度较高。
• Defense Constants：调整机器人防守策略的常量。
• Calls：调整机器人叫牌频率的常量。
• Hand Evaluation Constants：调整机器人手牌价值计算的常量，影响机器人是追求快速还是昂贵的牌型。
• Strategy Constants：具体的策略常量，具体影响机器人的打牌策略。

请注意，修改这些常量可能会改变机器人的打牌风格和性能。在修改后，需要重新部署到浏览器扩展中才能生效。

AlphaJong A Mahjong AI for Mahjong Soul 项目地址: https://gitcode.com/gh_mirrors/al/AlphaJong