Dynamic Armor HUD

# Dynamic Armor HUD

In the middle of a fight you shouldn't have to open your inventory to find out that your chestplate is hanging on by a thread. Dynamic Armor HUD puts your equipment right next to your hotbar, so one glance tells you what you're wearing, what you're holding and how much life your gear has left.

## What it shows

- **Your armor**: helmet, chestplate, leggings and boots (including elytra and pumpkins/heads).
- **Your held items**: the tool, weapon or shield in your main hand and offhand (only items with durability, so blocks and food don't clutter the HUD).
- **Your arrows**: hold a bow or crossbow and the total number of arrows in your inventory appears (it turns red when you're out).

## Durability at a glance

- Each item shows its **remaining durability** as a number, and a small **durability bar**.
- Colors change as your gear wears down:
  - **Green**: more than 50% left
  - **Yellow**: 20–50% left
  - **Red**: less than 20% left
- When an item drops **below 15%**, its icon gets a **pulsing red glow**, so you notice it even in the middle of combat.
- Prefer percentages? Switch `displayMode` to `percent` (see Settings).

## Controls

- **H** – show or hide the HUD. Your choice is remembered.
- Change the key in **Options → Controls → Key Binds → Dynamic Armor HUD**.

## Position

By default the HUD sits in a neat row **to the left of your hotbar**, out of the way of chat, the crosshair and the offhand slot. You can also put it in any screen corner as a vertical list.

## Settings

`config/dynamicarmorhud.properties` is created the first time you start the game:
- `position` – `hotbar` (default), `top_left`, `top_right`, `bottom_left` or `bottom_right`
- `offsetX`, `offsetY` – move the HUD a few pixels
- `displayMode` – `value` (durability points, default) or `percent`
- `showHeldItems` – show main hand and offhand items (default true)
- `showArrows` – show the arrow counter when holding a bow or crossbow (default true)
- `warnPercent` – when the red pulse starts (default 15)

Restart the game after editing the file.

## Works on every server

This is a **client-side only** mod: it only draws information about your own equipment, which your game already knows. Install it on your own game and it works in singleplayer and on multiplayer servers – the server does not need it.

## Requirements

- Minecraft **1.21 or 1.21.1**
- **Fabric Loader** 0.15.11 or newer
- **Fabric API**
- Java 21 (included with the official Minecraft launcher)

## Installation

1. Install Fabric Loader for Minecraft 1.21.1 (with the CurseForge app or the official Fabric installer).
2. Install **Fabric API** for 1.21.1 (listed as a required dependency; the CurseForge app installs it automatically).
3. Put the `dynamic-armor-hud` .jar file in your `.minecraft/mods` folder.
4. Start the game with the Fabric profile and put on some armor.

## Modpacks

You are free to include Dynamic Armor HUD in any modpack, no need to ask.

## Also by this author

- **Smart Tool Safety** – stops nearly broken tools from being used up and picks the right tool with one key. Works great together with this HUD.
- **Smart Chest Organizer** – one-click chest sorting and quick deposit.
- **Floating Damage Indicators** – damage, healing and crit numbers above mobs.

*The project logo is an illustration created with AI assistance; it is not an in-game screenshot. The screenshots in the gallery are real, unedited in-game captures.*