⚡ StormPRVT (Fabric 1.21.1)

A Feather-Client inspired Minecraft Fabric mod featuring a customisable HUD, performance optimisations, and a cosmetics system (capes, wings, hats).

---

Features

🖥️ HUD Elements

Element	Default
FPS counter	✅
Ping (ms)	✅
Coordinates (XYZ)	✅
Biome name	✅
Facing direction	✅
In-game time	✅
Movement speed	❌ (opt-in)
Armor points	✅

HUD position: Top-Left / Top-Right / Bottom-Left / Bottom-Right
HUD background tint, text colour, and scale are all configurable.

⚡ Performance

• Entity Culling — skips rendering entities beyond a configurable distance
• Smart Animations — pauses limb animations for off-screen entities
• Fast Render — disables unnecessary GL passes during world rendering
• Disable Entity Shadows — removes shadow blobs under all entities
• Chunk Load Optimiser — batches chunk uploads to reduce stutter

🎨 Cosmetics

• Custom Cape — load a bundled preset (default, feather, anniversary) or any PNG URL
• Wings — angel / devil / fairy styles (WIP textures)
• Hat — cosmetic hat layer (WIP)

---

Installation

Requirements

• Minecraft 1.21.1
• Fabric Loader ≥ 0.15.11
• Fabric API
• (Optional) ModMenu — for config access from the main menu
• (Optional) Cloth Config — richer config UI

Build from source

git clone https://github.com/Elee_LSD/stormprvt.git
cd stormprvt
./gradlew build
# Output JAR is in build/libs/

Copy the JAR into your .minecraft/mods/ folder.

---

Keybinds

Key	Action
F6	Open StormPRVT Menu in-game

Rebindable in Options → Controls → StormPRVT.

---

Config

Config is saved at:
.minecraft/config/stormprvt.json

All options are also editable live in the in-game menu (F6) or via ModMenu.

---

Project Structure

src/main/java/com/stormprvt/
├── StormPRVT.java              # Mod init, logger, config holder
├── StormPRVTClient.java        # Client init, keybinds, HUD registration
├── config/
│   └── StormConfig.java       # JSON-backed config (Gson)
├── hud/
│   └── HudRenderer.java         # HUD draw logic (FPS, ping, coords…)
├── performance/
│   └── PerformanceManager.java  # Entity culling, animation, chunk opts
├── cosmetics/
│   ├── CosmeticsManager.java    # Texture loading (presets + URL)
│   └── CapeRenderer.java        # FeatureRenderer for cape layer
├── gui/
│   ├── StormMenuScreen.java   # In-game menu (HUD / Perf / Cosmetics tabs)
│   └── ModMenuIntegration.java  # ModMenu API hook
├── mixin/
│   ├── GameRendererMixin.java   # FastRender hook
│   ├── WorldRendererMixin.java  # Chunk optimisation hook
│   └── EntityRendererMixin.java # Shadow disable + culling hook
└── util/
    ├── ColorUtil.java           # RGBA helpers, lerp, health colours
    └── MathUtil.java            # Speed, compass heading utils

---

Extending the mod

Add a new HUD element

1. Add a boolean showXxx field in StormConfig.
2. Append a line in HudRenderer#buildLines().
3. Add a toggle in StormMenuScreen under the HUD tab.

Add a new cape preset

1. Drop a 64×32 PNG into src/main/resources/assets/stormprvt/textures/capes/.
2. Register the name in CosmeticsManager#CAPE_PRESETS.

Add a new mixin

1. Write your class in com.stormprvt.mixin.
2. Register it in stormprvt.mixins.json under "client".

---

License

MIT — do whatever you want, just keep the credit. 🙂