阿尔法麻将 - 雀魂麻将 AI

项目说明

About The Project

This project is a 麻将 AI for 麻将 Soul that runs directly in any browser. E was written from scratch in nati without any libraries.
The AI does not use machine learning, but con algorithms. Simply said it's simulating some turns and looking for the best move.
Compatible with both 3 and 4 player mode.
日本語のリードミーはこちら.
中文自述在这里.

Getting Started

* Install a browser extension that lets you run userscripts, like Tampermonkey.
* Grab the latest release of this project and install it in your browser extension. (For Tampermonkey you can enter the download url at utilities -> Install from URL).
* Open 麻将 Soul (make sure you are logged in already).
* Go into a 游戏 and click "Start Bot" in the 界面 at the top.
* You can check "Autostart" to let the bot automatically start new games.
* Detailed logging is output to the browser console ([F12] in most browsers)

How to avoid bans

There is a high risk of getting banned when using this script without further preparation. Fortunately the MajSoul Mod Plus project on GitHub is offering a way to avoid bans. They provide a "safe 代码" file which is the same as the official 代码 of the 游戏 but the cheat detection is disabled. Here is how you can use it:
1. Install the Header Editor plugin.
2. Open the plugin and go to the Export and Import tab.
3. Fill in as Download Rule and press the Download button on the right.
4. Pick Suggested Group and click save.
5. Make sure that Tampermonkey is turned off and open the Mahjong Soul game webpage.
6. Clear your browser cache (see image below). Press F12 to open the browser console and go to the Application tab. Choose Storage and tick the box Cache storage. Then click the button Clear site data.
7. Refresh (F5) the webpage and check the browser console output. At the top it should display "代码.JS替换成功！", which means the 代码 was successfully replaced.
8. You can now turn on Tampermonkey and use this bot without getting banned.

!clear_cache

Note: When the 游戏 updates to a new and the safe 代码 doesn't work anymore, first try cleaning the cache again (as seen in the image above). If that doesn't work the safe 代码 needs to be updated:
1. Check if the safe_代码.js file on MajSoul Mod Plus has been updated for the new yet.
2. If it has been updated click this link: jsdeli to refresh the 代码. If you see "status": "finished" it was successfull.
3. Open 麻将 Soul, clear your browser cache and refresh the page.

If you ha with the abo please try opening an issue on MajSoul Mod Plus.

GUI

!GUI
There is a very simple 界面 to control the Bot.
* Left Button: Start or Stop the Bot.
* ComboBox: AI mode, there are two AI modes.
* AUTO: which automatically helps the player to operate
* HELP: only gi and does not operate
* Checkbox: Enable Autorun mode. The bot will automatically reload the site and search for a new 游戏 after the previous one is finished. The Room can be chosen in the ComboBox next to it.
* Output Field: Simple Logging what the bot is currently doing or waiting for.
* Right Button: Hide the 界面. You can re-show it by pressing + on the Numpad.

Parameters

The default parameters are usually fine. If you want to modify the behaviour of the bot (e.g. more aggressi) you can change some constants at the top of the script:

* Performance Mode: Decides how accurate and fast the bot will play. 0 is the fastest mode with low accuracy, 4 is the slowest mode with high accuracy.
* Defense Constants: Constants that modify the defensi.
* Calls: Constants that modify how often the bot calls for tiles.
* Hand E Constants: Constants that modify how the value of hands is calculated. Influences if the bot goes for fast or expensi.
* Strategy Constants: See Comments

Statistics

!Stats

The bot is able to reach Master rank.

!Yakuman

Tests

The project contains a testclass with simple "Nani Kiru?" testcases.

Known Problems

While the 游戏 does not need focus (=you can use other programs while the bot is running), it's not possible to have it in the background. That means if the browser is minimized or you switch to another tab for a while you will get disconnected for AFK. Most modern browsers also check if the window is hidden behind other windows and will drastically reduce the performance then. This behavior can be turned off in the settings, if needed you can set chrome://flags/#calculate-nati to disabled (Chrome) or go to about:config in Firefox and set widget.windows.window_occlusion_tracking.enabled to false.

- When there is a disconnection the bot will try to solve it by reloading the page.

If the bot is not able to play fast enough try lowering the Performance Mode (see parameters) or use a different browser (Firefox seems to be fastest).

Disclaimer

Bots are a of 麻将 Soul's Terms of Service. Using this bot is on your own risk and the creator is not responsible for your actions.

技术栈

开发语言：JavaScript

项目类型：雀魂麻将 AI

Star 数：448

功能特点

这是一套雀魂麻将 AI，代码结构清晰，适合开发者学习游戏的客户端渲染、服务端逻辑、场景管理与资源加载。项目涵盖了游戏的核心玩法、界面交互、地图与角色系统等模块，对理解游戏开发的完整流程具有较高的参考价值。

从技术实现角度看，游戏项目的难点在于：游戏循环与状态管理、资源加载与渲染优化、客户端与服务端的协议同步、以及多平台适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / Go / C# / Unity / Godot 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入游戏开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到游戏的核心玩法实现、场景与资源管理、网络协议设计、以及渲染优化等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了游戏项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整游戏项目的架构，对后续开发其他类型游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。