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.

local hud = peripheral.find("hud_glasses")
hud.setBackgroundColour(0)        -- transparent background
hud.setTextColour(colors.lime)
hud.setCursorPos(1, 1)
hud.write("Hello, HUD!")

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.