MWHud

🎨 MWHud — Customizable HUD for Minecraft

A feature-rich, highly customizable HUD mod for Fabric that brings your server’s essential stats right onto your screen — in real-time, beautifully styled, and fully draggable.

📖 About

MWHud is a Fabric client-side mod that pairs with the MWHudPlugin (Paper/Spigot) to push real-time server statistics directly to your HUD — no commands, no menus, no scoreboard clutter.

Your server stats appear right on your screen — money, fly time, PvP status, and more. Drag them where you want, style them your way, and save layouts to switch between anytime.

📸 Preview

The default Mugiwara preset — fully customizable layout with all HUD elements displayed.

✨ Features

🖥️ HUD Display Elements

| Element | Description | Requires Plugin |
|———|————-|:—:|
| 💰 Money | Your current balance | ✅ |
| 🪙 Mobcoins | Your mobcoin balance | ✅ |
| 🕊️ Fly Time | Remaining flight duration countdown | ✅ |
| 🧱 Claim Blocks | Remaining GriefPrevention claim blocks | ✅ |
| ⚔️ PvP Status | Whether PvP is enabled or disabled | ✅ |
| 📦 Envoy Timer | Countdown to the next Envoy event | ✅ |
| 🔑 Key-for-all Timer | Countdown to the next Key-for-all drop | ✅ |
| 🎉 Party Key | Current / required votes for a Vote Party | ✅ |
| 📶 Ping | Your live connection latency | ❌ |
| 👥 Online Players | Current server player count | ✅ |
| 🏷️ Server Title | A custom server name shown on-screen | ✅ |

Ping is read directly from the Minecraft client — no plugin needed.

⚙️ Customization

| Option | Details |
|——–|———|
| 16 Box Shapes | Plain Box, Pill, Accent Bar, Text Only, Bottom Line, Corner Brackets, Tag/Flag, Outline Text — plus 8 split variants with ghost/pill modes |
| 15 Colors | White, Light Grey, Grey, Black, Green, Dark Green, Gold, Yellow, Cyan, Blue, Light Blue, Purple, Red, Orange, Pink |
| Server Color Sync | Auto-matches box colors to whatever the server sends; one-click reset |
| Per-box Control | Cycle value color, box shape, and label color independently per element |
| Drag & Drop | Freely reposition any box; smart snapping to edges, alignments, and midpoints |
| Group Drag | Hold Shift and drag to move a cluster of nearby boxes together |
| Hide Boxes | Toggle individual boxes off without losing their position |
| Preset System | 3 built-in presets + save unlimited custom layouts (positions, colors, shapes, visibility) |
| HUD Scale | Cycle through 5 scale presets — Tiny, Small, Normal, Large, Huge — independent of Minecraft’s UI Scale |
| Smart Anchoring | Boxes auto-detect edge positions and anchor accordingly — left, center, or right — keeping layouts consistent across all scales |

Edit Mode Controls

| Control | Action |
|———|——–|
| Left-click (Drag Mode) | Drag a single box |
| Shift + Left-click (Drag Mode) | Group-drag nearby boxes |
| Left-click (Edit Mode) | Cycle value color |
| Right-click (Edit Mode) | Cycle box shape |
| Shift + Right-click (Edit Mode) | Cycle label color (split shapes only) |
| Left-click (Hide Mode) | Toggle box visibility |

⌨️ Hotkeys

| Key | Action |
|—–|——–|
| F6 | Toggle the entire HUD on / off |
| F7 | Toggle the scoreboard on / off |
| F8 | Open HUD Configuration |
| F9 | Open Password Manager |
| Esc | Exit the current edit mode |

🔐 Password Manager (bonus feature)

MWHud includes a built-in per-server password manager, independent of the HUD itself.

| Feature | Details |
|———|———|
| Auto-login | Automatically runs /login <password> when you join a saved server |
| Per-account storage | Passwords are stored per server + player name pair |
| Encrypted storage | Passwords are AES-encrypted before being written to disk |
| In-game UI | Add, view (masked), and delete saved entries from the F9 screen |

This is entirely optional and unrelated to the HUD data system.

📦 Installation

1. Install Fabric Loader for Minecraft 1.21.x
2. Download the latest mwhud-*.jar from the releases page
3. Drop it into .minecraft/mods/
4. Launch Minecraft with the Fabric profile

The mod works standalone — ping shows immediately with a default layout. Full HUD data (money, fly time, etc.) requires the MWHudPlugin installed on the server side.

🔌 Server admins: see the MWHudPlugin page for setup instructions.

🎮 Explorer’s Mugiwara SMP

Join Mugiwara SMP — our thriving Minecraft Survival Multiplayer server! 🌊

Embark on an epic adventure in a friendly community-driven world featuring:

• 🏪 Shop — Buy and sell items in the player-driven economy
• 🐉 Custom Dragon — Face unique dragon battles with special rewards
• ⚾ Pokéballs — Catch mobs and build your collection
• 🛡️ Custom Items/Armors — Equip exclusive gear with special abilities
• 🏠 Grief Protection — Claim your land and build with peace of mind
• ⚔️ PvP Arena / PvP Training Arena — Test your skills in balanced combat zones

Set sail for adventure — the Grand Line awaits! 🏴‍☠️