VECTOR HUD

Press one key and a flight-instrument HUD draws itself around you — every ring, tape and gauge computed as vector geometry at runtime, not one of them a texture.

New in 2.1.1

• Server Fair Play, on by default. On servers, LAN worlds and Realms the HUD only shows what you can actually see. Singleplayer keeps everything.
• Neutral titles inside the HUD (APEX / SYSTEMS and so on) and a new icon.

New in 2.1.0

• Every Fabric version from 1.20.1 to 1.21.11, plus NeoForge 1.21.1 and Forge 1.20.1.
• HUD text size (settings → Style, 0.80–1.60×), and auto-enlarge on small windows, on by default.
• A rebuilt instrument readout. On the classic themes it is a fan whose strips open outward from the hub; RAPTOR, GINSU, SHOTGUN, SCAN, AEGIS and RELAY get upright rows in their own style. One large figure, the least important readings give way first, and X/Y/Z stay on screen in flight. RELAY now sits on the right edge.
• NANO turns generative. Near-silent at rest; callouts assemble from particles when something matters, then dissolve. The health bar, reticle and hotbar stay as they were.
• The 3D map fills its frame and marks groups of hostiles; on NANO and SCAN it has no frame at all and fades out at its edges.
• Fixes for the vanilla HUD showing through on Fabric 1.20.1 and NeoForge, black squares behind labels, and the empty target box.

The boot

Press J. The HUD does not fade in — it is built, in five beats, in under two seconds.

Registration marks slide in from off-screen and spark as they seat, establishing the corners before anything else exists. Every ring and gauge is then drawn, the pen running from each arc's fixed end toward its live value, so a gauge can never overshoot its own track. Instruments flash brighter than full for three ticks at the moment they lock. The chromatic fringe starts wide and tightens as the optics focus. Text resolves last, each label scrambling through same-width glyphs so no line shifts by a single pixel while it settles.

Press J again and it strikes itself back down.

What it shows you

Flight instruments

The HUD reads like a cockpit the moment you leave the ground.

Volumetric holo-map

A tilted holographic table of the terrain around you, sitting near-horizontal so it reads as a volume rather than a top-down minimap. It follows your vertical look — glance up and the table rises to show the air above, look down and it lays flat to show your footing. Indoors it cuts away everything between you and the table, so a wall at your back never blocks the view into the middle of it. Mobs and other players float as pins at their true height, each with a drop-line to the floor beneath them. Four or more hostiles close together get a footprint on the map, and when a new group appears beyond the part of the map on screen while you stand still, the map glides over to it for a few seconds and back. On NANO and SCAN the map has no frame and fades out at its edges.

Awareness and alerts

Alerts are staged in four tiers — calm, caution, warning, imminent. A sound is only re-issued when the tier rises; while the tier holds, you get one quiet reminder per interval and nothing more. Nothing sounds while the game is paused. No audio is bundled: every cue is a vanilla note block, pitched and paced by tier.

Thirteen instrument suites

Themes change layout, not only colour — each one hides a different set of instruments, so the sparse suites are genuinely sparse rather than the same HUD in a new palette. Press H for the theme table.

Fair play by default

Server Fair Play is on out of the box. Whenever you are not in singleplayer — on a server, in a LAN world or on Realms — the HUD only shows what you can actually see. The holo-map pins and hostile-group markers, the radar, health bars, target marks and alerts use only mobs and players in your line of sight; a block between you and a mob hides it. In singleplayer nothing is held back.

Six features ship disabled, and they are the six that a server admin would call cheating. While Server Fair Play is active, five of them cannot be switched on at all, and the radar shows only what is in line of sight:

Two alerts go by sound or damage rather than sight: a creeper you can hear hissing behind a wall still sets off the creeper alert, and "hostile behind you" fires only right after you take a hit.

To turn it off: settings screen (K) → Fair play → Server Fair Play, or "serverFairPlay": false in config/vectorhud.json. If you do, following the rules of the server you play on is your responsibility.

There is no separate "fair play edition" to hunt down — one jar, safe to drop into a modpack as shipped.

Keys and configuration

All four are rebindable under Controls. Every panel has its own toggle in config/vectorhud.json and under /vectorhud, and /vectorhud scale resizes the whole assembly between 0.5 and 2.0.

Requirements

Every build is client-side. Nothing is installed on the server, and nothing needs to be.

There is no 2.1.0 file for 26.2; the older 1.1.2 file for it stays on the Files tab.

What differs between builds

Every build comes from one codebase. What differs is the holographic models, which need rendering calls that only some versions have:

On 1.21.6–1.21.11 the magnifier shows MODEL N/A for mobs from other mods. The settings screen opens from Mod Menu on Fabric and from the Mods list on NeoForge and Forge.

Everything else — boot, all thirteen themes, instruments, alerts, holo-map — is in every build.

Community & support

Bug reports, build previews and the live known-issues list live on the Discord:

Join the VECTOR MODS Discord

• #bug-reports — a template that asks for the four things I always end up asking for anyway (version, loader, other mods, what you were doing).
• #known-issues — confirmed bugs and workarounds, so you can check before writing one up.
• #releases — every published build, newest first.
• #roadmap — what is actually being built, in order.

If you would rather not use Discord, the CurseForge comment thread is read and answered too — Discord is just faster for back-and-forth.

Notes

• No textures. Every instrument of the HUD is geometry generated at runtime, so nothing gets blurry at any resolution. Each 2.1.0 file is about 1.2 MB: most of that is code, about 0.28 MB is the bundled Noto Sans font (SIL Open Font License), and the only image is the mod's own 128 px icon.
• No bundled audio. Alert cues are vanilla note blocks, pitched and paced by tier.
• Nothing phones home.
• Modpacks are welcome with credit. Reuploading the jar elsewhere is not.
• Not affiliated with, endorsed by, or containing assets from any film, studio or franchise.

Need a server? BisectHosting — 25% off your first month.