Riichi Advanced

Category: Home games · Open-source browser mahjong client; 30 rulesets incl. American (NMJL), Riichi, Hong Kong, MCR, Vietnamese; private rooms + AI
Also called: Riichi Advanced mahjong web client; riichiadvanced.com; EpicOrange/riichi_advanced
Last checked: 2026-10-08

What it is

Riichi Advanced is an open-source, four-player browser mahjong client that its developers call “infinitely extensible.” Despite the name, it is not Riichi-only. On the check date its ruleset menu listed 30 named rulesets plus a Custom option, including American (NMJL), Riichi and Sanma, Hong Kong Old Style, Sichuan Bloody, MCR, Taiwanese, Vietnamese, Malaysian, Singaporean, Zung Jung and several regional Chinese styles. Groups can open a private room and invite friends, or fill seats with AI players. Each ruleset has optional “mods,” and a scripting language (MahjongScript) lets groups write their own house rules. It is social table software, not mahjong solitaire.

Who it’s for

Home groups that play more than one style, or want to try one they’ve never played, in the same online room. That includes American players who want to practice with the NMJL card or alternative cards, Southeast Asian players (Vietnamese, Malaysian, Singaporean), Riichi players who like house variants, and groups with unusual house rules that they can script. Existing home-game clients on disk are single-family or a few rulesets (Mahjong Soul, Tenhou, Riichi City, BGA Riichi, RiichiMahjong.com, Mahjong Place, Mahjong Spot, Table Mahjong, Mahjong.Live, OpenMahj, 4 Winds, NMJL Online, etc.). None is open source, and none offers user-written rulesets.

Why it’s listed

The plaza needs a new home-game client that differs in kind from recent picks: Wednesday’s BGA Riichi (turn-based tables on a multi-game platform), Tuesday’s Mahjong.Live (Indian Heritage), Monday’s Mahjong Place (Taiwan/HK/MCR/Sichuan) and Friday’s RiichiMahjong.com. Riichi Advanced is the plaza’s first open-source client, with the widest ruleset menu on disk and an American (NMJL) mode that supports several alternative cards.

• Official game site (https://riichiadvanced.com/) loaded on 2026-10-08 under “Riichi Advanced” (see the HTTP note below).
  • Share description: “Infinitely extensible mahjong web client — play Riichi, Hong Kong Old Style, Taiwanese, Sichuan Bloody, Space Mahjong, MCR, and more.”
  • Ruleset menu: Riichi, Sanma, Space Mahjong, Cosmic Riichi, Galaxy Mahjong, Kansai Sanma, Zan Sanma, Chinitsu, Minefield, Speed Tonpuu, Super Bingo (beta), Sakicards v1.3, Arushiiaru, Hochi Rules, Tokyo Rules (beta), Hong Kong, Sichuan Bloody, MCR, Taiwanese, Bloody 30-Faan Jokers, American (NMJL), Vietnamese, Malaysian, Singaporean, Chinese Classical, Fuzhou, Tianjin, Ningbo, Hefei, Zung Jung, and Custom.
  • “To be implemented”: Filipino, Visayan, Changsha, Shenyang, Korean, British, Italian, Dutch, German, French, Australian.
  • Buttons: Play, Learn, Join private room, plus Scorer and Logs. Version shown: v1.5.2. Languages: English, Japanese, Simplified Chinese, Traditional Chinese.
• GitHub repository (https://github.com/EpicOrange/riichi_advanced) returned 200, and the README (https://raw.githubusercontent.com/EpicOrange/riichi_advanced/main/README.md) returned 200:
  • “Multiplayer lobby system with public/private rooms! Invite your friends, or play against AI!”
  • “A variety of mods for each ruleset,” and a customizable ruleset via MahjongScript. To play a custom ruleset, select Custom, open Room Settings, and paste or edit your ruleset.
  • The README’s headline count is “28+ base rulesets.” The live menu showed 30 named rulesets on the check date.
• License (https://github.com/EpicOrange/riichi_advanced/blob/main/LICENSE) returned 200: GNU Affero General Public License v3.0.
• American rules doc (https://raw.githubusercontent.com/EpicOrange/riichi_advanced/main/documentation/american.md) returned 200:
  • Supported Cards: NMJL 2013–2026, Mahjong Press 2026, The Big Card 2026, OMM 2026 International Mahjong Card, AMJS 2026 Card, ShariUniqueCreations Vegas Card, ILoveMahj Card, ATeacherFirst Mah Jongg Fake Card, MahjLife Mock Card, American Mah Jongg for Everyone Card, and John Burton’s Card Free American Mah Jongg. The doc lists each card’s purchase price or “free.”
  • Engine behavior: it won’t allow an incorrect exposure or Mah Jongg in error, and it requires you to name each exposure (Pung/Kong/Quint). Dead-hand calls can be made only on your turn and are judged immediately. Charleston blind passes are evaluated starting with East. Seven auto-buttons handle automatic actions.
• Changelog (https://raw.githubusercontent.com/EpicOrange/riichi_advanced/main/CHANGELOG.md) returned 200:
  • v1.0.0 on 1 Feb 2025 (“17 rulesets, hundreds of mods, multiplayer”).
  • v1.5.0 (19 Aug 2026), v1.5.1 (23 Aug 2026) and v1.5.2 (2 Sep 2026). v1.5.2 added 1952 Hochi rules and a partial 1957 Tokyo ruleset, and fixed several Vietnamese-mahjong and AI issues.

HTTP note: riichiadvanced.com sends an incomplete TLS certificate chain (Let’s Encrypt leaf only). Box curl therefore failed certificate verification (HTTP 000) with or without a browser user agent. With certificate checks skipped it returned 200, and a standard web fetch also loaded the page. Browsers normally complete the chain on their own. Not stated on the pages checked: price, ads, account requirements, and the operator’s legal name (development is credited to the GitHub repository and a community Discord). The README warns that bugs are likely. Agree on ruleset, card and mods with your group before starting.

Official URL

Play (official game site): https://riichiadvanced.com/

Source code and README: https://github.com/EpicOrange/riichi_advanced

American (NMJL) rules and supported cards: https://raw.githubusercontent.com/EpicOrange/riichi_advanced/main/documentation/american.md

Changelog: https://raw.githubusercontent.com/EpicOrange/riichi_advanced/main/CHANGELOG.md

Location

Online (browser). No physical venue and no download required.

Notes

• Four-player table mahjong in many rulesets, not solitaire. Don’t confuse it with Side games portals.
• Open source (AGPL-3.0), with a fast release pace (v1.5.0–v1.5.2 within two weeks in Aug–Sep 2026). Features and rules can change between versions.
• The name says “Riichi,” but the American (NMJL), Hong Kong, MCR, Vietnamese, Malaysian and Singaporean modes make it relevant well beyond Riichi players.
• Not affiliated with Mahjong Plaza.

FAQ

Q: Can I play American Mah Jongg on Riichi Advanced?
A: Yes. “American (NMJL)” is one of its rulesets. The rules doc lists supported cards including NMJL 2013–2026 and several alternative and free cards (e.g., ILoveMahj, MahjLife Mock Card, American Mah Jongg for Everyone).

Q: Can I play with just my friends?
A: Yes. The site has a Join private room button, and the README describes public and private rooms where you can invite friends or play against AI.

Q: Which rulesets does it support?
A: On 2026-10-08 the menu listed 30 named rulesets plus Custom, including Riichi, Sanma, Hong Kong, Sichuan Bloody, MCR, Taiwanese, American (NMJL), Vietnamese, Malaysian, Singaporean and Zung Jung. Filipino, Korean, British and others were marked “to be implemented.”

Q: Is it open source?
A: Yes. The code is on GitHub under the GNU Affero General Public License v3.0, and the project accepts bug reports and pull requests.