適用於 Paper 26.2 的繁體中文 Minecraft 台灣麻將插件。
- 插件版本：
3.1.0 - 遊戲規則：台灣 16 張麻將
- 顯示方式：3D 麻將牌、實體牌桌與互動按鈕
- 支援模式：4 位真人，或以電腦玩家補滿
- 執行環境：Java 21
- 關閉 Minecraft 伺服器。
- 將
MahjongPlay-TW-26.2-3D-3.1.0.jar放入伺服器的plugins資料夾。 - 啟動伺服器。
- 輸入
/plugins，確認MahjongPlayTW顯示為綠色。
Important
更新或移除舊版本後，請完整重新啟動伺服器，不要只使用 /reload。
- 站在平坦、空曠的位置。
- 面向要放置牌桌的方向。
- 輸入：
/mahjong create 我的牌桌
牌桌會建立在玩家前方約 4 格處，桌面與座位共占用約 7 × 7 格。
Caution
請勿直接在重要建築內建立牌桌。
刪除牌桌時請使用：
/mahjong destroy <編號>
不要手動破壞桌子，否則可能留下顯示實體或互動實體。
未安裝材質包時，麻將牌會顯示為普通紙張。
- 將
MahjongPlay-TW-26.2-3D-ResourcePack.zip上傳至可直接下載檔案的 HTTPS 網址。 - 編輯
server.properties：
resource-pack=<材質包 ZIP 的直接下載網址>
resource-pack-sha1=f03dd1ca5d63db9103f38192ca16ebfa0aba248a
require-resource-pack=true- 儲存檔案並重新啟動伺服器。
伺服器提供的網址必須是 ZIP 檔案的直接下載網址，不可使用一般網頁分享頁面。
| 指令 | 說明 | 權限需求 |
|---|---|---|
/mahjong create [名稱] |
建立新牌桌 | 管理員 |
/mahjong list |
查看現有牌桌 | 無 |
/mahjong join [編號] |
加入指定牌桌，也可右鍵桌中央 | 無 |
/mahjong ready |
切換準備狀態，也可再次右鍵桌中央 | 無 |
/mahjong bot |
加入一位電腦玩家 | 無 |
/mahjong start |
以電腦玩家補滿並開始遊戲 | 管理員 |
/mahjong leave |
離開目前牌桌 | 無 |
/mahjong score |
查看目前分數 | 無 |
/mahjong rules |
查看插件採用的台麻規則 | 無 |
/mahjong rerender |
重新生成牌與操作按鈕的顯示實體 | 無 |
/mahjong protection <編號> <on|off> |
切換指定牌桌的方塊保護；新牌桌預設開啟 | 管理員 |
/mahjong destroy <編號> |
刪除牌桌及其顯示實體 | 管理員 |
- 自己的手牌會顯示正面。
- 其他玩家看到的是牌背。
- 輪到自己時，右鍵自己的 3D 麻將牌即可出牌。
- 可進行吃、碰、槓、胡時，牌桌附近會出現可右鍵的浮空操作按鈕。
- 支援 4 位真人玩家。
- 人數不足時可加入電腦玩家補滿。
- 台灣 16 張麻將。
- 使用完整 144 張牌，包含八張花牌。
- 莊家起手 17 張，其餘玩家起手 16 張。
- 支援吃、碰、明槓、暗槓、自摸、放槍與一炮多響。
- 胡牌基本結構為 5 組面子加 1 對將眼。
- 台數與細則採插件內建固定版本。
遊戲中可輸入以下指令查看規則：
/mahjong rules
建立牌桌需要：
mahjongplay.command.create
切換牌桌方塊保護需要：
mahjongplay.command.protection
若未設定權限插件，也可直接授予玩家 OP 權限。
管理員操作包括：
- 建立牌桌
- 強制開始遊戲
- 刪除牌桌
f03dd1ca5d63db9103f38192ca16ebfa0aba248a
6dff09562fc0756e97fbe936b0394bd8db6f87a7bbc38076154e3f81acda898d
可使用校驗值確認下載的檔案未損壞、未被重新壓縮或修改。
請依序確認：
-
玩家具有 OP 權限，或具有：
mahjongplay.command.create -
舊版 JAR 已從
plugins資料夾移除。 -
伺服器已完整重新啟動，而不是只執行
/reload。 -
輸入
/plugins，確認MahjongPlayTW顯示為綠色。 -
查看伺服器 Console 是否出現與
MahjongPlayTW有關的錯誤。
可能原因：
- 玩家尚未啟用材質包。
- 伺服器提供的材質包網址不是 ZIP 直接下載網址。
- 材質包被下載網站重新壓縮或修改。
resource-pack-sha1與實際檔案不一致。
請重新核對材質包 SHA-1：
f03dd1ca5d63db9103f38192ca16ebfa0aba248a
輸入：
/mahjong rerender
伺服器重新啟動後，進行中的牌局會回到大廳狀態。玩家需要重新加入並開始遊戲。
已通過：
- 台麻胡牌與流程引擎自動測試
- 插件主類別載入測試
- 建立牌桌與生成方塊模擬測試
- 3D
ItemDisplay生成模擬測試 Interaction互動實體模擬測試
目前狀態：
- JAR 使用 Java 21 bytecode 編譯。
- 可在較新的 Java 執行環境載入。
- 尚未在真實 Paper 26.2 多人伺服器完成完整實戰測試。
Tip
若啟動或遊戲過程發生錯誤，回報問題時請附上完整伺服器 Console 錯誤紀錄。
回報問題時，建議提供：
- Paper 版本
- Java 版本
- 插件版本
- 是否安裝其他麻將或指令相關插件
- 完整 Console 錯誤紀錄
- 問題發生前執行的指令或操作步驟