BeaconHUD

BeaconHUD lets you read a beacon at a glance. Point your crosshair at a beacon (within ~8 blocks) and a small panel appears in the top-left corner:

Beacon
Tier: 4 / 4
Range: 50m
Primary: Speed
Secondary: Haste

No GUI to open, no clicking - just look at the beacon and you know its tier, how far its buff reaches, and which effects are set.

What it shows

• Tier - the completed pyramid tier (1-4), computed live from the base blocks beneath the beacon. Shows Tier: 0 (incomplete base) when the pyramid isn't finished yet.
• Range - the effect radius in blocks (tier x 10 + 10): tier 1 = 20m up to tier 4 = 50m.
• Effects - the selected primary and secondary status effects, read straight from the beacon. Shows Effects: none / unopened when nothing is selected (or when a server hasn't synced the choice to your client).

Why

The vanilla beacon only reveals its tier and effects while the GUI is open, and there's no in-world readout of how far the buff actually reaches. When you're laying out a base and want every spot covered by Haste, or you're checking which of several beacons does what, opening each one is tedious. BeaconHUD answers all of it from a glance.

How it works

• Reads the pyramid tier directly from the world by scanning the base blocks (minecraft:beacon_base_blocks tag) under the beacon - no block-entity needed, so the tier and range are always accurate even before you open the beacon.
• Reads the primary/secondary effects from the beacon block-entity by field type (cross-version safe - no hardcoded obfuscated names), with full guarding so the HUD still shows tier and range if effect data isn't available.
• Renders through Fabric's HudRenderCallback, so F1 (hide HUD) hides it like any vanilla overlay.
• Read-only - never opens the beacon, never changes a block, never sends a packet.

Controls

• V - toggle the HUD on / off (default: on)

The key is polled via raw GLFW so it works identically across every supported version without a rebind screen.

Compatibility

Works on Minecraft 1.21.8, 1.21.9, 1.21.10, and 1.21.11 with Fabric Loader 0.16+. One JAR for all four versions - install with Fabric API and drop into your mods/ folder.

• Pure client-side; safe to install on any server.
• Zero config files; nothing to set up.
• Hides automatically with the rest of the HUD on F1.