mjai-manue-go

Go port of mjai-manue

🚧 Work in Progress

mjai-manue-go is currently in active development and not usable yet.

Differences from the original:

• Supports both Gimite's original Mjai protocol and a minor modified version of the Mjai protocol used by RiichiLab.
• Fixed the miscalculation of the shanten number when the hand contains four identical tiles.
• Improved error handling to more reliably reject invalid or anomalous input.
• Refactored the code to improve readability and maintainability.
• Does not include tools to generate stats and decision trees from game records, as there is no motivation to modify the pre-generated files provided in the original project.

Note

The original project includes an older version written in Ruby and a newer version written in CoffeeScript. This project ports only the new version.

For more information, see the original README (Japanese) or its translation.

Installation

There are two options to install this application:

Option 1: Download from releases

Download the executable file for your platform from the releases page.

Option 2: Build from source

go install github.com/Apricot-S/mjai-manue-go/cmd/mjai-manue

mjai-manue will be built in current directory.

Usage

For TCP/IP (e.g., mjai)

mjai-manue --url mjsonp://example.com:11600/default

For Standard I/O (e.g., mjai.app)

mjai-manue --pipe

Note

In practice, mjai.app runs bot.py in the submission .zip file. You need to call the above command from within bot.py and pipe the standard input and output.

Tip

See scripts/mjai.app/ for how to generate a submission file for mjai.app.

License

Licensed under the New BSD License (3-Clause BSD License).

Copyright and Attribution

This project is a Go port of mjai-manue, originally created by Hiroshi Ichikawa.

The following configuration files are copied from the original project and their copyright belongs to Hiroshi Ichikawa. These files are distributed under the New BSD License:

• configs/danger_tree.all.json
• configs/game_stats.json
• configs/light_game_stats.json