Documentazione
Costruire un gioco
Theme pack
Aggiornata 2026-11-03
Theme pack
Un theme pack definisce un universo senza cambiare il codice del motore.
File
| File | Scopo |
|---|---|
theme.yaml |
Brand, nomi, gruppi, attributi, modello di sesso, moduli, etichette, seeder |
pack.yaml |
Metadati e versione del contratto |
labels/{en,it}.json |
Override delle etichette a runtime |
| Seeder di contenuto | Catalogo, prove, ambienti, pacchetti, campagne |
themes/neutral è lo starter neutro, themes/animalia-demo è una demo, themes/_template è il punto di partenza.
Creare un tema
php artisan theme:new my-game
php artisan theme:validate --path=themes/my-game/theme.yaml
php artisan theme:preflight --path=themes/my-game/theme.yaml
theme:new è additivo e non sovrascrive. game:create crea e valida un game pack e stampa una checklist di provisioning.
Validare e seedare
php artisan theme:validate
php artisan theme:preflight
php artisan theme:seed
theme:seed valida il tema, risolve i seeder dichiarati e li esegue in modo idempotente (prima i gruppi, poi catalogo, ambienti, prove, pacchetti, campagne).
Pubblicare le etichette
php artisan theme:labels:publish
Regole
- Tieni i fatti scientifici separati dai modificatori competitivi.
- Usa vocabolario neutro nel motore:
collectible,instance,group. - Non hardcodare vocabolario, gruppi o contenuti.
- Versiona contenuti e regole.