MChjong

MChjong brings mahjong into Minecraft as a physical, seated table game.

Build a table, prepare a tile set, sit down with other players or bots, and play directly in the Minecraft world. Rather than reducing mahjong to a separate menu, MChjong keeps the table, tiles, walls, hands, discards, melds, point sticks, and player positions as part of the experience.

The current ruleset focuses on Japanese riichi mahjong, with both three- and four-player games and extensive rule customization. The rest of the mod—from its physical equipment and table interactions to multiplayer rooms and replay systems—is designed around the broader game of mahjong rather than a single ruleset.

Ordinary tables emphasize manual handling: shuffle the tiles, build the walls, take starting packets, draw from the wall, discard, and settle payments using physical point sticks. Automatic tables handle those procedures for you while preserving the same table-centered gameplay.

Highlights

• Complete mahjong table gameplay centered on physical tables, tiles, seats, walls, hands, discards, melds, and scoring equipment.
• Three- and four-player riichi mahjong, currently including presets based on Mahjong Soul, Tenhou, M.League, League A, and WRC rules, plus extensive rule customization.
• Physical mahjong equipment, including ordinary and automatic tables, stools, removable cloth, mahjong boxes, point sticks, multiple tile materials, red fives, sixteen dye colors, and translucent glass tiles.
• Immersive play, with seated and dedicated table views, clickable hands, rendered walls and discards, melds, declaration and call animations, settlement screens, configurable controls, and automatic-play options.
• Multiplayer and practice tools, including player invitations, seat assignment, configurable time controls, room ownership, and Easy or Hard bots that play using their own hands and public information.
• Replays and customization, with private replay archives, step-by-step playback, external replay export, resource-pack support for tile artwork and audio, and English, Japanese, Simplified Chinese, and Traditional Chinese localization.

Craft your own set

Mahjong equipment is part of survival gameplay rather than just a menu option. Prepare blank tiles from different materials, store complete sets in mahjong boxes, engrave them with built-in Kansai or Kanto face designs, create red fives, and recolor tile backs with Minecraft dyes.

Tables can store their equipment, and ordinary tables require the physical supplies needed for play. Resource packs can further replace tile faces, backs, and supported audio assets.

Rules and table settings

The current releases provide a comprehensive Japanese riichi ruleset.

Named presets are available for Mahjong Soul, Tenhou, M.League, League A, and WRC, while the underlying rules remain extensively configurable. Match length, red-five composition, scoring options, placement rules, riichi and call behavior, draw handling, and other table rules can be adjusted without changing the physical table experience.

Rule selection is tied to the tiles actually available at the table: choosing a red-five configuration requires a compatible physical set rather than silently creating missing tiles.

Playing at the table

MChjong supports two approaches to the physical game.

Ordinary tables let players perform much of the table handling themselves. Tiles can be shuffled, assembled into walls, drawn, discarded, collected, and paired with physical point-stick payments.

Automatic tables handle routine table operations while retaining the same physical board and player seating. This makes them suitable for players who want the complete rules and presentation without manually preparing every hand.

Both use the same server-authoritative game state and rules engine.

Bots and multiplayer

Empty seats can be filled with practice bots. Different difficulty levels change their tile efficiency, value assessment, calling behavior, and defensive decisions.

Bots operate from their own concealed hand and publicly available information rather than reading hidden tiles.

For multiplayer games, players physically sit at the table to join. Rooms support invitations, seat assignment, ownership transfer, configurable clocks, readiness, and table-specific settings.

Replays

Completed hands are stored in private match archives for their participants. Replays can be inspected step by step or played through with a timeline, including draws, discards, calls, declarations, indicators, and settlements.

The current riichi implementation can also export matches locally in Tenhou JSON format for use with compatible external tools.

Customization

MChjong supports resource-pack customization for tile artwork and audio.

Tile faces and backs are handled independently, allowing custom sets without changing game rules. Physical tile materials and Minecraft dye colors remain part of the item system.

Custom recorded voice packs and table sound effects can also be supplied through resource packs.

Optional integrations

Ponder adds animated in-game tutorials for tables, equipment, and seated play.

JEI, EMI, and REI can display MChjong's component-aware crafting and supply recipes.

These integrations are optional and are not required for the core game.

Languages

MChjong currently includes:

• English
• Japanese
• Simplified Chinese
• Traditional Chinese

Compatibility

MChjong supports Fabric and NeoForge. Download the file matching your Minecraft version and mod loader.

Fabric installations require Fabric API. Other supported integrations are optional.

Open source

MChjong's code is licensed under the Apache License 2.0.

Bundled third-party artwork retains its separately documented licenses and attribution.