MahjongPlay

Paper plugin for Japanese Riichi Mahjong in Minecraft. Ported from doublemoon1119/MahjongCraft Fabric mod.

MahjongPlay

A pure server-side Paper plugin that brings full Japanese Riichi Mahjong to Minecraft. Players interact with 3D mahjong tiles on a physical table using right-click entity interactions — no client mod required.

Ported from the Fabric mod MahjongCraft by doublemoon1119.

Features

- Red fives — players only need to accept the server resource pack - Red fives using ItemDisplay entities on a 3×3 table - Red fives for all actions (discard, chii, pon, kan, riichi, ron, tsumo) - Red fives with full rule support - Red fives: removed 2-8 manzu tiles, disabled chii, nukidora (拔北), tsumo loss scoring - Red fives with discard pile highlight - Red fives with two-level sub-menus - Red fives showing all players' wind/name/timer, round info, and wall count - Red fives with round, dora, points, and tenpai indicator - Red fives for game events (chii/pon/kan/riichi/tsumo/ron/draw) - Red fives that survive server restarts - Red fives with 3-second countdown when all players are ready - Red fives for empty seats on game start - Red fives — blocks cannot be broken by players - Red fives and score display (fu/han/mangan naming) - Red fives — 3 red five tiles enabled by default

Requirements

- Paper 1.21.4+ (tested on Leaves core 1.21.8) - Java 21 - Server resource pack with mahjong tile models (included in `resource-pack/`)

Commands

| Command | Permission | Description | |---------|-----------|-------------| | `/mahjong create [one/east/twowind/three]` | OP | Create a table | | `/mahjong destroy [table-id]` | OP | Destroy a table (tab-complete) | | `/mahjong bot` | OP | Add a bot | | `/mahjong kick <seat>` | OP | Kick a player | | `/mahjong start` | OP | Force start | | `/mahjong join [id]` | All | Join a table | | `/mahjong leave` | All | Leave a table | | `/mahjong ready / unready` | All | Toggle ready | | `/mahjong list` | All | List all tables | | `/mahjong info` | All | Show table info |

Credits

- Original mod: MahjongCraft by doublemoon1119 - Mahjong logic: mahjong4j

License

MIT

---

中文

一个纯服务端的 Paper 插件，在 Minecraft 中实现完整的日本立直麻将。玩家通过右键点击 3D 麻将牌实体进行游戏，无需安装任何客户端 Mod。

移植自 Fabric 模组 MahjongCraft（作者：doublemoon1119）并在此基础上加入了三人麻将的玩法和更多适合服务器的便利功能。

功能特性

- 赤宝牌 — 玩家只需接受服务器资源包即可游玩 - 赤宝牌 — 使用 ItemDisplay 实体在 3×3 牌桌上展示立体麻将牌 - 赤宝牌 — 出牌、吃、碰、杠、立直、荣和、自摸等所有操作均通过右键点击完成 - 赤宝牌 — 支持四麻（半庄/东风/一局）和三麻，规则完整 - 赤宝牌 — 去除二万~八万、禁止吃、拔北（抜きドラ）、自摸损计分 - 赤宝牌 — 第一次点击抬起麻将牌，第二次点击确认出牌，同时高亮牌河中相同的牌 - 赤宝牌 — 吃/碰/杠等操作以悬浮按钮形式显示，支持二级子菜单 - 赤宝牌 — 常驻显示场风、牌山剩余、所有玩家风位/名字/倒计时 - 赤宝牌 — 实时显示局数、本场、宝牌、点数、听牌提示 - 赤宝牌 — 吃/碰/杠/立直/自摸/荣和/流局等事件以屏幕中央标题显示 - 赤宝牌 — 服务器重启后牌桌自动恢复 - 赤宝牌 — 所有玩家准备后 3 秒倒计时自动开始，空位自动补机器人 - 赤宝牌 — 玩家无法破坏牌桌方块 - 赤宝牌 — 所有役种以中文显示，支持番/符/满贯等计分展示 - 赤宝牌 — 默认包含 3 张赤宝牌（赤五万/赤五筒/赤五索）

环境要求

- Paper 1.21.4+（已在 Leaves 核心 1.21.8 上测试） - Java 21 - 服务器资源包（麻将牌模型和贴图，已包含在 `resource-pack/` 目录中）

指令

| 指令 | 权限 | 说明 | |------|------|------| | `/mahjong create [one/east/twowind/three]` | OP | 创建牌桌（一局/东风/半庄/三麻） | | `/mahjong destroy [牌桌ID]` | OP | 销毁指定牌桌（支持 Tab 补全） | | `/mahjong bot` | OP | 添加机器人 | | `/mahjong kick <座位号>` | OP | 踢出玩家 | | `/mahjong start` | OP | 强制开始游戏 | | `/mahjong join [id]` | 所有人 | 加入牌桌 | | `/mahjong leave` | 所有人 | 离开牌桌 | | `/mahjong ready / unready` | 所有人 | 准备/取消准备 | | `/mahjong list` | 所有人 | 查看所有牌桌 | | `/mahjong info` | 所有人 | 查看当前牌桌信息 |