ВЕРСИИ (1)

# 🀄 台灣麻將（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`（排行榜變數） --- # 🔥 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. ## 📊 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, only 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. - **Multiple Modes** — 4-player and 3-player Mahjong. - **Two-click Discard Confirmation** — Lift first, confirm second. - **TextDisplay Action Buttons** — Floating buttons with two-level sub-menus. - **Boss Bar & ActionBar HUD** — Real-time round, dora, points, player information and timers. - **Title Notifications** — Notifications for major game events. - **Persistent Tables** — Tables survive server restarts. - **Auto-start & Auto-fill Bots** — Automatic countdown and bot filling. - **Table Protection** — Players cannot break table blocks. - **Chinese Yaku Names** — Supports fu, han and mangan scoring. - **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）