麻将 Copilot / Mahjong Copilot

麻将 AI 助手，基于 mjai (Mortal模型) 实现的机器人。会对游戏对局的每一步进行指导。现支持雀魂三人、四人麻将。 QQ群：834105526

Mahjong AI Assistant for Majsoul, based on mjai (Mortal model) bot impelementaion. When you are in a Majsoul game, AI will give you step-by-step guidance. Now supports Majsoul 3-person and 4-person game modes.

下载、帮助和更多信息请访问网站 Please see website for download, help, and more information
帮助信息 Help Info | https://mjcopilot.com

特性：

对局每一步 AI 指导，可在游戏中覆盖显示
自动打牌，自动加入游戏
多语言支持
支持本地 Mortal 模型和在线模型，支持三麻和四麻

Features:

Step-by-step AI guidance for the game, with optional in-game overlay.
Auto play & auto joining next game
Multi-language support
Supports Mortal local models and online models, 3p and 4p mahjong modes.

使用方法 / Instructions

开发

克隆 repo
安装 Python 虚拟环境。Python 版本推荐 3.11.
安装 requirements.txt 中的依赖。
安装 Playwright + Chromium
主程序入口: main.py

To Develope

Clone the repo
Install Python virtual environment. Python version 3.11 recommended.
Install dependencies from requirements.txt
Install Playwright + Chromium
Main entry: main.py

示例脚本 Sample script：

git clone https://github.com/latorc/MahjongCopilot.git
cd MahjongCopilot
python -m venv venv
CALL venv\Scripts\activate.bat
pip install -r requirements.txt
set PLAYWRIGHT_BROWSERS_PATH=0
playwright install chromium
python main.py

配置模型

本程序支持几种模型来源。其中，本地模型（Local）是基于 Akagi 兼容的 Mortal 模型。要获取 Akagi 的模型，请参见 Akagi Github 的说明。

Model Configuration

This program supports different types of AI models. The 'Local' Model type uses Mortal models compatible with Akagi. To acquire Akagi's models, please refer to Akagi Github .

截图 / Screenshots

界面 / GUI

游戏中覆盖显示 (HUD）/ In-game Overlay (HUD)

设计 / Design

目录说明 Description for folders：

gui: tkinter GUI 相关类 / tkinter GUI related classes
game: 雀魂游戏相关类 / classes related to Majsoul game
bot: AI 模型和机器人实现 / implementations for AI models and bots
common: 共同使用的支持代码 commonly used supporting code
libriichi & libriichi3p: 编译完成的 libriichi 库文件 / For compiled libriichi libraries

鸣谢 / Credit

基于 Mortal 模型和 MJAI 协议 Based on Mortal Model an MJAI protocol

Mortal: https://github.com/Equim-chan/Mortal
设计和功能实现基于 Akagi Design and implementation based on Akagi

Akagi: https://github.com/shinkuan/Akagi
参考 Reference Mahjong Soul API: https://github.com/MahjongRepository/mahjong_soul_api
MJAI协议参考 / MJAI Protocol Reference

MJAI: https://mjai.app

许可 / License

本项目使用 GNU GPL v3 许可协议。
协议全文请见 LICENSE

Xerxes-2/MahjongCopilot