Comandi organizer e staff
Comandi per il titolare della licenza e i delegati con ruolo XENO Staff (account EGAMEX collegato). Amministratore / Gestisci server Discord da soli non bastano per i comandi write.
Indice
Onboarding guidato
| Comando |
Descrizione |
/inizia |
Consigliato per iniziare. Rileva lo stato (licenza, setup, tornei) e mostra bottoni operativi per il passo successivo. Funziona anche prima del setup iniziale. |
Stati rilevati e azioni (via bottoni, non solo testo):
| Stato |
Cosa fa il bottone |
| Licenza non attivata |
Attiva licenza → modal codice (equivalente a /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 Su quale torneo vuoi lavorare? → pannello azioni per il torneo scelto |
Setup e attivazione
| Comando |
Descrizione |
/attiva <codice> |
Attiva XENO con chiave licenza. Chi attiva diventa titolare. Crea il ruolo XENO Staff (auto-assegnazione se Discord lo permette). |
/setup [lingua] [nome_categoria] |
Crea categoria, 5 canali base e ruoli. lingua: it / en. nome_categoria opzionale (1–100). |
Vedi Attivazione e setup per errori licenza (incluso guild_already_activated) e flusso /inizia.
Gestione Staff
| Comando |
Chi |
Descrizione |
/gestisci-staff aggiungi utente: |
solo titolare |
Assegna XENO Staff |
/gestisci-staff rimuovi utente: |
solo titolare |
Revoca XENO Staff |
/gestisci-staff elenco |
titolare o Staff |
Elenca i membri con il ruolo (max ~25, hint se di più) |
/gestisci-staff categoria nome: |
solo titolare |
Rinomina la categoria tornei e la persiste in API |
Gestione torneo
| Comando |
Descrizione |
/collega-torneo |
Collega torneo EGAMEX esistente del titolare. Crea canale e board iscrizioni. |
/crea-torneo |
Wizard creazione torneo da Discord. Al primo step scegli Da zero (wizard completo) o Da template (preset preconfigurato: inserisci solo gioco, nome e data). Template disponibili: Casual 8-team SE, BR Serale, Test 4-team, Round Robin 8-team, Sistema Svizzero 16-team. |
/stato-torneo |
Cambia stato: draft (bozza) → pending (pubblicato, iscrizioni aperte) → ongoing (avviato) → ended (concluso). |
/torneo-config [torneo_id] |
Toggle proactive: submission capitani, supervisione, auto-end, auto-forfeit, check-in, ore reminder, preset proactive (tcfg_proactive). |
Il preset proactive abilita in un click: submission capitani ON, supervisione OFF, auto-end/forfeit ON, reminder 6h, forfeit 45 min.
Le mutazioni API usano sempre il documentId del titolare, anche se il comando è invocato da uno Staff.
Risultati
| Comando |
Descrizione |
/risultato |
Inserimento risultati organizer (SE, DE, RR, BR, Racing). |
/pending-risultati [torneo_id] |
Submission capitani in attesa. Paginazione (4 per pagina). Approva/Rifiuta. Post anche in #xeno-staff-review. |
/chiedi-risultati |
DM ai capitani con match pendenti. Riepilogo con contatori: DM inviati, fallback in canale, saltati. |
Vedi Invio risultati capitano.
Team
| Comando |
Descrizione |
/gestisci-team aggiungi |
Seleziona torneo (se >1) → seleziona il capitano dal menu utenti Discord → verifica account EGAMEX collegato → modal nome team. |
/gestisci-team rimuovi |
Rimuove team tramite menu. |
Canali e evento
| Comando |
Descrizione |
/channels-audit |
Confronta canali Discord vs API. |
/channels-reconcile [apply] |
Anteprima (false) o riallineamento (true) canali base. Non rinomina una categoria con nome custom. |
/event-mode <pre|live|post> [apply] |
Profili permessi: pre (iscrizioni aperte), live, post. |
Proactive e monitoraggio
| Comando |
Descrizione |
/proactive-stats [torneo_id] |
Metriche DM, escalation, dispute, durata round. |
/bot-status |
Diagnostica completa: uptime, latenza, tier licenza, limiti tornei/registrazioni, data setup, audit canali (presenza e allineamento), lag outbox API (job pending/dead), tornei orfani (creati ma non collegati al server). Se rileva anomalie (canali fuori sync, job dead, poller stale), mostra azioni suggerite — es. eseguire /channels-reconcile apply:true. |
Comandi di consultazione (tutti i membri)
| Comando |
Opzioni |
Descrizione |
/torneo [pubblico] |
pubblico:true |
Info torneo + link canale. Nel canale torneo, preseleziona il torneo ongoing se riconoscibile. |
/classifica [pubblico] |
idem |
Classifica (stessa preselezione dal canale torneo). |
/bracket [pubblico] |
idem |
Tabellone |
/tornei [pagina] [pubblico] |
paginazione |
Elenco tornei del server. Bottoni ‹ Precedente / Successivo ›. Con pubblico:true, solo l’invocatore aggiorna il messaggio condiviso; altri utenti ottengono una copia privata. Oltre l’ultima pagina: “Non ci sono altre pagine”. |
/server-rank [pubblico] |
idem |
Rank competitivo e attività del server su EGAMEX Hub, con link alla scheda hub. |
Permessi
| Aspetto |
Comportamento |
UI Discord — /attiva, /setup, /inizia, … |
default_member_permissions = ManageGuild (Gestisci server) |
UI Discord — /crea-torneo, /collega-torneo, /gestisci-staff, risultati, team, … |
Visibili anche allo Staff (niente ManageGuild di default) |
| Runtime write |
Account EGAMEX collegato e (titolare oppure ruolo XENO Staff / legacy EGAMEX Staff) |
| Admin / ManageGuild da soli |
Non sufficienti per write |
/gestisci-staff mutate |
Solo titolare |
| API create/link/pending/… |
Sempre come organizer del guild (titolare) |
Riferimenti
