MaceUtils

--- # MaceUtils ### A Fabric HUD & GUI mod built for Mace PVP on Minecraft 1.21.11 --- ## Getting Started Press **Escape** in-game and click the small **`M`** button next to the Options button to open the MaceUtils menu. The menu has three tabs: **Mace**, **Spear**, and **Combat** — each controlling a different set of features. A **Settings** button in the top-right of the menu gives access to advanced options. --- ## Mace Tab ### Mace Hit Sound Plays a bow-hit ding sound whenever you land a mace hit. Volume and pitch are configurable in Settings. ### Damage HUD Displays a panel in the **top-left corner** when you're holding a mace showing your current **fall height** and the **estimated mace damage** it would deal. Color-coded bar — red when fall isn't enough, green when it is. Fades out gradually after you switch off the mace, and snaps back if you pick it back up. --- ## Spear Tab ### Spear HUD A left-side panel that appears while holding any spear. Shows: - **Velocity meter** — bar showing your current horizontal speed as a percentage of max charge damage, with the estimated damage value - **Speed readout** — current blocks/tick - **Jab cooldown bar** — shows exactly when your attack is ready again - **Target analysis** — when your crosshair is on a living entity, shows their current HP, a health bar, and whether your current speed is **LETHAL** or how much more speed you need - **Reach warning** — flashes `TOO CLOSE!` if your target is within 2 blocks ### Velocity Meter toggle Hides/shows the velocity bar portion if you just want the cooldown and target info. ### Reach Warning toggle Hides/shows the too-close alert. --- ## Combat Tab ### Combat HUD A sliding panel in the **top-right corner** that appears automatically when you attack any entity. Features: - **Target name and distance** — distance color-coded green/orange/red based on range - **Health bar** — live HP with color that shifts green → orange → red as the target gets low - **Combat timer bar** — 15-second countdown per target, resets on re-hit - **Multiple targets** — tracks all entities you've hit; top 2 shown expanded, rest shown compact with a small health bar - **Target count** label in the panel header All entries animate in with a slide and fade out when targets die or time out. ### Combat Glow Entities currently in your combat tracker get a **red outline glow** (client-side only, visible only to you). ### Totem HUD A small panel in the **bottom-right corner** showing how many Totem of Undying you're carrying across your entire inventory. Animated — bounces and flashes **green** when you pick one up, shakes and flashes **red** when one is consumed. ### Reset Counter Resets the internal totem pop counter back to zero. Useful for recording sessions. --- ## Settings Screen Open from the **Settings** button in the top-right of the main menu. | Setting | Default | Range | |---|---|---| | Combat timeout | 15s | 5s – 60s | | Health bar | ON | — | | Distance display | ON | — | | Timer bar | ON | — | | Target count | ON | — | | HUD opacity | 100% | 10% – 100% | | Sound pitch | 1.0 | 0.5 – 2.0 | | Sound volume | 1.0 | 0.1 – 2.0 | All settings save automatically when you close the menu. --- ## Commands MaceUtils registers subcommands under `/studiolib maceutils`: | Command | Description | |---|---| | `/studiolib maceutils status` | Shows which features are currently enabled | | `/studiolib maceutils reset-totem` | Resets totem pop counter to 0 | | `/studiolib maceutils reload-config` | Reloads config from disk | --- ## Requirements - Minecraft **1.21.11** - [Fabric Loader](https://fabricmc.net/use/installer/) - [Fabric API](https://modrinth.com/mod/fabric-api) - [AStudioLib](https://modrinth.com/mod/astudiolib) --- *Made by AttackStudioYT — [YouTube](https://youtube.com/@AttackStudioYT)*