🀄

Mahjong

A tile-matching game of skill, strategy, and fortune. The 136-tile Mahjong set supports 5 regional variants: Hong Kong, Riichi, Taiwanese, Zung Jung, and American Classic. All involve drawing and discarding tiles to complete winning hands of melds and a pair.

5 Variants
mahjong Plugin
✓ Frontmatter-only

Declared, Not Coded

Every rule of Mahjong below is frontmatter in the rules corpus. The board beside each is the game itself, live.

American Mahjong (Classic) Rules

American mahjong as Babcock's Red Book of Rules (1923) taught it, the book packed with the sets that started the American craze. 136 tiles, every hand scored, the losers settling among themselves, and East paying and receiving double.

engine:
  topology:
    type: tableau
    layout: wall
  players: [east, south, west, north]
  plugins:
    mahjong:
      game: wall
      scoring: red-book
      minimum: 0
      rounds: 1
      startingPoints: 2000
      deadWall: 14
      limit: 300
      kongAfterClaim: false
      options:
        rounds:
          label: Rounds
          values: [1, 2, 4]

American Mahjong (Classic)

Hong Kong Mahjong Rules

The canonical Cantonese ruleset. 144 tiles with 8 bonus tiles. Faan scoring with minimum 3 faan to win. Discarder pays on ron; wall win doubles from all.

engine:
  topology:
    type: tableau
    layout: wall
  players: [east, south, west, north]
  plugins:
    mahjong:
      game: wall
      scoring: hong-kong
      minimum: 3
      rounds: 1
      options:
        rounds:
          label: Wind rounds
          values: [1, 2, 4]

Hong Kong Mahjong

Play All 5 Variants

Every Mahjong variant is playable against the AI or another player.

Play Mahjong Browse Boards SDK Docs