華麥小幫手 HwamaiHelper

HwamaiHelper 是專為華麥伺服器（ChunghwaMC）設計的 Fabric 用戶端輔助模組，提供自訂快捷指令、快速功能選單、暱稱編輯器、創造模式英文搜尋及其他便利功能。

HwamaiHelper is a client-side Fabric utility mod designed for the ChunghwaMC server. It provides custom command shortcuts, quick-access menus, a nickname editor, Creative inventory English search, and other quality-of-life features.

重要 / Important

最新版本 1.4.0 需要安裝 MaLiLib 0.29.2+ 與 Fabric API。 Version 1.4.0 requires MaLiLib 0.29.2+ and Fabric API.

中文說明

主要功能

• MaLiLib 設定與快捷鍵

  • 使用 MaLiLib 提供統一的設定介面與快捷鍵管理。
  • 可分別啟用、停用及自訂各項功能的快捷鍵。
  • 支援按下觸發與放開觸發模式。

• 自訂指令

  • 新增、修改或刪除自訂快捷指令。
  • 支援單鍵及組合鍵，例如 G、Ctrl + Y 或 Ctrl + Shift + Z。
  • 每個指令都能獨立啟用或停用。
  • 可設定在按下或放開快捷鍵時執行。

• 暱稱編輯器

  • 支援多段文字，每一段可分別設定內容、顏色與樣式。
  • 提供即時暱稱預覽。
  • 支援粗體、斜體、底線、刪除線及亂碼。
  • 支援彩虹、雙色漸層及自訂陰影效果。
  • 內建 HSV 調色盤。
  • 可儲存多組暱稱，方便日後預覽、套用或刪除。

• 創造模式英文搜尋

  • 在非英文語言環境下，也能於原版創造模式物品欄搜尋英文名稱。
  • 支援 redstone、diamond sword 等英文關鍵字。
  • 保留 minecraft:redstone 等原版 ID 搜尋方式。
  • 可在設定中開啟或關閉。

• 遊戲模式輪盤

  • 預設快捷鍵：Alt。
  • 按住快捷鍵並移動滑鼠，即可選擇創造、觀察者或生存模式。
  • 可設定排除手持物，避免與特定物品操作衝突。
  • 在華麥伺服器使用對應的快速模式指令。

• 工作方塊選單

  • 預設快捷鍵：Shift + G。
  • 可快速開啟工作台、切石機、製圖台、織布機、鍛造台、砂輪、垃圾桶、終界箱及鐵砧等伺服器介面。

• 取得物品選單

  • 預設快捷鍵：G。
  • 可快速取得煙火、隱形物品展示框、箭矢、玩家頭顱、礦車、鞘翅、幻翼膜及光源方塊等常用物品。

• 自動補充煙火

  • 當煙火數量低於 5，且玩家剛使用煙火造成數量下降時，自動送出伺服器補充指令。
  • 具有 5 秒冷卻時間，避免重複發送。
  • 不會在操作 GUI 或丟棄物品時觸發。
  • 可在設定中開啟或關閉。

• 快速整地

  • 可自訂切換快捷鍵；未設定快捷鍵時不會啟用。
  • 啟用後，按住原版攻擊／破壞鍵會自動選取附近可立即破壞的方塊。
  • 僅處理玩家目前 Y 座標以上、互動距離內且視線可到達的方塊。
  • 每 Tick 處理數量可設定為 1 至 10。

預設快捷鍵

• 開啟主設定：X + F
• 工作方塊選單：Shift + G
• 取得物品選單：G
• 遊戲模式輪盤：Alt
• 快速整地：預設未設定

所有快捷鍵皆可透過 MaLiLib 設定介面修改。

安裝需求

目前 1.4.0 版本支援：

• Minecraft 26.2
• Fabric Loader 0.19.3+
• Fabric API 0.154.0+26.2
• MaLiLib 0.29.2+
• Java 25

本模組只需安裝於用戶端，不需要在伺服器端安裝。

安裝方式

1. 安裝 Minecraft 26.2 對應的 Fabric Loader。
2. 安裝 Fabric API。
3. 安裝 MaLiLib；此為必要依賴，不能省略。
4. 將 HwamaiHelper、Fabric API 與 MaLiLib 的 JAR 放入 .minecraft/mods。
5. 啟動遊戲後即可使用。

舊版 Minecraft 請從 Versions 頁面選擇相容版本；舊版本需要的依賴版本可能不同。

注意事項

部分功能會向華麥伺服器送出專用指令，因此在其他伺服器上可能無法使用。

快速整地及其他自動化功能應依照所在伺服器的規則使用。使用者有責任確認相關功能是否受到允許。

---

English Description

Main Features

• MaLiLib configuration and keybinds

  • Uses MaLiLib for the configuration interface and keybind management.
  • Individual features and keybinds can be enabled, disabled, or customized.
  • Supports press and release activation modes.

• Custom commands

  • Add, edit, or remove custom shortcut commands.
  • Supports single keys and key combinations such as G, Ctrl + Y, and Ctrl + Shift + Z.
  • Each command can be enabled or disabled independently.
  • Commands can activate when a keybind is pressed or released.

• Nickname editor

  • Supports multiple text sections with independent text, colors, and styles.
  • Provides a real-time nickname preview.
  • Supports bold, italic, underline, strikethrough, and obfuscated text.
  • Includes rainbow, two-color gradient, and custom shadow effects.
  • Includes an HSV color picker.
  • Nicknames can be saved, previewed, applied, or deleted.

• Creative inventory English search

  • Search English item names in the vanilla Creative inventory while using a non-English game language.
  • Supports English keywords such as redstone and diamond sword.
  • Vanilla ID searches such as minecraft:redstone remain available.
  • Can be enabled or disabled in the configuration.

• Game mode wheel

  • Default keybind: Alt.
  • Hold the key and move the mouse to select Creative, Spectator, or Survival mode.
  • An excluded held item can be configured to prevent input conflicts.
  • Uses the corresponding quick game-mode commands on ChunghwaMC.

• Workstation menu

  • Default keybind: Shift + G.
  • Quickly opens server interfaces for the Crafting Table, Stonecutter, Cartography Table, Loom, Smithing Table, Grindstone, Trash Can, Ender Chest, and Anvil.

• Get Item menu

  • Default keybind: G.
  • Quickly obtains commonly used items such as Firework Rockets, Invisible Item Frames, Arrows, Player Heads, Minecarts, Elytra, Phantom Membranes, and Light Blocks.

• Automatic firework replenishment

  • Sends the server replenishment command when the firework count drops below 5 after using a firework.
  • Includes a 5-second cooldown to prevent repeated commands.
  • Does not activate while using a GUI or dropping items.
  • Can be enabled or disabled in the configuration.

• Quick land leveling

  • Uses a configurable toggle keybind and remains disabled when no keybind is assigned.
  • While enabled, holding the normal attack/break key automatically selects nearby blocks that can be broken instantly.
  • Only processes blocks at or above the player's current Y level, within interaction range, and reachable by line of sight.
  • The number of targets processed per tick can be configured from 1 to 10.

Default Keybinds

• Open main configuration: X + F
• Workstation menu: Shift + G
• Get Item menu: G
• Game mode wheel: Alt
• Quick land leveling: Unassigned by default

All keybinds can be changed through the MaLiLib configuration interface.

Requirements

The current 1.4.0 release supports:

• Minecraft 26.2
• Fabric Loader 0.19.3+
• Fabric API 0.154.0+26.2
• MaLiLib 0.29.2+
• Java 25

This is a client-side mod and does not need to be installed on the server.

Installation

1. Install the Fabric Loader for Minecraft 26.2.
2. Install Fabric API.
3. Install MaLiLib; it is a required dependency.
4. Place the HwamaiHelper, Fabric API, and MaLiLib JAR files in .minecraft/mods.
5. Launch the game.

For older Minecraft versions, select a compatible file from the Versions page. Dependency requirements may differ between older releases.

Notes

Some features send commands designed specifically for the ChunghwaMC server and may not work on other servers.

Quick land leveling and other automation features should only be used where permitted. Users are responsible for following the rules of the server they join.

---

Links

• Source code
• Issue tracker
• ChunghwaMC website
• ChunghwaMC Wiki