Documentazione
Per iniziare
Configurazione
Aggiornata 2026-11-03
Configurazione
La configurazione è Laravel standard: i valori in .env alimentano config/*.php. Non committare mai .env o segreti.
Applicazione
| Variabile | Scopo |
|---|---|
APP_URL |
URL pubblico di base |
APP_ENV |
production su un server live |
APP_DEBUG |
false su un server live |
APP_KEY |
Generata da php artisan key:generate |
THEME_PATH |
Tema attivo, es. themes/neutral/theme.yaml |
PRODUCT_SITE_ENABLED |
true sul sito di vendita: marketing alla radice, gameplay sotto /demo; false per i giochi |
CONTACT_EMAIL |
Destinatario del modulo contatti prodotto |
KIT_VERSION |
Versione mostrata al client e ai tool di build |
Database e coda
| Variabile | Scopo |
|---|---|
DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
Connessione MySQL |
QUEUE_CONNECTION |
Driver coda (database, redis, ...) |
CACHE_STORE, SESSION_DRIVER |
Driver cache e sessione |
| Variabile | Scopo |
|---|---|
MAIL_MAILER, MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD |
Trasporto SMTP |
MAIL_FROM_ADDRESS, MAIL_FROM_NAME |
Mittente della posta transazionale |
Client e auth
| Variabile | Scopo |
|---|---|
CLIENT_API_BASE_URL |
URL API incorporato nella build del client |
AUTH_TOKEN_TTL_DAYS |
Durata token Sanctum (default 30) |
SANCTUM_STATEFUL_DOMAINS |
Host ammessi per l'auth a cookie |
Feature flag
| Variabile | Scopo |
|---|---|
MECHANICS_DYNAMIC_RULES |
Usa il profilo meccaniche versionato |
ABILITIES_ENABLED |
Abilita le abilità |
QUIZ_ENABLED |
Abilita il modulo quiz |
CONTROL_PLANE_ENABLED |
Abilita l'API control firmata |
TIMED_TRIALS_ENABLED |
Abilita le sessioni quiz a tempo |
Alcuni flag hanno override per gioco in Feature settings.
AI (opzionale)
| Variabile | Scopo |
|---|---|
OLLAMA_BASE_URL, OLLAMA_DEFAULT_MODEL, OLLAMA_FALLBACK_MODEL |
Generazione prosa locale |
SD_* |
Connessione e comandi di processo Stable Diffusion Forge |
TTS_COMMAND |
Comando text-to-speech locale opzionale |
Sito prodotto
PRODUCT_SITE_ENABLED=true abilita il sito marketing alla radice, /docs, /contact e la sandbox /demo. Con il flag spento (default) l'app si comporta come un gioco.