正在編輯「HwamaiHelper」

__TOC__

== 簡介 ==
'''華麥助手 (HwamaiHelper)''' 是一款專為華麥伺服器設計的 [[Minecraft]] Fabric 客戶端輔助模組。本模組旨在提升玩家在伺服器上的遊玩體驗，提供了一系列便捷的圖形化介面（GUI）、自動化功能以及深度自定義的暱稱編輯器。

* '''支援平台：''' Fabric Loader
* '''Minecraft 版本：''' 1.21.1
* '''主要目標：''' 指令自動化、便捷 UI、外觀自定義

== ✨ 主要功能 ==

=== 1. 快捷指令選單 (Quick Command Menu) ===
透過預設快捷鍵 X + F 開啟，提供整合式分頁介面：
* '''指令集：''' 快速執行常用伺服器指令。
* '''個人設定：''' 調整模組自動化行為。
* '''暱稱設定：''' 快速切換已儲存的暱稱。

=== 2. 個人化自動化 (Personal Settings) ===
* '''材質包管理：''' 
**支援自動偵測進入伺服器並執行指令（`/chmc 設定 自己 取消使用材質包`），解決材質包強制載入的問題。
* '''自動補充煙火：''' 
** 當背包煙火少於 5 個且剛使用完畢時自動觸發。
** 內建 5 秒冷卻時間防止重複執行。
** 執行指令：`/chmc 取得物品 煙火`。

=== 3. 進階暱稱編輯器 (Nickname Editor) ===
模組內建最強大的暱稱視覺化工具：
* '''即時預覽：''' 在介面上方直接顯示遊戲內實際渲染效果（包含陰影）。
* '''豐富樣式：'''
** '''基礎：''' 粗體、斜體、底線、刪除線、混淆代碼。
** '''特殊特效：'''
*** '''彩虹 (Rainbow)：''' 自動流光的動態顏色。
*** '''漸層 (Gradient)：''' 支援自定義起始與結束顏色的平滑過渡。
*** '''自定義陰影 (Shadow)：''' 可獨立設定暱稱陰影顏色。
* '''HSV 調色盤：''' 直覺式的顏色選取介面。
* '''存檔系統：''' 支援多組存檔，方便隨時切換不同場合的暱稱。

=== 4. 快速介面 (Quick Interfaces) ===
* '''遊戲模式切換輪盤：''' 按住 Alt 開啟輪盤，滑動滑鼠快速切換生存、創造、觀察者模式。
* '''遠端工作方塊 (Shift + G)：''' 快速開啟遠端工作台、切石機、鍛造台、終界箱等（需伺服器功能支援）。
* '''取得物品清單 (G)：''' 快速獲取煙火、透明展示框、光源等常用道具。

=== 5. 自定義指令與按鍵 ===
使用者可自行新增指令與按鍵組合，支援：
* 單鍵或組合鍵（如 A + Shift + Ctrl）。
* 設定「按下觸發」或「放開觸發」。

== ⚙️ 設定說明 ==

設定檔位於遊戲目錄下的 <code>.minecraft/config/hwamaihelper.json</code>。

{| class="wikitable"
! 設定項 !! 說明 !! 預設值
|-
| <code>autoDisableResourcePack</code> || 自動取消材質包 || false
|-
| <code>autoReplenishFireworks</code> || 自動補充煙火 || false
|-
| <code>openMenuKey</code> || 主選單快捷鍵 || X + F
|-
| <code>openWorkstationKey</code> || 工作方塊快捷鍵 || shift + G
|-
| <code>gameModeWheelKey</code> || 模式輪盤快捷鍵 || alt
|}

[https://github.com/njes9701/hwamaiHelper 華麥小幫手 (HwamaiHelper)GITHUB頁面]

[[Category:Minecraft 模組]]
[[Category:華麥伺服器]]