Tre livelli — gohud

Un preset li raggruppa tutti e tre. I campi che lasci vuoti ricadono sui valori predefiniti.

Livello	Decide	Come lo cambi
`Theme`	Colori, dimensioni, scala del testo e la forma di tutto ciò che disegna il motore — pannelli dei pulsanti, campi di inserimento, schede, grafica degli interruttori	Scrivi un `.tres`, oppure generane uno con `tools/make_theme.py`
`GoSkin`	La forma di tutto ciò che disegna il codice — il joystick, le facce degli slot rapidi, l'anello del coach mark, i chip, gli scheletri, i divisori, le intestazioni di sezione	Estendila e sovrascrivi solo i metodi che ti interessano
`GoIconSet`	Icone per nome — 84 disegni di default, oppure i 16 disegni incisi del set medievale sopra di essi. Un pacchetto di texture o un font di icone; il codice chiamante è identico in entrambi i casi	Fornisci un set, oppure sovrascrivi solo qualche nome

Perché un Theme da solo non basta. Arrotondato è l'unico angolo che StyleBoxFlat conosce — porta il raggio a zero e ottieni un angolo retto; in mezzo non c'è nulla. Angoli tagliati in diagonale, un singolo bordo ispessito, un bagliore esterno: il motore non ne disegna nessuno. E il joystick e il coach mark sono disegnati in _draw(), dove un tema non arriva affatto.

Sceglierne uno

GoUi.use_preset(GoThemePresets.SCIFI_DARK)

Quella riga sola cambia tema, skin e icone. Dall'editor usa Project Settings → Gohud → Theme → Preset; da una risorsa di impostazioni, GoConfig.preset.

Tenere un campo tuo

GoUi.use_preset(GoThemePresets.SCIFI_DARK)
GoUi.config.icons = my_icons     # le tue icone, tutto il resto del preset

Valorizzare esplicitamente theme, skin o icons ha la precedenza sul preset.

I sei preset inclusi

Preset	Pannelli	Skin · icone
`default_dark` · `default_light`	Pannelli `StyleBoxFlat` arrotondati su una scala graduata di ombre; i pulsanti primari si sollevano e affondano quando vengono premuti	`GoSkin` · 84 icone di default
`scifi_dark` · `scifi_light`	Pannelli `GoStyleBoxCut` smussati con bordo al neon e bagliore; segni di focus `GoStyleBoxBracket`	`GoSkinSciFi` — joystick esagonale · icone di default
`medieval_dark` · `medieval_light`	Cornici forgiate `GoStyleBoxMedieval` — ferro e cuoio, oppure pergamena — con rivetti e ornamenti angolari sui menu	`GoSkinMedieval` · 16 icone incise sopra quelle di default

Medievale: ferro, cuoio e pergamena

medieval_dark accosta ferro e cuoio scuri all'oro antico. medieval_light usa pergamena e inchiostro. Entrambi usano GoSkinMedieval, i widget già esistenti e 16 icone originali con dettagli di incisione; le icone di navigazione ricadono sul set originale.

GoUi.use_preset(GoThemePresets.MEDIEVAL_DARK)
# Oppure: GoUi.use_preset(GoThemePresets.MEDIEVAL_LIGHT)

Scegli il preset prima di creare la UI. Le sovrascritture esplicite di GoConfig.theme, skin o icons restano comunque prioritarie. Apri res://addons/gohud/examples/medieval/medieval.tscn e premi F6 per una scheda personaggio, una bisaccia e un diario delle missioni funzionanti. I suoi pulsanti cambiano variante e aprono il dettaglio degli oggetti.

Interfacce di personaggio, inventario e missioni nella variante Ferro medievale — Ferro e cuoio

Interfacce di personaggio, inventario e missioni nella variante Pergamena medievale — Pergamena e inchiostro

Le cornici dei menu hanno un rivetto e un piccolo ornamento angolare; l'HUD sempre visibile mantiene un bordo sobrio. Salute, mana e vigore usano riempimenti rosso, blu e oliva. Cinzel è limitato a titoli e sottotitoli; il testo del corpo mantiene il font del progetto ospite o quello predefinito. Il font incluso porta con sé la propria licenza in assets/fonts/cinzel/OFL.txt.

Il set inciso ridisegna bag, book, box, coin, crown, flag, heart, key, map, potion, shield, star, sword e user, e aggiunge scroll e seal. Ogni altro nome ricade sul set di default, così close e settings mantengono i loro disegni predefiniti in ogni preset. Cinzel copre l'alfabeto latino; assegna alle intestazioni localizzate un font dedicato tramite shape.fonts.

Che cosa la suite verifica per entrambe le varianti. La skin medievale è selezionata; i pannelli di menu e HUD sono cornici forgiate, con l'ornamento solo sui menu; i titoli usano Cinzel mentre il testo del corpo mantiene il font ereditato; le icone incise vengono importate come DPITexture; uno slot rapido reale usa la skin; cambiare le manopole di una skin copiata arriva fino allo slot senza toccare il preset; e tornando indietro si ripristinano le geometrie default e sci-fi.

Costruisci un regno tutto tuo

python3 addons/gohud/tools/new_theme.py kingdom --from medieval_dark
# Modifica themes/palettes/kingdom.json, poi:
python3 addons/gohud/tools/make_theme.py kingdom
godot --headless --path . --import
# In GDScript, prima di creare i widget:
GoUi.use_preset(&"kingdom")

I temi JSON possono ereditare da altri temi JSON. I valori omessi mantengono le impostazioni del genitore; l'ereditarietà circolare viene rifiutata. Il preset generato conserva il set di icone del genitore.

Impostazione	Effetto
`shape.material`	0: ferro · 1: cuoio · 2: pergamena. Controlla i segni sulla superficie.
`shape.grain_alpha`	Opacità della trama. Usa 0 per una superficie pulita.
`shape.ornament_scale` · `shape.bevel_strength`	Dimensione dell'ornamento angolare dei menu e intensità della luce di bisello.
`shape.fonts`	Associa i ruoli titolo, sottotitolo, didascalia, corpo e pulsante a file di font res:// locali all'add-on. I ruoli omessi mantengono il font ereditato.
`skin.dials`	Raggio degli slot rapidi, visibilità dei rivetti, grana e luce. La tabella completa qui sotto elenca ogni manopola.