CC: HUD Glasses

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.
• Portable HUD — craft a pocket computer together with a HUD Modem to give it the HUD upgrade, and carry the display with you. Same hud_glasses peripheral; bind your worn glasses to it with sneak + right-click (a plain right-click still opens the terminal).
• HUD + ender modem in one slot — a pocket computer only has one upgrade slot, so craft a HUD Ender Modem (HUD Modem + Ender Modem) and fit it to the pocket: one peripheral that is both screen and radio. rednet works on it, peripheral.find(“hud_glasses”) finds it, and the modem half is interdimensional. Servers can turn the recipe off in config.
• 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
• allowPocketHudEnderCraft (default true) — whether the HUD Ender Modem can be crafted. false removes the recipe entirely; pockets that already have the upgrade keep working

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)
• textShadowLayer (default OVER_BACKGROUND) — whether the shadow/outline is drawn over or under the cell backgrounds (experimental)
• fastGlyphRendering (default true) — draw HUD text from cached glyphs, much faster at large HUD sizes. Turn off only if another mod’s text rendering conflicts with it

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.