✨ Four ideas, no magic.

Deterministic by design — every action is an explicit gesture → tool → Foundry. Nothing to host: your own Foundry tab is the projector.

🛡️ Four rules. Non-negotiable.

Every PR, every audit, every release must satisfy them. They're constraints, not guidelines — ratified in §0.1 of the spec as the contract between today's design and tomorrow's implementation.

🥽 Validated against upstream docs.

Every spec parameter below is cited from Even Realities and FoundryVTT documentation, last re-verified for v0.13.0 on 2026-09-25 against hub.evenrealities.com/docs (networking, FAQ, testing and submission pages) and the npm registry (SDK 0.0.16).

📦 One QR from your own Foundry — no GM, no login.

Install the Foundry module (manifest URL) and the FoundryVTT G2 HUD app from Even Hub (beta group until the store listing is approved). Then open Connect G2 glasses (Collega occhiali G2) in your own Foundry — right-click your name in the Players list, press Alt+G, or use Configure Settings › EvenFoundryVTT — and tap Scan QR in the app. Opening the window is pairing: your character is preselected, the relay is checked, the QR and a 16-character code appear at once. The tab that showed the QR is the projector; the phone never logs into Foundry, so there is no «(G2)» user, no password and no HTTPS to set up for the phone (self-hosted or The Forge, v13 or v14). A GM can connect glasses for a player without a device of their own — the GM’s tab then projects. Decision record: ADR-0019. Guides: the project wiki (Italian) and the setup guide.

The Connect G2 glasses window: QR and code at once, a relay check, a 5-minute expiry, a live status under the QR (relay, glasses in the room, why a message was refused), a Restore default notice when the app page or relay is not the default, and the glasses connected to this browser with Disconnect.

╭────────────────────────────────────────────────────────────────────────╮
│ EvenFoundryVTT · Connect G2 glasses                                    │
├────────────────────────────────────────────────────────────────────────┤
│                                                                        │
│  Character  [ Thorin ▾ ]                          Relay ✓              │
│                                                                        │
│  ┌──────────────────────────┐                                          │
│  │   ▄▄▄▄▄▄▄ ▄ ▄▄ ▄▄▄▄▄▄▄   │   1. On the phone open FoundryVTT G2 HUD │
│  │   █ ▄▄▄ █ ▀█▄▀ █ ▄▄▄ █   │      and tap «Scan QR»                   │
│  │   █ ███ █ ▄▀▀█ █ ███ █   │   2. The sheet appears on the glasses.   │
│  │   █▄▄▄▄▄█ █▀▄▀ █▄▄▄▄▄█   │      Keep this Foundry tab open          │
│  │   ▄▄ ▄  ▄▄▀█▄▀▄ ▄▄▄ ▄    │                                          │
│  │   █▄▀██▄▄▀▄ ▀▄██▀▄▀▄█▀   │   Expires in  04:52                      │
│  │   ▄▄▄▄▄▄▄ ▀▄█▀ ▄ ▀█▄▀▄   │   Single use: it stops working once      │
│  │   █ ▄▄▄ █ █▀▄▄▀▀▄█▀▄▄█   │   the glasses connect.                   │
│  │   █ ███ █ ▀▄▀██▄▀▄ ▀▀    │   ● Relay connected · ○ waiting…         │
│  │   █▄▄▄▄▄█ █▄ ▀▄█▀▄█▄▄█   │   No camera? Type this code:             │
│  └──────────────────────────┘   7QK3-MX9P-2HRA-C4TE   [ Copy code ]    │
│                                                                        │
│  Glasses connected to this browser                                     │
│   ● Thorin · online · now                         [ Disconnect ]       │
│   ○ Mira   · waiting for the glasses              [ Disconnect ]       │
│                                                                        │
╰────────────────────────────────────────────────────────────────────────╯

👓 The HUD, in your face.

Interactive preview of the v0.9 layered engine (map base + status corner card + overlay panels), kept for reference. v0.12.0 replaced it with the D&D-sheet layout shown in the next section. Its gesture hints (long-press = quick action) are the historical v0.9 model; the live gestures follow ADR-0012 (tap at the base view opens the menu). Mockups from the spec § 7.

👓 Your character sheet, on the glasses.

The HUD reads like the paper 5e sheet and D&D Beyond. Five fixed zones on the 576 × 288 canvas, laid on the hardware-proven 2 × 2 grid of 288 × 144 image tiles (the real G2 host rejects image containers at off-grid offsets): A portrait 144², B header 288 × 144 (AC shield, HP box + temp, INIT · SPD · PROF, ● Action ▲ Bonus ◆ Reaction, conditions, ▲ YOUR TURN), C square map 144² centred on your token — the scene’s original art, pixelated (see below), ≤ 1 fps, D sheet 288 × 144 (Abilities · Saves & Skills, death saves at 0 HP) and E the context panel — the only zone that reacts to input. Zones A–D are drawn by our own 4-bit pixel renderer and bitmap fonts (the firmware font has no D&D glyphs): the top band A + B + C (576 × 144) is rendered once and split at x = 288 into two tiles, D is the tile at (0, 144), and E is native firmware text in the bottom-right quarter. Budget 3/4 images + 4/8 text, no page rebuild during play; the full-screen states (unpaired, connecting) use all four tiles. Real simulator screenshots below (Italian UI; the map shows the pixelated scene art of the demo crypt); full design in docs/design/g2-sheet-ux.html.

🏗️ Your tab projects. The relay only sees ciphertext.

The phone never logs into Foundry. The glasses app (FoundryVTT G2 HUD — one bundle: Even Hub package, GitHub Pages /app/, Vite dev) and the player’s own Foundry tab meet in a random room on an opaque relay (packages/relay, Cloudflare Worker + Durable Object per room). The projector — the tab that showed the QR — computes dnd5e derived data, answers snapshots, pushes deltas, sends the scene art and is the only client that executes that device’s actions. Why: Foundry ≥ 14.361 serves module HTML as text/plain, players cannot create users, Forge private games gate every path, and a store app reaches only fixed whitelisted origins. Decision records: ADR-0019 (supersedes the Foundry-served page of ADR-0016 and all of ADR-0017).

⚡ Your battle map, pixelated for 16 greens.

Zone C shows the scene’s original art — background, tiles and token art — not a schematic. The projector’s scene reader sends only compact scene data (MapSnapshot: grid, walls, tiles, visible tokens, asset references); the projector loads the pictures in its own tab (Forge CDN art included), downsizes them and sends each one once as an asset; the phone renders the square in plain, deterministic TypeScript (ADR-0018). Darkness outside your token’s sight means the map never reveals rooms your character can’t see. Inspired by the Doom-on-exotic-devices pattern and ditherpunk.

Blocks are anchored to scene pixels so they don’t crawl while the map scrolls; the art stays below mid-tone so HP, AC and turn remain the brightest marks. When a scene has no art (or it fails to load) the map falls back to a schematic walls-and-grid view.

⚡ Six layers, 5 to 15 fps.

BLE bandwidth is the bottleneck on a 4-bit greyscale phosphor display. This optimisation stack was designed for the v0.9 full-screen raster (5 fps committed, 15 fps stretch). The v0.12 sheet-layout map needs far less: one 144 × 144 image, ≤ 1 fps, changed tiles only, paced to the SDK's 100 ms image limit.

⚙️ Locale follows Foundry. Override on the glasses.

Internationalization is wired in from the MVP — the locale auto-detects from game.i18n.lang in Foundry and broadcasts at handshake; the player can override it directly from the glasses without touching the world setting. Catalogs live in Foundry (dnd5e + module languages), the G2 carries no strings of its own. See §7.16 of the spec.

╔═══════════════════════════════════════════════════════════════════════════════╗
║                              ◈  LANGUAGE                                      ║
║                                                                               ║
║                       ▶ [ • ]  Auto (Foundry: it)                             ║
║                         [ ◦ ]  English        (en)                            ║
║                         [ ◦ ]  Italiano       (it)                            ║
║                         [ ◦ ]  Deutsch        (de)                            ║
║                         [ ◦ ]  Español        (es)                            ║
║                         [ ◦ ]  Français       (fr)                            ║
║                         [ X ]  Cancel                                         ║
║                                                                               ║
║                       R1 scroll=select  tap=apply  long=cancel                ║
╚═══════════════════════════════════════════════════════════════════════════════╝

🗺️ Phase 0–13, then direct streaming and relay pairing.

🎙️ Voice: removed in v0.12.0, may return.

The bridge-hosted Deepgram proxy and the foundry-mcp server were removed together with the bridge (ADR-0016). The product is fully usable with gestures alone. Voice or MCP control may come back later as a client of the same direct channel — that needs a new ADR.

🧰 Open-source, mostly TypeScript.

Library choices are research-driven and documented as ADRs. Every external dependency was evaluated against alternatives in § 11.5.7 of the spec.