ISCRIVITI
TorneiHubPianiSito EGAMEX
ISCRIVITI

Attivazione e setup

Attivazione e setup di XENO

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

Indice

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 (serve Gestisci server o Amministratore Discord):

/attiva codice:<LA_TUA_CHIAVE_LICENZA>

Cosa succede:

  • Il server viene collegato alla licenza EGAMEX. Chi attiva diventa il titolare (organizer del guild).
  • Il bot crea il ruolo XENO Staff e, se Discord lo permette, lo assegna all’attivatore. Il titolare opera comunque anche senza quel ruolo.
  • Se l’auto-assegnazione non è possibile (owner Discord, gerarchia ruoli, …), usa /gestisci-staff aggiungi per i collaboratori.

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

Un guild ha un solo titolare. Una seconda /attiva da un altro utente su un server già licenziato viene rifiutata. Lo stesso titolare può sostituire la chiave.

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
Server già attivato da un altro utente guild_already_activated Solo il titolare può cambiare chiave; chiedi a lui o trasferisci la titolarità fuori Discord
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 (Gestisci server):

/setup lingua:Italiano

Opzioni:

  • lingua: Italiano (it) o English (en)
  • nome_categoria (opzionale): nome personalizzato della categoria tornei (1–100 caratteri). Se assente, default XENO Tornei.

XENO crea:

Elemento Nome (installazione nuova)
Categoria XENO Tornei (o il nome scelto)
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 i canali base. Una categoria con nome custom non viene rinominata al default.

Per rinominare la categoria dopo il setup: /gestisci-staff categoria.

4. Gestisci lo Staff

Solo il titolare può assegnare o revocare lo Staff:

/gestisci-staff aggiungi utente:@collaboratore
/gestisci-staff rimuovi utente:@collaboratore
/gestisci-staff elenco
/gestisci-staff categoria nome:Night Cup
Subcomando Chi Cosa
aggiungi solo titolare Assegna XENO Staff
rimuovi solo titolare Revoca XENO Staff
elenco titolare o Staff Elenca i membri con quel ruolo
categoria solo titolare Rinomina la categoria tornei

Se Discord blocca l’assegnazione (owner del server, ruolo sopra il bot, bot senza Gestisci ruoli), XENO spiega il motivo e come sistemare la gerarchia.

I delegati Staff non possono promuovere altri Staff.

5. Collega o crea un torneo

I comandi sono disponibili al titolare e allo Staff (account EGAMEX collegato). Le operazioni API usano sempre la licenza del titolare.

Collegare un torneo esistente

/collega-torneo

Menu con i tornei EGAMEX del titolare. 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, Swiss) → 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, Sistema Svizzero 16-team.

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

6. 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
guild_already_activated Il server ha già un titolare — solo lui può re-key
Licenza su altro server Trasferisci da dashboard EGAMEX
Admin Discord ma comandi rifiutati Serve essere titolare o avere XENO Staff + account EGAMEX collegato
Non posso assegnare Staff Usa /gestisci-staff; controlla gerarchia ruoli e permesso Gestisci ruoli del bot
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 Staff: crea/collega dovrebbero essere visibili; per /attiva//setup serve Gestisci server
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