EvenFoundryVTT · proposta UX v0.12 · giro 2 · implementata · 23 settembre 2026

La scheda del personaggio, portata sugli occhiali

Una HUD per Even Realities G2 che si legge come la scheda cartacea di D&D 5e e come D&D Beyond: box delle caratteristiche, CA nello scudo, punti ferita, cerchi di competenza. In più una mappa quadrata del combattimento, tutto in 576 × 288 pixel di verde a 16 livelli.

Brief

Per chi, dove, in quanto tempo

Luca, il giocatore

Gioca in presenza, con miniature e dadi veri. Oggi tiene il telefono sul tavolo per consultare la scheda su D&D Beyond e perde il filo della scena. Vuole sapere quanti PF ha, se è il suo turno, cosa può fare senza abbassare lo sguardo.

Il contesto d'uso

Sguardi di 1–2 secondi, testa alta, luce ambiente variabile, rumore del tavolo. Input solo dall'anello R1 o dalla tempia: tap, doppio tap, swipe, pressione lunga. Niente tastiera, niente audio in uscita.

Il vincolo hardware

576×288 px, verde a 16 livelli. Al massimo 4 immagini ≤ 288×144 e 8 contenitori testo per pagina. Una sola immagine alla volta, a ≥ 100 ms di distanza. Il font firmware è proporzionale, senza dimensioni e senza simboli D&D.

Principi

Cinque regole che guidano ogni pixel

Si legge come una schedaStessi simboli e stessa posizione dell'informazione della scheda cartacea e di D&D Beyond: chi gioca da anni la riconosce senza impararla.
Prima i numeri che uccidonoPF, CA e turno sono i tre valori più grandi e più luminosi. Tutto il resto è secondario e più scuro.
Un solo punto d'interazioneI gesti agiscono sempre sul pannello contesto in basso a destra. Il resto dello schermo si aggiorna da solo e non cattura mai input.
Due pagine, scelte dal giocoCaratteristiche di default; Tiri salvezza e abilità quando il GM chiede una prova; tiri contro la morte a 0 PF. Attacchi e incantesimi vivono nel pannello contesto, dove si scelgono.
Mai uno schermo mutoOgni stato (non associato, in collegamento, offline, GM assente) ha una schermata che dice cosa succede e cosa fare.

Riferimenti

Dalla scheda cartacea e da D&D Beyond alla G2

Inventario degli elementi della scheda 5e (2014 e 2024) e della vista di D&D Beyond, con dove finiscono sugli occhiali.

Elemento	Cartaceo	D&D Beyond	Sulla G2	Visibilità
Classe armatura	scudo al centro	scudo accanto alle caratteristiche	scudo 44×52 px nell'intestazione, cifra grande	sempre
Punti ferita (attuali / max / temp)	riquadro al centro	box PF con cura/danno	box con cuore, cifre grandi, barra e badge TEMP	sempre
Caratteristiche	6 box: modificatore grande, punteggio nell'ovale	6 box in riga, stessa gerarchia	6 box 44×100 identici al cartaceo	pagina «Caratteristiche»
Iniziativa · Velocità · Competenza	tre box vicino alla CA	statistiche in testata	tre mini-box sotto i PF	sempre
Ispirazione	casella in alto a sinistra	interruttore	stella accesa o spenta vicino al nome	sempre
Tiri salvezza · Abilità	cerchi pieni = competente	pallini, doppio pallino = maestria	● competente · ◉ maestria · ○ no	pagina «TS e abilità»
Attacchi e incantesimi	tabella nome / bonus / danno	tab Azioni	righe del pannello contesto con bonus e danno a destra	menu azioni
Economia d'azione	—	Azione · Bonus · Reazione	● ▲ ◆ + movimento nella riga bassa dell'intestazione	in combattimento
Slot incantesimo	caselle da barrare	pallini per livello	■□ per livello nel titolo della lista incantesimi	lista incantesimi
Tiri contro la morte	3 successi · 3 fallimenti	stesso	6 cerchi grandi, sostituiscono la scheda a 0 PF	solo a 0 PF
Condizioni · Concentrazione	—	elenco condizioni	chip nell'intestazione con round rimanenti	quando presenti
Ritratto	disegno/foto	avatar in testata	144×144 in alto a sinistra, dall'immagine dell'attore Foundry	sempre

Architettura della schermata

Cinque zone, quattro immagini, un solo punto di input

Decisione: ADR-0018. La griglia nasce dal budget SDK. Nella fascia alta tre immagini da 144 px di altezza affiancate coprono esattamente 576 px. Nella fascia bassa la scheda a schede (immagine) sta accanto al pannello contesto: è testo firmware, perché è l'unica zona che si scorre e si seleziona.

Zona	Area (x, y, l × a)	Container SDK	Aggiornamento	Cattura input
A · Ritratto	`0, 0, 144 × 144`	image #1	al cambio di scena o condizione (attenuato a 0 PF)	no
B · Intestazione	`144, 0, 288 × 144`	image #2	su variazione di PF, CA, turno, condizioni	no
C · Mappa	`432, 0, 144 × 144`	image #3	≤ 1 fps, solo se cambia (hash)	no
D · Scheda a schede	`0, 144, 288 × 144`	image #4	al cambio di scheda o di dati	no
E · Contesto	`288, 144, 288 × 144`	text / list × 3 (titolo, corpo, suggerimento)	istantaneo, `textContainerUpgrade` senza flicker	sì (tramite sfondo)
Sfondo	`0, 0, 576 × 288`	text `' '`, `isEventCapture: 1`, z minimo	mai	sì

Budget usato: 4 / 4 immagini e 4 / 8 testo. Restano 4 contenitori testo per toast e avvisi. Con questa griglia non serve mai rebuildPageContainer durante il gioco, quindi niente flicker.

Linguaggio visivo

Simboli della scheda, disegnati per 16 livelli di verde

Ogni icona è pixel art da 12–52 px, disegnata dal nostro renderer (il font firmware non ha questi simboli). La luminosità stabilisce la gerarchia: 15 per i valori critici, 11 per il testo, 7 per le etichette, 3–4 per le cornici.

Livelli di luminosità e ruolo

Ruolo	Carattere	Altezza	Livello	Esempio
Cifre critiche (PF, CA, modificatori)	pixel bold	18–22 px	15	`45` `18` `+3`
Nome del personaggio	pixel bold	16 px	15	`THORIN`
Valori secondari	pixel	12 px	11	`/38` `+6`
Etichette (maiuscoletto)	bitmap 8 px	8 px	7–9	`CA` `PUNTI FERITA`
Testo contesto	firmware	~20 px riga	chiaro	registro, liste

Interazione

Quattro gesti, sempre con lo stesso significato

Gesto (anello R1 o tempia)	Sulla radice	In una lista	Su un esito
Tap	apre Azioni	conferma la voce	azione successiva suggerita (es. 2° attacco)
Swipe su / giù	scorre registro o iniziativa	sposta il cursore ▶	—
Doppio tap	esce dall'app (obbligo Even Hub)	indietro di un livello	chiude
Pressione lunga (extra)	menu di sistema con scorciatoie, tutte raggiungibili anche col tap: scheda successiva · zoom mappa · segui token · vantaggio · fine turno · lingua · riconnetti

stateDiagram-v2
  direction LR
  [*] --> Radice
  Radice --> Azioni: tap
  Azioni --> Bersaglio: attacco
  Azioni --> Incantesimi: incantesimi
  Incantesimi --> Slot: incantesimo con slot
  Slot --> Bersaglio
  Incantesimi --> Bersaglio: trucchetto
  Bersaglio --> Esito: tap = tira
  Esito --> Radice: doppio tap / 8 s
  Azioni --> Radice: doppio tap
  Radice --> Reazione: evento Foundry (priorità, 10 s)
  Reazione --> Radice
  Radice --> Offline: connessione persa
  Offline --> Radice: ricollegato

Pagina automatica della scheda (zona D)

Default → Caratteristiche · prova o tiro salvezza richiesto dal GM → TS e abilità · 0 PF → Tiri contro la morte. Se il giocatore cambia pagina a mano, la scelta resta fino al prossimo evento.

Segnali di turno

Quando tocca a te, il chip ▲ TUO TURNO si accende nell'intestazione, il bordo del ritratto passa al livello 15 e il pannello contesto mostra l'iniziativa. Non ci sono animazioni: la G2 non le supporta.

Schermate

Undici momenti di una sessione

Personaggio d'esempio: Thorin, nano delle colline, Chierico 5 (Dominio della Guerra). Combatte con il martello e lancia incantesimi, così tutte le pagine della scheda hanno contenuto reale.

Mappa · zona C

L'arte originale della scena, pixelata

La mappa quadrata usa lo sfondo vero della scena Foundry (più tile e immagini dei token), scaricato dal telefono dallo stesso server. Viene ritagliata attorno al tuo token, ridotta a blocchi, portata a 16 livelli con dithering Floyd–Steinberg come nella vecchia pipeline raster, e oscurata oltre il raggio visivo del personaggio.

1 · Originale

Sfondo e tile della scena alla risoluzione della finestra (12×12 caselle). Nell'esempio è una cripta generata a codice; nell'app è l'immagine della tua scena.

2 · Pixelata

Media per blocchi (dimensione pixel 1, 2 o 3, predefinita 2): il dettaglio che il display non può mostrare diventa texture leggibile invece di rumore.

3 · Sulla G2

Floyd–Steinberg a serpentina fino al livello 11, così PF e CA restano i segni più luminosi. Oltre il raggio visivo resta al 20%: niente zone inesplorate rivelate. Token, mirino e portata sono disegnati sopra, nitidi.

Associazione · ADR-0017

Ogni giocatore ha la sua chiave

Il GM abilita gli occhiali una volta sola; poi ogni giocatore si associa da solo dal proprio Foundry e custodisce la propria chiave. Il Foundry del giocatore, se è aperto, serve i suoi occhiali; altrimenti fa da riserva il GM.

sequenceDiagram
  autonumber
  participant GM as Foundry del GM
  participant P as Foundry del giocatore
  participant G as Occhiali (Even App)
  GM->>GM: «Abilita occhiali per i giocatori» — crea «Luca (G2)»
  GM->>P: password cifrata per la chiave pubblica di Luca
  P->>P: «Associa i miei occhiali» — genera la chiave del dispositivo
  P->>GM: chiave del dispositivo cifrata per la chiave pubblica del GM (riserva)
  P-->>G: QR (URL Foundry + utente + password + chiave)
  G->>P: hello sigillato (Luca online: risponde il suo Foundry)
  P->>G: welcome + chiave ruotata (QR monouso)
  Note over P,G: Luca chiude il portatile
  G->>GM: richieste sigillate (risponde il GM, che ha la chiave di riserva)

Chi risponde agli occhiali

Il Foundry del giocatore se è connesso; altrimenti il GM attivo, se ha la chiave di riserva. Solo chi è eletto esegue le azioni: niente doppio attacco nei passaggi di consegne.

Cosa vede chi

I messaggi viaggiano cifrati con la chiave del dispositivo: gli altri giocatori vedono solo testo cifrato. Password e chiavi passano sempre cifrate per la chiave pubblica del destinatario.

Cosa resta al GM

Abilitare i giocatori (Foundry permette solo al GM di creare utenti e password), rigenerare una password, revocare un dispositivo, associare chi non ha Foundry aperto.

Casi limite e accessibilità

Quello che rompe i layout, deciso in anticipo

Numeri lunghi

PF 7 e PF 345/999 occupano lo stesso box. Le cifre si stringono in un font condensato oltre le 3 cifre, e il box non cambia mai dimensione (INV-1).

Nomi lunghi e lingue

Il nome si tronca con «…» in base alla larghezza in pixel misurata. Le etichette esistono in IT ed EN e sono verificate sulla larghezza della versione più lunga.

Niente ritratto

Se l'attore non ha immagine si usa lo stemma della classe (martello per il chierico) su fondo tratteggiato, mai un riquadro vuoto.

Leggibilità in luce

Nessun testo sotto gli 8 px e nessuna informazione affidata solo al livello di grigio: competente e no si distinguono per forma (● e ○), non per luminosità.

Banda BLE

Tra 10 e 30 KB/s. Le immagini statiche (ritratto, caratteristiche) partono una volta sola; la mappa usa delta per tile ed è limitata a 1 fps; PF e turno arrivano in meno di 300 ms.

2014 e 2024

Etichette e regole seguono core.modernRules: ad esempio «Ispirazione eroica» nella versione 2024. La struttura della scheda non cambia.

Decisioni prese · giro 2

Cosa hai scelto e cosa è cambiato

Mappa quadrata 144×144 in alto a destra12×12 caselle (60 ft), centrata sul tuo token, mirino e portata disegnati in pixel.
Ritratto dall'immagine dell'attore, fallback tokenPoi lo stemma della classe se mancano entrambi. Dithering a 16 livelli dentro una cornice come D&D Beyond.
Scheda con due pagine: Caratteristiche · TS e abilitàAttacchi e incantesimi passano al pannello contesto con bonus, danni e slot in riga. L'economia d'azione sale nell'intestazione. I tiri contro la morte restano uno stato a 0 PF.

Implementato · evenhub-simulator 0.9.5

Sul simulatore reale

Screenshot catturati dall'API di automazione del simulatore ufficiale: stesso renderer pixel-art che gira sugli occhiali, 12/12 scene verificate. Il ritratto resta in mezzo tono, così PF, CA e turno sono i segni più luminosi; la mappa mostra l'arte della scena pixelata, con le ombre dei muri.

Simulatore: Combattimento: il tuo turno — Combattimento: il tuo turno

Simulatore: Selezione bersaglio — Selezione bersaglio

Simulatore: Prova richiesta dal GM — Prova richiesta dal GM

Simulatore: A 0 punti ferita — A 0 punti ferita

Simulatore: Connessione persa — Connessione persa