# mahjong

**Repository Path**: arrearage/mahjong

## Basic Information

- **Project Name**: mahjong
- **Description**: Three-player Mahjong AI and Simulator
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2018-11-13
- **Last Updated**: 2023-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![mahjong tiles](https://dl.dropboxusercontent.com/u/101688/website/img/mahjong-tiles.jpg)

# Cock-eyed Mahjong

#### Application for simulating, analyzing, and playing [Three-Player mahjong](http://www.japanese-mahjong.com/3pmjintro.html). ####

Example
-------

For an example of the mahjong application and AI visit [http://gleitzman.com/apps/mahjong](http://gleitzman.com/apps/mahjong).

Usage
-----

Install dependencies with `npm update`.

Start the application with

    node app.js

Then visit [http://localhost:3000](http://localhost:3000).

To analyze a hand visit [http://localhost:3000/analyze/1p 123456789s BGR9](http://localhost:3000/analyze/1p%20123456789s%20BGR9).

Development
------

Install dev dependencies with `npm install` and start the application with `grunt`.


Author
------

-  Benjamin Gleitzman ([@gleitz](http://github.com/gleitz))


Notes
-----

-  Special thanks to Sebastian Heuchler for shanten calculation.