Warp Field HUD

A lightweight client-side HUD framework for Minecraft 1.21.11 (Fabric).

Features

• Drag-and-drop HUD positioning -- press F8 to open the HUD menu, then move any element anywhere on screen
• Per-element transparency controls -- adjust background and foreground opacity independently for every HUD element
• Master opacity -- one slider to scale the transparency of everything at once
• Color themes -- choose from preset color palettes for compass foreground, background, and crosshair elements
• Smart settings -- controls that don't apply to an element (like background opacity on the crosshair) are automatically grayed out so you're never guessing
• Built-in compass -- a clean, minimal heading compass with cardinal/intercardinal markers and a numeric degree readout
• Player markers -- see other players on your compass strip as colored glyphs (players must be within your chunk simulation distance)
• Player tracking -- cycle through all online players on the server and track a specific one with a highlighted marker
• Dynamic crosshair -- a customizable crosshair overlay with adjustable gap, thickness, length, color, and dot toggle
• Spread indicator -- smooth animated crosshair spread that reacts to sprinting, sneaking, and attack cooldown

How to Use

1. Install Fabric Loader and Fabric API for 1.21.11
2. Drop warpfield-1.2.0.jar into your mods folder
3. Launch the game and press F8 to open the Warp Field menu
4. From there you can:
   • Toggle elements on/off
   • Open per-element settings to tweak opacity, colors, and behavior
   • Enter "Arrange All" mode to drag elements around your screen
   • Click any single element to move just that one

Compass Details

• Displays your facing direction with a smooth scrolling strip
• Shows N, NE, E, SE, S, SW, W, NW markers with a pointed center indicator
• Numeric heading in degrees below the strip
• Adjustable background and foreground transparency via settings
• Player markers render as colored glyphs for nearby players
• Track Player button cycles through all online players (uses the server player list, not just render distance)

Crosshair Details

• Replaces the vanilla crosshair with a fully configurable overlay
• Adjust line length, thickness, gap, and color
• Optional center dot
• Spread animation reacts smoothly to movement state and attack cooldown
• Always centered -- not affected by HUD repositioning

Info

• Client-side only -- no server installation needed, safe for multiplayer
• Lightweight -- no dependencies beyond Fabric API
• Configurable -- all settings persist in config/warpfield/ as JSON files