Helmet HUD — Ostranauts

A green monochrome suit readout drawn inside your visor while wearing a powered pressure or EVA helmet. It's anchored to the helmet frame, so it rides the visor's cursor parallax and drifts off the screen edge with the rest of the helmet — it reads as part of the suit, not as a UI overlay.

Right-justified text traces the visor rim (a quadratic fitted to the helmet artwork), shows negative statuses and anything you're actively training, and auto-pages when there's more than fits.

The pressure suit helmet also gets a battery. Its gauge cluster runs off a pair of BB cells seated in the neck ring, and they run down while you wear it — flat cells mean a dark visor, the vanilla O2 and CO2 warnings included.

The cluster's own panel is redrawn to carry four annunciators instead of two: vanilla's O2 LOW and CO2 HIGH, plus POWER (lit green while the cells are running the gauges) and CHNG BATT (amber, flashing when they're nearly out). Unlit lamps still show their lens colour, so the panel reads as hardware rather than a row of dead sockets. The legends are painted into the panel art, which is what makes them readable when the cells die and everything else goes dark.

BB cells stack four to a holder, so you can pack spares into the helmet for a long EVA — twice the cells is twice the endurance. Set CellHours to 0 if you'd rather cells never deplete, or RequireBatteries to false to switch the whole mechanic off.

Companion to Character Sidebar, which shows the same character data in a full panel outside of EVA. Either works alone; they compose if you run both.

Build

Needs OSTRANAUTS_PATH set and the Character Sidebar repo checked out alongside this one:

C:\Claude\Ostranauts Mods\
    Ostranauts Status Sidebar\    <- shared src/Data/*.cs comes from here
    Ostranauts Helmet HUD\        <- this repo

dotnet build -c Release deploys to BepInEx/plugins/OstranautsHelmetHUD/.

The shared data layer (CharacterDataReader, CharacterSnapshot, ModLog) is compiled in from the sidebar tree via a linked <Compile Include> rather than copied — one source of truth, two fully independent DLLs, no runtime dependency in either direction.

Config

BepInEx/config/com.ostranauts.helmethud.cfg. Editable with the BepInEx Configuration Manager (F1) if you have it installed, otherwise edit the file and relaunch:

• Behaviour — Enabled, OnPressureSuits, RequireBatteries (the survival mechanic), CellHours (how long a set of cells lasts; 0 = never run down), CellsRequired, StockOldHelmets (fit cells to helmets that predate the mod)
• Display — BlinkCritical, ReferenceHeight
• Placement — RectX/Y/W/H (fractions of the helmet frame), EdgeInset (how far inside the rim the text sits), GaugeSocketX/Top/Pitch/Size (where the four gauge lamps sit, as fractions of the panel art — only worth touching if you redraw that art)
• Paging — MaxRowsEVA (6; EVA bars fill the rim), MaxRowsPressureSuit (18; only two gauge lamps down low), PageSeconds