---
title: "HwamaiHelper"
source: https://chunghwamc.com/wiki/HwamaiHelper
revision: 7197
---

# HwamaiHelper

**華麥小幫手小幫手**

**模組**

![中華麥塊花](https://chunghwamc.com/wiki/images/e/ef/中華麥塊花.png)

**華麥小幫手 HwamaiHelper**

- **製作人：**：njes_7901

## 簡介

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

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

## ✨ 主要功能

### 1. 快捷指令選單 (Quick Command Menu)

透過預設快捷鍵 X + F 開啟，提供整合式分頁介面：

- **指令集：** 快速執行常用伺服器指令。
- **個人設定：** 調整模組自動化行為。
- **暱稱設定：** 快速切換已儲存的暱稱。

### 2. 個人化自動化 (Personal Settings)

- **自動補充煙火：**
  - 當背包煙火少於 5 個且剛使用完畢時自動觸發。
  - 內建 5 秒冷卻時間防止重複執行。
  - 執行指令：\`/chmc 取得物品 煙火\`。

### 3. 進階暱稱編輯器 (Nickname Editor)

模組內建最強大的暱稱視覺化工具：

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

### 4. 快速介面 (Quick Interfaces)

- **遊戲模式切換輪盤：** 按住 Alt 開啟輪盤，滑動滑鼠快速切換生存、創造、觀察者模式。
- **遠端工作方塊 (Shift + G)：** 快速開啟遠端工作台、切石機、鍛造台、終界箱等。
- **取得物品清單 (G)：** 快速獲取煙火、透明展示框、光源等常用道具。

### 5. 自定義指令與按鍵

使用者可自行新增指令與按鍵組合，支援：

- 單鍵或組合鍵（如 A + Shift + Ctrl）。
- 設定「按下觸發」或「放開觸發」。

## ⚙️ 設定說明

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

| 設定項 | 說明 | 預設值 |
|---|---|---|
| `autoReplenishFireworks` | 自動補充煙火 | false |
| `openMenuKey` | 主選單快捷鍵 | X + F |
| `openWorkstationKey` | 工作方塊快捷鍵 | shift + G |
| `gameModeWheelKey` | 模式輪盤快捷鍵 | alt |

[華麥小幫手 (HwamaiHelper)GITHUB頁面](https://github.com/njes9701/hwamaiHelper) 開發者:njes9701 與 Gemini AI✨
