CC: HUD Glasses

3d cube

Wear a ComputerCraft monitor on your face. A pair of glasses and a special modem let any computer draw a heads-up display straight onto a player's screen, using the same monitor/term API you already know.

helicopter hud with shadow

What it does

• HUD Glasses — worn in the helmet slot (or a Curios slot). Whatever the bound modem outputs is drawn as a full-screen overlay.
• HUD Modem — a ComputerCraft peripheral (type = "hud_glasses"). Wire it to a computer like any other peripheral and write to it like a monitor.
• Binding lives on the glasses. Right-click a modem with the glasses in hand and they're bound to it. Hand the glasses to a friend and the HUD goes with them. Any number of players can watch the same modem.

If you've ever written a monitor program, you already know this peripheral.

Features

• Monitor-compatible API: write, blit, clear, scroll, setCursorPos, setTextColour, setBackgroundColour, setPaletteColour, getSize, and more. Most monitor scripts run unchanged.
• Transparent background — setBackgroundColour(0) (or - in blit) lets the world show through, so the HUD overlays the game instead of covering it.
• Pixel-perfect CC font — reuses CC: Tweaked's own glyph sheet, so all 256 characters (box-drawing, sub-pixel blocks, arrows) look exactly like a real terminal.
• Runtime resolution — setSize(w, h) from Lua, or set defaults in the config. Fewer cells means bigger text. Choose how the grid maps to the screen: FIT (keep aspect, letterbox), STRETCH (fill the screen), or COVER (fill + crop).
• Shared screens — bind several glasses to one modem and everyone sees the same display. Good for team status boards, base alarms, and shared coordinates.
• Place anywhere — the modem mounts on any block face (floor, wall, ceiling), screen facing out.
• In-game config — edit settings from the Mods list "Config" button, or bind a key to jump straight to the client settings.
• Toggle key — press H to hide or show the HUD; the setting persists.
• Optimized rendering — batched draws and a server-side payload cache keep the overhead low even for large, frequently-updated displays.

Requirements

• NeoForge 1.21.1
• CC: Tweaked 1.119.0 or newer (required)

Optional integrations

• Curios — adds a dedicated Glasses accessory slot so the glasses don't occupy your helmet. Works with the vanilla helmet slot too; the glasses render on the head either way.
• Create: Aeronautics / Sable — the binding uses a stable modem ID and a Sable-aware distance check, so the HUD keeps working when the modem rides inside a flying sub-level. Sable Companion is bundled, so there's nothing extra to install.

power armor hud with weapon

Configuration

Server (hudglassescc-common.toml, applied live):

• hudWidth (default 80) — default grid width in characters
• hudHeight (default 28) — default grid height in characters
• maxRangeBlocks (default -1) — max modem-to-player distance in blocks, -1 means unlimited

Client (hudglassescc-client.toml, per-player):

• hudEnabled (default true) — render the HUD, toggle with the H key
• hudFit (default FIT) — how the HUD scales to the screen: FIT (keep aspect, letterbox), STRETCH (fill, may distort), COVER (fill, crops overflow)
• textShadow (default NONE) — text shadow style: NONE / SHADOW / OUTLINE (experimental)

Status

Beta. Core features are in and stable, but expect rough edges and breaking changes while the mod settles. Bug reports and feedback are welcome.