🧭 Overview

Elytra HUD Health keeps you updated on the exact durability of your wings without opening the inventory. The HUD mimics the original Minecraft UI, can be placed anywhere on screen, and even removes elytra automatically before they shatter. Built for Fabric-based clients (1.21.x, tested on 1.21.4) with full localization (EN / RU / UK / JA) and optional chat warnings.

---

🚀 Features

• Vanilla-styled HUD – Icon, bar, and percentage share Minecraft's original beveled borders so the overlay feels native.
• Precise positioning & scaling – Offset the HUD using percentage-based sliders and tweak icon/bar height individually.
• Configurable notifications – Toggle chat warnings, sounds, percentage text, icon, and progress bar independently.
• Auto-remove safety – Automatically swap elytra into the hotbar once durability hits a custom threshold; warns you 10% before removal.
• Localization ready – Built-in English, Russian, Ukrainian, and Japanese translations for both UI and chat; one-click language cycle inside the config.
• Slider preview dimming – Adjusting sliders momentarily dims the world to improve readability without freezing gameplay.

---

📦 Requirements

Dependency	Version	Notes
Fabric Loader	0.16+	Matches your Minecraft version
Fabric API	Latest for 1.21.x	Needed for HUD events and keybinding

Optional: Mod Menu for easily opening the config screen in-game.

---

🧑‍💻 Installation

1. Install Fabric Loader for your Minecraft version.
2. Drop Fabric API and elytra_hud_health-x.y.z.jar into /.minecraft/mods (client-side only).
3. Launch Minecraft once to let the config file config/elytra_health.json generate.
4. Press the configured hotkey (default: bound to your existing ElytraBar key) or open via Mod Menu to access the UI.

---

🎛️ Configuration Highlights

Setting	Location	Description
scale, offsetX, offsetY	Config screen / elytra_health.json	Move and resize the HUD per your resolution
showIcon, showProgressBar, showPercentage	Same	Toggle individual HUD elements
soundsEnabled, showWarnings	Same	Enable ping sounds and chat notifications
autoRemove + autoRemoveThreshold	Same	Auto unequip elytra when below threshold, warning 10% prior
locale	Config screen	Cycle between EN / RU / UK / JA; defaults to Minecraft language or EN

Tip: The config screen uses scrollable sections, a footer credit link, and a dedicated language button. "Done" applies immediately and saves the JSON file.

---

🔊 Chat & Sound Alerts

• Below 50% / 25% durability: subtle bell sounds (configurable via soundsEnabled).
• At 10% durability: localized chat warning + yellow highlight.
• At 0% durability: break sound and red chat alert.
• Auto-remove imminent: red chat warning if you're airborne.
• Hotbar full: localized error message if auto-remove finds no empty slot.

All chat messages are prefixed with [EHH] and translate according to the selected locale.

---

🛠️ Development

• Language files live in src/main/resources/assets/elytrabar/lang/. Add more by copying en_us.json and updating Localization.java.
• Building: ./gradlew build (requires JDK 21+ or JDK 22 as configured in the repo).
• Testing: Launch the mod in a Fabric dev environment via ./gradlew runClient to quickly iterate on HUD tweaks.
• Code style: Vanilla-inspired UI uses manual DrawContext rectangles. Comments are intentionally sparse to match the pixel-art workflow.

---

🤝 Contributions & License

• Author: Risefall (concept + design) • README curated with ❤️ by the Elytra HUD Health maintainers.
• License: MIT (see LICENSE).

---

Fly safe! 🪽