This project is a Mahjong AI for Mahjong Soul that runs directly in any browser. Everything was written from scratch in native JavaScript without any libraries. The AI does not use machine learning, but conventional algorithms. Simply said it's simulating some turns (with heuristics to save calculation time) and looking for the best move.
- 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 Mahjong Soul (make sure you are logged in already).
- Go into a game and click "Start Bot" in the GUI at the top.
- You can check "Autostart" to let the bot automatically start a new games.
- Logging is output to the browser console (Ctrl + Shift + J [Chrome] or Ctrl + Shift + K [Firefox])
- Left Button: Start or Stop the Bot.
- Checkbox: Enable Autorun mode. The bot will automatically reload the site and search for a new game 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 GUI. You can re-show it by pressing + on the Numpad.
The default parameters are usually fine. If you want to modify the behaviour of the bot (e.g. more aggressive playstyle) you can change some constants at the top of the script:
- Defense Constants: Constants that modify the defensive playstyle.
- Calls: Constants that modify how often the bot calls for tiles.
- Hand Evaluation Constants: Constants that modify how the value of hands is calculated. Influences if the bot goes for fast or expensive hands.
- Strategy Constants: See Comments
The stats contain many games by older versions of the bot and should be better in the latest version. Best rank was Expert 1* around 1000 points.
The project contains a testclass with simple "Nani Kiru?" testcases.
-Sometimes the game disconnects you for AFK. This usually happens if the window is minimized or you switch to another tab for a while (not having focus is fine, as long as the window is open). If that happens the bot will try to reconnect by reloading the page.
Bots are a violation of Mahjong Soul's Terms of Service. This means you can theoretically get banned for using this script. There have been no reports of any bans yet, but you need to be aware that this is on your own risk and the creator of the bot is not responsible for your actions.