MahjongPlay (台日麻將擴充版 / TW & JP Edition)

[🇹🇼 繁體中文]

這是一個基於 MahjongPlay 進行大幅度修改（爆改）的純伺服器端 Paper 插件。這是一個同時完整支援日麻與台灣麻將的綜合擴充版本！在保留原本日本立直麻將（3D 麻將牌、右鍵互動、無需安裝客戶端 Mod）等優秀功能的基礎上，新增了專為台灣玩家和伺服器社群設計的全新玩法與經濟系統！

在此特別感謝原作者的精彩作品！本插件是基於 MahjongPlay 以及 MahjongCraft 進行二次開發。

🔥 全新獨家功能

🀄 台灣麻將（16 張）模式支援

透過 /mahjong create taiwan 建立專屬台灣麻將桌，完整支援 16 張牌規則與台數計算。

⚠️ 台灣麻將需 4 名真人玩家，目前不支援機器人。

💰 Vault 經濟系統賭注整合

新增 /mahjong rate [倍率]，桌主可在遊戲開始前設定賭注倍率。遊戲結束後將依據點數（或台數）透過 Vault 經濟系統自動進行金幣結算。

📊 玩家數據統計 & PlaceholderAPI

系統會自動記錄玩家勝場與役滿次數，支援以下 PAPI 變數：

• %mahjongplay_wins% — 玩家總勝場
• %mahjongplay_yakumans% — 玩家役滿次數

📌 核心功能

• 🎮 純伺服器端 — 玩家只需接受伺服器資源包，無需安裝客戶端 Mod。
• 🀄 3D 麻將牌 — 使用 ItemDisplay 在 3×3 牌桌展示立體麻將牌。
• 🖱️ 右鍵互動 — 出牌、吃、碰、槓、立直、榮和、自摸等操作皆透過右鍵完成。
• 🎯 多種日麻模式 — 支援四麻（半莊／東風／一局）與三麻，包含拔北、自摸損等規則。
• ✋ 兩步出牌確認 — 第一次點擊抬起麻將牌，第二次確認出牌，並高亮牌河中相同牌。
• 💬 TextDisplay 操作按鈕 — 吃、碰、槓等操作以懸浮按鈕顯示，支援二級子選單。
• ❤️ Boss 血條 — 顯示場風、牌山剩餘、玩家風位／名字／倒計時。
• 📢 ActionBar HUD — 即時顯示局數、本場、寶牌、點數與聽牌提示。
• 🏆 Title 通知 — 吃、碰、槓、立直、自摸、榮和、流局等事件以標題顯示。
• 🔄 自動化功能 — 牌桌重啟後自動恢復，所有玩家準備後自動倒數開始，空位可自動補機器人。
• 🛡️ 牌桌保護 — 玩家無法破壞牌桌方塊。
• 🇹🇼 中文役種名 — 役種以中文顯示，支援番、符、滿貫等計分。
• 🟥 赤寶牌 — 預設包含赤五萬、赤五筒、赤五索共 3 張赤寶牌。

⚙️ 適配版本與環境要求

• 伺服器核心： Paper 1.21.4+
• Java 版本： Java 21
• 前置插件（選填但強烈建議）： Vault（用於經濟結算）、PlaceholderAPI（用於排行榜變數）

🎨 材質包 (Resource Pack) 下載

由於本插件為純伺服器端，玩家必須加載特定的材質包才能看到 3D 的麻將牌面。

• 材質包已經包含在本專案開源庫的 resource-pack/ 目錄中。您也可以前往原作者的 MahjongCraft GitHub 獲取最新的伺服器材質包。

📜 常用指令

指令	說明
/mahjong create taiwan	創建台灣麻將桌 (新增!)
/mahjong rate <倍率>	設定本局經濟賭注倍率 (新增!)
/mahjong create [one/east/twowind/three]	創建日麻牌桌 (一局/東風/半莊/三麻)
/mahjong join [id]	加入牌桌
/mahjong leave	離開牌桌
/mahjong ready / unready	準備 / 取消準備
/mahjong bot	加入機器人

---

[🇬🇧 English]

This is a heavily modified pure server-side Paper plugin based on MahjongPlay. It is a comprehensive expansion that fully supports both Japanese Riichi Mahjong and Taiwanese Mahjong! While retaining all the excellent features of the original mod (3D tiles, right-click interactions, no client mods required), we have added brand-new gameplay modes and economic systems designed specifically for Taiwanese players and server communities.

Special thanks to the original authors! This plugin is a fork and secondary development based on MahjongPlay and MahjongCraft.

🔥 New Exclusive Features

🀄 Taiwanese Mahjong — 16 Tiles

Create a dedicated Taiwanese Mahjong table with /mahjong create taiwan. Fully supports 16-tile Taiwanese Mahjong rules and Tai calculation.

⚠️ Requires 4 real players and does not currently support bots.

💰 Vault Economy Betting

Use /mahjong rate [rate] to set the betting rate before the game starts. Coins are automatically settled through the Vault economy system based on points or Tai at the end of the game.

📊 Player Statistics & PlaceholderAPI

Automatically tracks player wins and Yakuman counts:

• %mahjongplay_wins% — Total wins
• %mahjongplay_yakumans% — Yakuman count

📌 Core Features

• 🎮 Pure server-side — No client mod required, players only need to accept the server resource pack.
• 🀄 3D Mahjong Tiles — Uses ItemDisplay entities on a 3×3 physical table.
• 🖱️ Right-click Interaction — Discard, chii, pon, kan, riichi, ron and tsumo are all performed via right-click.
• 🎯 Multiple Modes — 4-player (Hanchan/Tonpu/1-round) and 3-player Mahjong.
• ✋ Two-click Discard Confirmation — Lift first, confirm second. Discard pile highlight included.
• 💬 TextDisplay Action Buttons — Floating buttons for actions with two-level sub-menus.
• ❤️ Boss Bar — Real-time round info, wall count, player wind/name and timers.
• 📢 ActionBar HUD — Real-time display of round, dora, points, and tenpai indicator.
• 🏆 Title Notifications — Screen-center titles for major game events.
• 🔄 Auto-start & Auto-fill Bots — Automatic countdown when everyone is ready and bot filling.
• 🛡️ Table Protection — Players cannot break table blocks.
• 🇹🇼 Chinese Yaku Names — Supports fu, han and mangan scoring displays.
• 🟥 Red Fives — 3 red five tiles enabled by default.

⚙️ Requirements & Compatibility

• Server Core: Paper 1.21.4+
• Java Version: Java 21
• Dependencies: Vault (Economy)・PlaceholderAPI (Leaderboards)

🎨 Resource Pack

Players MUST load a specific resource pack to see the 3D mahjong tiles.

• The resource pack is included in the resource-pack/ directory of the source repository. You can also obtain it from the original author's MahjongCraft GitHub.

📜 Commands

Command	Description
/mahjong create taiwan	Create a Taiwanese Mahjong table (NEW!)
/mahjong rate <rate>	Set the economy betting rate (NEW!)
/mahjong create [one/east/twowind/three]	Create a Riichi Mahjong table
/mahjong join [id]	Join a table
/mahjong leave	Leave a table
/mahjong ready / unready	Mark ready / cancel ready
/mahjong bot	Add a bot to the game

---

License: MIT License (inheriting the original license). Credits: Original mod by doublemoon1119, mahjong4j for logic, lietxia for Majsoul style textures.