Questa guida descrive il flusso completo per portare XENO by EGAMEX operativo sul tuo server Discord.

Indice

• 0. Onboarding guidato (consigliato)
• 1. Acquista e invita XENO
• 2. Attiva la licenza
• 3. Setup server
• 4. Collega o crea un torneo
• 5. Verifica
• Risoluzione problemi

0. Onboarding guidato (consigliato)

Dopo aver aggiunto XENO al server, esegui:

/inizia

Il comando rileva automaticamente dove ti trovi e mostra bottoni operativi (non solo istruzioni testuali):

Stato rilevato	Bottoni disponibili
Licenza non attivata	Attiva licenza → modal codice (come /attiva)
Licenza attiva, setup non fatto	Esegui setup → conferma, poi creazione canali/ruoli
Setup fatto, nessun torneo	Crea torneo / Collega torneo
Un torneo attivo	Pubblica, Configura, Stats proattive (in base allo stato)
Più tornei attivi	Menu torneo → pannello azioni per quello scelto

/inizia funziona anche prima del setup iniziale (è esente dal gate setup).

1. Acquista e invita XENO

1. Accedi a EGAMEX e vai in Il mio piano (sidebar dashboard) oppure usa il widget XENO in homepage.
2. Acquista o attiva una licenza XENO (piano base o add-on).
3. Clicca Aggiungi XENO al tuo server Discord nella card licenza, oppure dalla pagina XENO.
4. Autorizza il bot con i permessi richiesti (canali, ruoli, messaggi, comandi slash).

2. Attiva la licenza

Via /inizia: clic Attiva licenza e inserisci la chiave nel modal.

Via comando manuale (Gestisci server o Amministratore):

/attiva codice:<LA_TUA_CHIAVE_LICENZA>

Cosa succede:

• Il server viene collegato alla licenza EGAMEX.
• Viene creato/assegnato il ruolo XENO Staff a chi esegue il comando.
• Il server risulta attivo per le operazioni torneo.

Requisiti: account Discord collegato al profilo EGAMEX dell’attivatore.

Errori licenza comuni

Messaggio / codice	Significato	Cosa fare
Codice non valido	Chiave errata o già consumata	Verifica copia da Il mio piano
Licenza già attiva su altro server	license_in_use_other_server	Trasferisci la licenza dalla dashboard EGAMEX, poi riprova /attiva
Licenza non attiva (expired/suspended)	Stato non valido	Rinnova o riattiva da Il mio piano
Permessi insufficienti	Non hai Gestisci server	Chiedi a un admin del server

3. Setup server

Via /inizia: clic Esegui setup → conferma.

Via comando manuale:

/setup lingua:Italiano

Opzione lingua: Italiano (it) o English (en).

XENO crea:

Elemento	Nome (installazione nuova)
Categoria	XENO Tornei
Canale annunci	#xeno-annunci
Canale iscrizioni	#xeno-iscrizioni
Canale classifiche	#xeno-classifiche
Canale review staff	#xeno-staff-review
Canale dashboard	#xeno-dashboard
Ruolo staff	XENO Staff
Ruolo partecipante	Partecipante

Server legacy: installazioni precedenti possono avere nomi egamex-* e ruolo EGAMEX Staff. Usa /channels-reconcile apply:true per riallineare ai nomi canonici.

4. Collega o crea un torneo

Collegare un torneo esistente

/collega-torneo

Menu con i tuoi tornei EGAMEX. Dopo la selezione:

• canale dedicato al torneo;
• board iscrizioni in #xeno-iscrizioni;
• card dashboard nel canale torneo e in #xeno-dashboard.

Creare un nuovo torneo da Discord

/crea-torneo

Al primo step scegli come creare il torneo:

• Da zero — wizard completo: gioco → formato (SE, DE, RR, BR, Racing) → impostazioni → dettagli
• Da template — preset preconfigurato: scegli il template, seleziona il gioco, inserisci nome e data di inizio. Il bot precompila formato, numero team, tipo iscrizione e parametri specifici.

Template disponibili: Casual 8-team SE, BR Serale, Test 4-team, Round Robin 8-team.

Se il collegamento al server fallisce dopo la creazione, usa il bottone Riprova collegamento o /collega-torneo per recuperare tornei orfani.

5. Verifica

/bot-status

Mostra: stato Discord, tier licenza, tornei attivi/limite, data setup, audit canali (presenza e allineamento), lag outbox API (job pending/dead), tornei orfani non collegati al server. Se qualcosa non quadra (canali fuori sync, job in dead-letter, poller fermo), compare la sezione Azioni suggerite — ad esempio l’hint per /channels-reconcile apply:true.

/channels-audit

Confronta canali Discord con la configurazione API.

Risoluzione problemi

Problema	Soluzione
/attiva fallisce	Verifica codice licenza, permessi server, collegamento account EGAMEX; vedi tabella errori licenza
Licenza su altro server	Trasferisci da dashboard EGAMEX
Bot non risponde	Controlla online e licenza (/bot-status)
Canali mancanti	/channels-reconcile apply:false poi apply:true — /bot-status può suggerire il reconcile se rileva drift
Comandi organizer nascosti	Impostazioni server → Integrazioni → XENO → Permessi comandi
Non posso creare tornei	Limite max_tournaments del tier — vedi /bot-status
Iscrizioni bloccate	Limite max_registrations del tier
Licenza in grace/expired	/bot-status — rinnova da Il mio piano

Prossimi passi

• Comandi organizer
• Comandi partecipante e capitano