Vai al contenuto principale

Documentazione

I 51 comandi del bot: sintassi, opzioni, permessi ed esempi.

Per iniziare

Tre minuti di lettura che rendono ovvio tutto il resto della pagina.

Leggere una sintassi

Tutti i comandi sono comandi slash: digiti / in Discord, appare l'elenco e Discord ti guida opzione per opzione. In questa pagina la sintassi si legge così:

  • <opzione>: obbligatoria, senza di essa il comando non parte.
  • [opzione]: facoltativa: ha un valore predefinito o semplicemente non ha effetto.
  • /comando sottocomando: i comandi più ricchi sono divisi in sottocomandi.

I nomi mostrati qui sono quelli che il bot usa in questa lingua. Ne parla tredici, e la traduzione arriva fino al nome dei comandi e delle loro opzioni: dopo un /lingua, /ban utente: diventa /ban user: in inglese.

Chi può usare cosa

Due strade portano a un comando, e basta percorrerne una:

  • Il permesso Discord indicato nell'intestazione di ogni comando. Gli amministratori e il proprietario del server li hanno tutti.
  • Un ruolo staff di livello sufficiente, solo per i comandi di moderazione. È quello che permette di affidare /warn a una squadra senza darle il diritto di silenziare i membri in Discord.

Esistono tre livelli staff, associati a ruoli del tuo server con /staff. Ogni comando di moderazione richiede un livello minimo, regolabile uno per uno:

LivelloComandi aperti per impostazione predefinita
Livello 1 /clear /timeout /warn /history /sanction /note /slowmode
Livello 2 /kick /ban /tempban /massmove /unwarn /lock /unlock /role
Livello 3 /unban

Il livello valido per un membro è quello del suo ruolo staff più alto. Questi livelli aprono l'accesso: non tolgono mai un diritto a chi possiede già il permesso Discord corrispondente.

I codici di sanzione

Ogni sanzione emessa dal bot (ban, espulsione, silenziamento, avvertimento) riceve un codice pubblico unico di dodici caratteri, del tipo K7Q2M9XAP4RN. Né I, né L, né O, né 0, né 1: il codice si detta ad alta voce senza ambiguità.

Quel codice è la chiave di tutto il resto: /sanction per la scheda, /note per allegarci un commento interno, /unwarn per revocarla. Compare nel messaggio privato inviato al membro, nella conferma ricevuta dal moderatore e nel canale dei log.

Opzioni comuni ai comandi di moderazione

  • motivo: ripreso nel MP al membro, nel registro di controllo di Discord e nella cronologia.
  • mp: avvisare il membro o no. Predefinito: sì.
  • visibilità: rendere la conferma visibile nel canale. Predefinito: no, la vede solo il moderatore.

Attesa tra due usi

Ogni comando impone una breve attesa per membro, indicata nella sua intestazione (da 2 a 10 secondi secondo il costo dell'operazione). Protegge il bot da un sovraccarico; non si applica mai da un membro all'altro.

Sito o Discord?

Indifferentemente. La dashboard e i comandi scrivono nello stesso database: un'impostazione fatta con un comando compare subito sul sito, e una modifica fatta sul sito viene presa in carico dal bot senza riavvio. I comandi di configurazione più ricchi (/welcome, /logs, /ticket, /staff) aprono del resto un pannello interattivo invece di moltiplicare le opzioni.

I sistemi

Cosa fanno i moduli una volta attivati: il dettaglio che la scheda di un comando non può contenere.

Livelli ed esperienza

Ogni messaggio scritto in un canale rende tra 15 e 25 XP, estratti a caso. Si conta un solo guadagno al minuto e per membro: scrivere dieci messaggi di fila non rende più di uno solo. I bot, i messaggi privati e i messaggi di sistema (ingressi, messaggi fissati) non rendono nulla.

Passare dal livello L al successivo costa 5 × L² + 50 × L + 100 XP. Il costo cresce quindi a ogni scaglione, e viene conservato solo l'XP totale: il livello se ne deduce.

SogliaXP totaleCosto del livelloOrdine di grandezza
Livello 1 100 XP 100 XP ≈ 5 messaggi
Livello 2 255 XP 155 XP ≈ 13 messaggi
Livello 5 1150 XP 380 XP ≈ 58 messaggi
Livello 10 4675 XP 955 XP ≈ 234 messaggi
Livello 20 23.850 XP 2855 XP ≈ 1193 messaggi
Livello 50 268.375 XP 14.555 XP ≈ 13.419 messaggi

L'ultima colonna presuppone una conversazione normale, al guadagno medio. Dà l'ordine di grandezza, il tempo reale dipende da quanto sono distanziati i messaggi, dato che il contatore trattiene un solo guadagno al minuto.

A ogni passaggio di livello, il bot risponde nel canale dove il messaggio è stato scritto. L'annuncio si regola dalla dashboard: embed o testo semplice, titolo, descrizione, colore, e le variabili {level} e {xp} oltre a quelle abituali. Un canale in cui il bot non può scrivere non blocca nulla: il livello è acquisito, si perde solo l'annuncio.

Il modulo è attivo per impostazione predefinita. Spegnerlo ferma i guadagni e gli annunci senza cancellare nulla: la classifica resta nel database e riparte intatta alla riattivazione. Per correggere un caso particolare, /xp aggiunge, toglie o fissa l'XP di un membro; /rank e /leaderboard ne mostrano il risultato.

Sanzioni, cronologia e note

Ogni sanzione emessa dal bot viene registrata: ban, ban temporaneo, espulsione, silenziamento, avvertimento, e fino alle revoche (sban, ritiro di un avvertimento). Ciascuna riceve il suo codice di dodici caratteri.

L'ordine delle operazioni non è casuale. Il messaggio privato parte prima della sanzione, dopo un ban, il bot non ha più un server in comune con la persona e non potrebbe più scriverle. La registrazione, invece, precede la chiamata a Discord per disporre del codice; se Discord rifiuta l'azione, la registrazione viene annullata e nessuna sanzione fantasma resta nel fascicolo.

Un ban temporaneo programma la propria revoca. Alla scadenza, il bot verifica che il ban non sia stato rimesso nel frattempo da un moderatore: in tal caso non lo revoca. Un /ban definitivo emesso durante il periodo annulla la revoca programmata.

Le note (/note, 25 per sanzione) non vengono mai mostrate al membro interessato: servono al dialogo tra moderatori, mesi dopo, quando nessuno ricorda il contesto.

Protezione all'ingresso

Tre meccanismi indipendenti, che si sommano o si usano da soli:

  • Il captcha: all'arrivo, il membro deve risolvere una prova per ottenere il suo ruolo. Per impostazione predefinita: 3 tentativi, 5 minuti, espulsione in caso di errore. La richiesta passa per messaggio privato; se il membro ha chiuso i propri, il bot crea un canale di verifica temporaneo nella categoria che hai indicato, visibile solo a lui e poi eliminato.
  • La verifica tramite il sito: il membro clicca su un pulsante, termina sul sito e ritrova il suo ruolo al ritorno. Qui il bot non concede nulla da sé: è il sito a verificare l'identità presso Discord, e poi ad assegnare il ruolo.
  • L'anti-raid: non prende di mira l'individuo ma il flusso. Oltre 8 ingressi in 10 secondi (valori predefiniti), avvisa, mette in quarantena o espelle. Il filtro sull'età dell'account lascia passare gli abituali finiti nell'onda.

Il ruolo di quarantena è il punto in comune dei tre: assegnato all'arrivo, limita ciò che il nuovo arrivato può vedere e fare, e viene tolto una volta superata la verifica. Finché è lì, mantieni il controllo, nulla impedisce di sbloccare qualcuno a mano.

Ticket

Un pannello pubblicato in un canale, al massimo 25 tipi di richiesta (il limite di un menu a tendina di Discord), e per ciascuno: la sua emoji, il suo colore, il suo messaggio di benvenuto, il suo modulo di apertura e la squadra che vi ha accesso. L'apertura crea un canale privato tra chi chiede e quella squadra. Alla chiusura, la conversazione viene archiviata in HTML nel canale d'archivio, lo scambio resta consultabile anche dopo l'eliminazione del canale.

Musica e ruoli DJ

La riproduzione si appoggia a un'infrastruttura audio dedicata. Se non è disponibile, i comandi musicali lo dicono e tutto il resto del bot continua a funzionare.

I comandi che controllano una riproduzione in corso (/pause, /resume, /stop, /loop, /volume) sono riservati ai DJ. È DJ: il proprietario del server, un amministratore, un membro con «Gestire il server», o un membro che porta un ruolo aggiunto con /dj add. Finché non è configurato alcun ruolo DJ, questi comandi rispondono quindi solo a questi tre profili. I ruoli staff sono un elenco distinto: non concedono lo stato di DJ.

I comandi di sola consultazione (/queue, /nowplaying, /lyrics) e l'aggiunta di brani (/play) restano aperti a tutti.

Concorsi

Durata accettata: da 10 secondi a 28 giorni, scritta liberamente (30m, 1h30m, 2d). Fino a 20 concorsi in corso e 20 vincitori per estrazione.

L'estrazione è sempre effettuata dal bot, mai dal sito: solo lui può verificare, al momento dell'estrazione, che i vincitori siano ancora sul server e portino il ruolo richiesto all'iscrizione. Se nessuno si fa vivo, /giveaway reroll estrae di nuovo.

Registrazione

21 tipi di eventi, ripartiti in 5 categorie (Messaggi, Membri, Moderazione, Vocale, Server), attivabili uno per uno. Ogni categoria può puntare al proprio canale: la moderazione da una parte, i messaggi dall'altra.

Il contenuto dei messaggi non è mai memorizzato nel database. Quando un messaggio viene eliminato, il bot pubblica un embed nel canale che hai indicato, è tutto quello che succede. Un'azione compiuta dal bot stesso (un ban tramite /ban) viene registrata una sola volta, dal log di moderazione che nomina il moderatore.

Backup

Un backup fotografa la struttura del server (ruoli, canali, permessi) e restituisce un codice privato, inviato per messaggio privato. Si conservano 3 backup per proprietario. Non contiene nessun messaggio: non è una cronologia di conversazione. Il codice permette di ripristinare quella struttura nel server corrente, e quindi anche di clonare un server importandolo altrove.

Canali vocali temporanei

Entrare nel canale d'innesco crea un canale di cui il membro è proprietario: può rinominarlo, limitarne l'accesso o fissarne la capienza. Il canale sparisce appena si svuota, nessuna pulizia da fare.

Moderazione

Sanzionare, lasciare traccia, tornare indietro. Ogni sanzione comminata da uno di questi comandi riceve un codice pubblico e finisce nello storico del membro.

16 comandi

/ban

Banna membri Staff livello 2 3 s Bot: Banna membri

Banna un membro dal server.

Ban definitivo. Il membro viene rimosso dal server e non può rientrarvi finché non viene sbannato.

/ban <utente> [motivo] [mp] [visibilità]

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
motivo testo facoltativa Il motivo di questa azione.400 caratteri al massimo
mp testo facoltativa Inviare un MP all'utente (predefinito: sì).Scelte: ✅ Sì, ❌ No
visibilità testo facoltativa Rendere la conferma visibile a tutti (predefinito: no).Scelte: ✅ Sì, ❌ No
  • Il messaggio privato parte prima del ban: una volta bannato, il bot non ha più un server in comune con il membro e non potrebbe più contattarlo.
  • La sanzione viene registrata prima della chiamata a Discord. Se il ban fallisce (gerarchia dei ruoli, permesso mancante), la registrazione viene annullata: nessuna sanzione fantasma resta nella cronologia.
  • Un ban definitivo annulla lo sban automatico eventualmente programmato da /tempban.
  • Non puoi bannare né te stesso, né il bot, né un membro il cui ruolo più alto è superiore o pari al tuo.

Esempi

/ban utente:@kylian_ motivo:Pubblicità ripetuta

Ban motivato, MP inviato, conferma privata.

/ban utente:@kylian_ mp:❌ No visibilità:✅ Sì

Senza avvisare il membro, ma con una conferma visibile nel canale.

/tempban

Banna membri Staff livello 2 3 s Bot: Banna membri

Banna temporaneamente un membro (sbannato in automatico alla scadenza)

Ban a durata determinata. Lo sban è programmato ed eseguito dal bot alla scadenza.

/tempban <utente> <durata> [motivo] [mp] [visibilità]

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
durata testo obbligatoria La durata del timeout.Scelte: 60 secondi, 5 minuti, 10 minuti, 30 minuti, 1 ora, 3 ore, 12 ore, 1 giorno, 3 giorni, 1 settimana, 28 giorni
motivo testo facoltativa Il motivo di questa azione.400 caratteri al massimo
mp testo facoltativa Inviare un MP all'utente (predefinito: sì).Scelte: ✅ Sì, ❌ No
visibilità testo facoltativa Rendere la conferma visibile a tutti (predefinito: no).Scelte: ✅ Sì, ❌ No
  • Alla scadenza, il bot verifica che il ban non sia stato rimesso nel frattempo da un moderatore: in tal caso non lo revoca.
  • Un /ban emesso durante il periodo annulla lo sban automatico.

Esempi

/tempban utente:@kylian_ durata:1 settimana motivo:Spam

Reintegro automatico fra una settimana.

/unban

Banna membri Staff livello 3 3 s Bot: Banna membri

Sbanna un utente tramite il suo identificativo.

Revoca un ban. Poiché la persona non è più sul server, la si indica con il suo ID Discord.

/unban <id>

OpzioneTipoRichiestaDescrizione
id testo obbligatoria L'ID Discord dell'utente bannato da sbannare.20 caratteri al massimo
  • L'ID si copia dall'elenco dei bannati di Discord (Impostazioni del server → Bannati), con la modalità sviluppatore attiva.
  • È l'unico comando di moderazione il cui livello staff predefinito è 3.

Esempi

/unban id:428917364520394752

/kick

Espelli membri Staff livello 2 3 s Bot: Espelli membri

Espelle un membro dal server.

Espelle un membro. Nulla gli impedisce di tornare con un nuovo invito.

/kick <utente> [motivo] [mp] [visibilità]

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
motivo testo facoltativa Il motivo di questa azione.400 caratteri al massimo
mp testo facoltativa Inviare un MP all'utente (predefinito: sì).Scelte: ✅ Sì, ❌ No
visibilità testo facoltativa Rendere la conferma visibile a tutti (predefinito: no).Scelte: ✅ Sì, ❌ No
  • Il messaggio privato parte prima dell'espulsione, per la stessa ragione di /ban.

Esempi

/kick utente:@marin motivo:Provocazione in vocale

/timeout

Modera membri Staff livello 1 3 s Bot: Modera membri

Silenzia temporaneamente un membro.

Silenziamento temporaneo nativo di Discord: il membro resta sul server ma non può più scrivere, reagire né parlare in vocale.

/timeout <utente> <durata> [motivo] [mp] [visibilità]

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
durata testo obbligatoria La durata del timeout.Scelte: 60 secondi, 5 minuti, 10 minuti, 30 minuti, 1 ora, 3 ore, 12 ore, 1 giorno, 3 giorni, 1 settimana, 28 giorni
motivo testo facoltativa Il motivo di questa azione.400 caratteri al massimo
mp testo facoltativa Inviare un MP all'utente (predefinito: sì).Scelte: ✅ Sì, ❌ No
visibilità testo facoltativa Rendere la conferma visibile a tutti (predefinito: no).Scelte: ✅ Sì, ❌ No
  • La durata massima è di 28 giorni: è un limite di Discord, non del bot.
  • Il silenziamento si revoca da solo alla scadenza, senza intervento del bot.

Esempi

/timeout utente:@marin durata:1 ora motivo:Insulti

/warn

Modera membri Staff livello 1 3 s

Avverte un membro.

Avvertimento registrato. Non viene applicata alcuna sanzione tecnica: è una traccia, consultabile in seguito.

/warn <utente> [motivo] [mp] [visibilità]

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
motivo testo facoltativa Il motivo di questa azione.400 caratteri al massimo
mp testo facoltativa Inviare un MP all'utente (predefinito: sì).Scelte: ✅ Sì, ❌ No
visibilità testo facoltativa Rendere la conferma visibile a tutti (predefinito: no).Scelte: ✅ Sì, ❌ No
  • L'avvertimento riceve un codice di sanzione come qualsiasi altra voce: si ritrova con /history o /sanction, e si revoca con /unwarn.

Esempi

/warn utente:@marin motivo:Secondo richiamo sul linguaggio

/unwarn

Modera membri Staff livello 2 3 s

Revoca un avvertimento tramite il suo codice

Revoca un avvertimento preciso a partire dal suo codice.

/unwarn <id>

OpzioneTipoRichiestaDescrizione
id testo obbligatoria L'identificativo della sanzione (es. K7Q2M9XA).16 caratteri al massimo
  • La revoca non fa sparire la voce dalla cronologia: la segna come revocata.

Esempi

/unwarn id:K7Q2M9XAP4RN

/history

Modera membri Staff livello 1 3 s

Mostra tutte le sanzioni di un membro.

Fascicolo completo di un membro: tutte le sue sanzioni, dalla più recente alla più antica.

/history <utente>

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
  • L'elenco si scorre pagina per pagina con i pulsanti del messaggio; ogni voce mostra il suo codice, il suo tipo, il suo motivo e il suo autore.

Esempi

/history utente:@kylian_

/sanction

Modera membri Staff livello 1 3 s

Mostra i dettagli di una sanzione tramite il suo identificativo.

Scheda dettagliata di una sanzione: tipo, motivo, moderatore, data, note interne allegate.

/sanction <id>

OpzioneTipoRichiestaDescrizione
id testo obbligatoria L'identificativo della sanzione (es. K7Q2M9XA).16 caratteri al massimo

Esempi

/sanction id:K7Q2M9XAP4RN

/note

Modera membri Staff livello 1 3 s

Gestisce le note associate a una sanzione.

Note interne allegate a una sanzione. Non vengono mai mostrate al membro interessato: servono al dialogo tra moderatori.

/note add <id> <testo>

Aggiunge una nota a una sanzione.

OpzioneTipoRichiestaDescrizione
id testo obbligatoria L'identificativo della sanzione (es. K7Q2M9XA).16 caratteri al massimo
testo testo obbligatoria Il contenuto della nota.1000 caratteri al massimo

/note list <id>

Mostra le note di una sanzione.

OpzioneTipoRichiestaDescrizione
id testo obbligatoria L'identificativo della sanzione (es. K7Q2M9XA).16 caratteri al massimo

/note remove <id> <numero>

Rimuove una nota da una sanzione.

OpzioneTipoRichiestaDescrizione
id testo obbligatoria L'identificativo della sanzione (es. K7Q2M9XA).16 caratteri al massimo
numero numero intero obbligatoria La posizione della nota nell'elenco (vedi /note list).Minimo 1
  • Fino a 25 note per sanzione. Oltre, la scheda supererebbe la dimensione massima di un messaggio Discord.

Esempi

/note add id:K7Q2M9XAP4RN testo:Ha ammesso i fatti in MP

/note remove id:K7Q2M9XAP4RN numero:2

Il numero è la posizione mostrata da /note list.

/clear

Gestisci messaggi Staff livello 1 3 s Bot: Gestisci messaggi

Elimina un certo numero di messaggi.

Elimina in una sola volta gli ultimi messaggi di un canale.

/clear <numero>

OpzioneTipoRichiestaDescrizione
numero numero intero obbligatoria Numero di messaggi da eliminare (1-100).Da 1 a 100
  • Discord rifiuta l'eliminazione in blocco dei messaggi più vecchi di 14 giorni: quelli vengono ignorati, e il bot annuncia quanti ne ha eliminati davvero.
  • L'eliminazione è attribuita al moderatore nei log, e non all'autore dei messaggi.

Esempi

/clear numero:50

/slowmode

Gestire i canali Staff livello 1 3 s Bot: Gestire i canali

Imposta la modalità lenta di un canale.

Impone un intervallo minimo tra due messaggi di uno stesso membro.

/slowmode <seconds> [channel]

OpzioneTipoRichiestaDescrizione
seconds numero intero obbligatoria Ritardo della modalità lenta in secondi (0 = disattiva).Da 0 a 21600
channel canale facoltativa Canale di destinazione (predefinito: canale attuale).Tipo: canale testuale, canale annunci
  • 0 disattiva la modalità lenta. Il massimo, 21 600 secondi, corrisponde alle 6 ore consentite da Discord.

Esempi

/slowmode seconds:30

Sul canale corrente.

/slowmode seconds:0 channel:#generale

Ritorno alla normalità su un altro canale.

/lock

Gestire i canali Staff livello 2 3 s Bot: Gestire i canali

Blocca un canale (i membri non possono scrivere).

Toglie al ruolo @everyone il diritto di scrivere nel canale. I messaggi restano leggibili.

/lock [channel] [motivo]

OpzioneTipoRichiestaDescrizione
channel canale facoltativa Canale di destinazione (predefinito: canale attuale).Tipo: canale testuale, canale annunci
motivo testo facoltativa Il motivo di questa azione.400 caratteri al massimo

Esempi

/lock motivo:Dibattito che degenera, si riprende domani

/unlock

Gestire i canali Staff livello 2 3 s Bot: Gestire i canali

Sblocca un canale precedentemente bloccato.

Ridà la parola al canale bloccato.

/unlock [channel] [motivo]

OpzioneTipoRichiestaDescrizione
channel canale facoltativa Canale di destinazione (predefinito: canale attuale).Tipo: canale testuale, canale annunci
motivo testo facoltativa Il motivo di questa azione.400 caratteri al massimo

Esempi

/unlock channel:#generale

/role

Gestire i ruoli Staff livello 2 3 s Bot: Gestire i ruoli

Aggiunge o rimuove un ruolo a un membro.

Aggiunge o toglie un ruolo senza passare dalle impostazioni del server.

/role add <utente> <role>

Aggiunge un ruolo a un membro.

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
role ruolo obbligatoria Il ruolo da aggiungere o rimuovere.

/role remove <utente> <role>

Rimuove un ruolo a un membro.

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
role ruolo obbligatoria Il ruolo da aggiungere o rimuovere.
  • Il bot può manipolare solo i ruoli che stanno sotto al suo nella gerarchia.
  • Non distribuisci mai un ruolo che sta sopra al tuo. E se passi da un livello staff invece che dal permesso «Gestire i ruoli», i ruoli con un permesso sensibile (Amministratore, Gestire i ruoli, Bandire membri...) vengono rifiutati: una deroga non vale mai più del permesso che sostituisce.

Esempi

/role add utente:@sofia role:@Membro confermato

/massmove

Sposta membri Staff livello 2 5 s Bot: Sposta membri

Sposta tutti da un canale vocale a un altro.

Sposta in una volta sola tutti i membri presenti in un canale vocale.

/massmove <origine> <destinazione> [visibilità]

OpzioneTipoRichiestaDescrizione
origine canale obbligatoria Il canale vocale da cui spostare tutti.Tipo: canale vocale, canale conferenza
destinazione canale obbligatoria Il canale vocale verso cui spostare tutti.Tipo: canale vocale, canale conferenza
visibilità testo facoltativa Rendere la conferma visibile a tutti (predefinito: no).Scelte: ✅ Sì, ❌ No
  • Utile per radunare un evento, o per svuotare un canale vocale senza disconnettere nessuno.

Esempi

/massmove origine:Sala 1 destinazione:Palco

Configurazione

I moduli del server. Sono tutti spenti di default, e tutto ciò che si regola qui si regola anche dalla dashboard. È lo stesso database.

15 comandi

/welcome

Gestisci server 3 s Bot: Visualizza canali, Invia messaggi, Incorpora link

Configura i messaggi di benvenuto e di addio

Apre un pannello interattivo: messaggio di benvenuto, messaggio di addio, canali, banner generato e colori si regolano lì, senza sottocomandi da ricordare.

/welcome

  • Variabili disponibili nei testi: {user}, {username}, {displayname}, {tag}, {id}, {server}, {membercount}.
  • Il messaggio di addio è indipendente da quello di benvenuto: canale diverso, attivazione diversa.
  • Per ogni arrivo viene generato un banner, con i colori scelti per il server.

/logs

Gestisci server 3 s Bot: Visualizza canali, Invia messaggi, Incorpora link

Configura e personalizza il sistema di log del server.

Pannello di configurazione della registrazione: 21 tipi di eventi, attivabili uno per uno.

/logs setup

Apre il pannello di configurazione dei log.

/logs disable

Disattiva i log e cancella la configurazione.

  • Gli eventi sono ripartiti in 5 categorie: Messaggi, Membri, Moderazione, Vocale, Server.
  • Ogni categoria può puntare al proprio canale: la moderazione da una parte, i messaggi dall'altra.
  • Il contenuto dei messaggi non è mai memorizzato nel database: compare nell'embed pubblicato, nulla di più.
  • /logs disable cancella la configurazione, non si limita a metterla in pausa.

/ticket

Gestisci server 3 s Bot: Gestire i canali

Configura e personalizza il sistema di ticket.

Pannello di configurazione del sistema di ticket: tipi, moduli, squadre, trascrizioni.

/ticket setup

Apre il pannello di configurazione dei ticket.

/ticket disable

Disattiva il sistema di ticket e rimuove il pannello.

  • Fino a 25 tipi di ticket, il limite di un menu a tendina di Discord. Ognuno ha la sua emoji, il suo colore, il suo messaggio di benvenuto e il suo modulo di apertura.
  • Alla chiusura, la conversazione viene archiviata in HTML nel canale d'archivio scelto.

/verify

Gestisci server 3 s Bot: Gestire i ruoli

Configura la verifica tramite il sito (pulsante + ruolo).

Verifica tramite il sito: il membro clicca su un pulsante in Discord, termina su omniaze.com e riceve il suo ruolo al ritorno.

/verify enable <role> [quarantine] [log]

Attiva la verifica e sceglie il ruolo assegnato dopo.

OpzioneTipoRichiestaDescrizione
role ruolo obbligatoria Il ruolo assegnato quando il membro si verifica sul sito.
quarantine ruolo facoltativa Ruolo rimosso dopo la verifica (facoltativo).
log canale facoltativa Canale in cui registrare ogni verifica riuscita (facoltativo).Tipo: canale testuale, canale annunci

/verify panel [channel]

Pubblica (o aggiorna) il pannello di verifica e il suo pulsante.

OpzioneTipoRichiestaDescrizione
channel canale facoltativa Canale in cui pubblicare il pannello di verifica.Tipo: canale testuale, canale annunci

/verify disable

Disattiva la verifica tramite il sito su questo server.

/verify status

Mostra la configurazione attuale della verifica.

  • Il ruolo di quarantena è facoltativo: senza, la verifica si limita ad aggiungere un ruolo; con, fa anche uscire il membro dall'anticamera.
  • /verify panel ripubblica il pannello se il messaggio è stato eliminato, o lo aggiorna dopo una modifica del testo.

Esempi

/verify enable role:@Membro quarantine:@Non verificato log:#arrivi

/verify panel channel:#verifica

/captcha

Gestisci server 3 s Bot: Gestire i ruoli, Gestire i canali

Configura il captcha che verifica i nuovi membri.

Verifica all'ingresso: il nuovo arrivato deve risolvere un captcha per ottenere il suo ruolo.

/captcha enable <ruolo> <categoria> [quarantena]

Attiva il captcha e sceglie il ruolo di verifica.

OpzioneTipoRichiestaDescrizione
ruolo ruolo obbligatoria Il ruolo assegnato ai membri dopo aver superato il captcha.
categoria canale obbligatoria Categoria in cui creare i canali di verifica temporanei (MP chiusi).Tipo: categoria
quarantena ruolo facoltativa Ruolo restrittivo assegnato all'ingresso e rimosso una volta verificato il membro.

/captcha disable

Disattiva il captcha su questo server.

/captcha status

Mostra la configurazione attuale del captcha.

  • La categoria è obbligatoria: se il membro ha chiuso i suoi messaggi privati, il bot vi crea un canale di verifica temporaneo, visibile solo a lui e poi eliminato.
  • Impostazioni predefinite: 3 tentativi, 5 minuti per rispondere, espulsione in caso di errore. Il tempo, il numero di tentativi e la sanzione si modificano dalla dashboard.
  • Finché la verifica non è superata, il membro resta nel ruolo di quarantena: mantieni la possibilità di sbloccarlo a mano.

Esempi

/captcha enable ruolo:@Membro categoria:Verifica quarantena:@Nuovo arrivato

/antiraid

Gestisci server 3 s

Configura la protezione anti-raid.

Rilevamento di un'ondata di ingressi anomala, e reazione automatica.

/antiraid enable [threshold] [window] [action] [channel] [quarantena] [creazione-auto]

Attiva l'anti-raid e regola le sue soglie.

OpzioneTipoRichiestaDescrizione
threshold numero intero facoltativa Numero di ingressi che attiva l'allerta.Da 2 a 50
window numero intero facoltativa Finestra di rilevamento in secondi.Da 3 a 120
action testo facoltativa Cosa fare con i nuovi membri durante un raid.Scelte: Solo allerta, Quarantena, Espelli
channel canale facoltativa Canale dove inviare le allerte di raid.Tipo: canale testuale, canale annunci
quarantena ruolo facoltativa Ruolo restrittivo applicato a chi entra durante un raid.
creazione-auto sì / no facoltativa Creare il ruolo di quarantena se non ne esiste ancora uno.

/antiraid disable

Disattiva la protezione anti-raid.

/antiraid status

Mostra la configurazione anti-raid attuale.

  • Per impostazione predefinita: 8 ingressi in 10 secondi attivano la protezione, e i nuovi arrivati vengono messi in quarantena.
  • Tre reazioni possibili: solo avvisare, mettere in quarantena, o espellere.
  • L'età dell'account può servire da filtro (168 ore per impostazione predefinita): gli account vecchi attraversano l'ondata senza essere toccati. Questa impostazione si fa dalla dashboard.

Esempi

/antiraid enable threshold:10 window:15 action:Quarantena channel:#avvisi

/reactionrole

Gestisci server 3 s Bot: Gestire i ruoli

Crea pulsanti di ruolo auto-assegnabili.

Pannelli di ruoli self-service: un messaggio, dei pulsanti, un ruolo per pulsante.

/reactionrole create <channel> [title] [description] [mode] [color]

Crea un nuovo pannello di ruoli reazione.

OpzioneTipoRichiestaDescrizione
channel canale obbligatoria Canale in cui pubblicare il pannello.Tipo: canale testuale, canale annunci
title testo facoltativa Titolo del pannello.256 caratteri al massimo
description testo facoltativa Descrizione del pannello.2000 caratteri al massimo
mode testo facoltativa Cumulativo (più ruoli) o unico (un ruolo per volta).Scelte: Cumulativo, Unico
color testo facoltativa Colore dell'embed (hex, es. #5865F2).7 caratteri al massimo

/reactionrole addrole <panel> <role> [label] [emoji]

Aggiunge un pulsante di ruolo a un pannello.

OpzioneTipoRichiestaDescrizione
panel testo obbligatoria Quale pannello (scegli dalla lista).
role ruolo obbligatoria Il ruolo assegnato dal pulsante.
label testo facoltativa Etichetta del pulsante (predefinito: nome del ruolo).80 caratteri al massimo
emoji testo facoltativa Emoji del pulsante (facoltativa).40 caratteri al massimo

/reactionrole removerole <panel> <role>

Rimuove un pulsante di ruolo da un pannello.

OpzioneTipoRichiestaDescrizione
panel testo obbligatoria Quale pannello (scegli dalla lista).
role ruolo obbligatoria Il ruolo assegnato dal pulsante.

/reactionrole delete <panel>

Elimina un pannello di ruoli reazione.

OpzioneTipoRichiestaDescrizione
panel testo obbligatoria Quale pannello (scegli dalla lista).

/reactionrole list

Elenca i pannelli di ruoli reazione.

  • Fino a 25 pannelli per server e 25 ruoli per pannello.
  • Modalità Cumulativo: il membro prende e restituisce i ruoli che vuole. Modalità Unico: un solo ruolo del pannello alla volta, il precedente viene tolto automaticamente.
  • Il pannello si costruisce in due tempi: create per il messaggio, poi un addrole per pulsante.

Esempi

/reactionrole create channel:#ruoli title:Le tue notifiche mode:Cumulativo

/reactionrole addrole panel:Le tue notifiche role:@Annunci emoji:📣

/tempvoice

Gestisci server 3 s Bot: Gestire i canali, Gestire i ruoli, Sposta membri

Configura i canali vocali temporanei (unisciti per creare).

Canali vocali su richiesta: entrare nel canale d'innesco crea un canale di cui il membro è proprietario.

/tempvoice enable <canale> <categoria>

Attiva i canali temporanei e sceglie il canale attivatore.

OpzioneTipoRichiestaDescrizione
canale canale obbligatoria Il canale vocale che crea un canale temporaneo quando lo si unisce.Tipo: canale vocale
categoria canale obbligatoria Categoria in cui vengono creati i canali vocali temporanei.Tipo: categoria

/tempvoice disable

Disattiva i canali vocali temporanei su questo server.

/tempvoice status

Mostra la configurazione attuale dei canali temporanei.

  • Il canale temporaneo viene eliminato appena si svuota: nessuna traccia, nessuna pulizia da fare.
  • Il suo proprietario può rinominarlo, limitarne l'accesso o fissarne la capienza.

Esempi

/tempvoice enable canale:➕ Crea un canale categoria:Vocali

/giveaway

Gestisci server 3 s

Crea e gestisci giveaway (concorsi).

Concorso con estrazione automatica alla scadenza.

/giveaway start <premio> <durata> [vincitori] [canale] [ruolo]

Avvia un nuovo giveaway.

OpzioneTipoRichiestaDescrizione
premio testo obbligatoria Ciò che viene messo in palio.256 caratteri al massimo
durata testo obbligatoria Durata del giveaway (es. 1h, 30m, 2d).50 caratteri al massimo
vincitori numero intero facoltativa Quanti vincitori estrarre (predefinito: 1).Da 1 a 20
canale canale facoltativa Canale in cui pubblicare il giveaway (predefinito: canale attuale).Tipo: canale testuale, canale annunci
ruolo ruolo facoltativa Limita la partecipazione ai membri con questo ruolo.

/giveaway end <concorso>

Termina subito un giveaway ed estrai i vincitori.

OpzioneTipoRichiestaDescrizione
concorso testo obbligatoria Quale giveaway (scegli dalla lista).

/giveaway reroll <concorso>

Estrai nuovi vincitori per un giveaway concluso.

OpzioneTipoRichiestaDescrizione
concorso testo obbligatoria Quale giveaway (scegli dalla lista).

/giveaway cancel <concorso>

Annulla un giveaway senza estrarre un vincitore.

OpzioneTipoRichiestaDescrizione
concorso testo obbligatoria Quale giveaway (scegli dalla lista).

/giveaway list

Elenca i giveaway attivi di questo server.

  • Durata accettata: da 10 secondi a 28 giorni. Formato libero: 30m, 2h, 1h30m, 3d.
  • Fino a 20 concorsi in corso per server, e 20 vincitori per estrazione.
  • reroll estrae un nuovo vincitore a posteriori, se il primo non si fa vivo.

Esempi

/giveaway start premio:Un mese di Nitro durata:2d vincitori:3 canale:#concorsi

/giveaway start premio:Chiave di gioco durata:1h30m ruolo:@Booster

Partecipazione riservata ai booster.

/xp

Gestisci server 3 s

Gestisce l'XP dei membri.

Regolazione manuale dell'esperienza di un membro, senza toccare il resto della classifica.

/xp give <utente> <quantità>

Dà XP a un membro.

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
quantità numero intero obbligatoria Quantità di XP.Da 1 a 10000000

/xp remove <utente> <quantità>

Rimuove XP a un membro.

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
quantità numero intero obbligatoria Quantità di XP.Da 1 a 10000000

/xp set <utente> <quantità>

Imposta l'XP di un membro a un valore esatto.

OpzioneTipoRichiestaDescrizione
utente membro obbligatoria L'utente preso di mira.
quantità numero intero obbligatoria Quantità di XP.Da 0 a 10000000
  • give e remove lavorano in relativo, set in assoluto.
  • Il passaggio di livello che deriva dalla regolazione viene annunciato come qualsiasi altro.

Esempi

/xp give utente:@sofia quantità:500

/live

Gestisci server 3 s

Annuncia automaticamente le dirette Twitch e YouTube.

/live enable <channel> [mention]

Attiva gli annunci e sceglie il canale in cui pubblicarli.

OpzioneTipoRichiestaDescrizione
channel canale obbligatoria Il canale in cui vengono pubblicati gli annunci.Tipo: canale testuale, canale annunci
mention ruolo facoltativa Ruolo notificato a ogni annuncio (@everyone è accettato).

/live add <platform> <streamer> [channel]

Segue un canale Twitch o YouTube.

OpzioneTipoRichiestaDescrizione
platform testo obbligatoria La piattaforma del canale.Scelte: Twitch, YouTube
streamer testo obbligatoria Nome del canale, il suo @nome o l'indirizzo della pagina.200 caratteri al massimo
channel canale facoltativa Il canale in cui vengono pubblicati gli annunci.Tipo: canale testuale, canale annunci

/live remove <platform> <streamer>

Smette di seguire un canale.

OpzioneTipoRichiestaDescrizione
platform testo obbligatoria La piattaforma del canale.Scelte: Twitch, YouTube
streamer testo obbligatoria Nome del canale, il suo @nome o l'indirizzo della pagina.200 caratteri al massimo

/live list

Mostra i canali seguiti su questo server.

/live disable

Disattiva gli annunci delle dirette su questo server.

/live status

Mostra la configurazione attuale degli annunci.

/staff

Gestisci server 3 s

Gestisce i ruoli staff autorizzati a usare la moderazione.

Cuore del controllo degli accessi: tre livelli staff associati a ruoli del tuo server, e un livello minimo per comando di moderazione.

/staff manage

Apre un pannello interattivo per configurare i ruoli dello staff e il livello dei comandi.

/staff clear

Rimuove tutti i ruoli staff.

/staff command <command> <level>

Imposta il livello dello staff richiesto per usare un comando di moderazione.

OpzioneTipoRichiestaDescrizione
command testo obbligatoria Il comando di moderazione da configurare.Scelte: clear, timeout, warn, history, sanction, note, slowmode, clearqueue, kick, ban, tempban, massmove, unwarn, lock, unlock, role, unban
level numero intero obbligatoria Livello dello staff (da 1 a 3).Scelte: Livello 1, Livello 2, Livello 3

/staff levels

Mostra il livello dello staff richiesto per ogni comando di moderazione.

  • Un membro che dispone del permesso Discord nativo passa comunque: i livelli staff aprono l'accesso, non lo chiudono mai.
  • /staff manage apre il pannello completo; i sottocomandi coprono i gesti rapidi.
  • Il livello valido per un membro è quello del suo ruolo staff più alto.

Esempi

/staff command command:ban level:Livello 3

Riserva /ban ai moderatori di livello 3.

/staff levels

Tabella dei livelli in vigore sul server.

/dj

Gestisci server 3 s

Gestisce i ruoli DJ autorizzati a controllare la musica.

Ruoli autorizzati a controllare la riproduzione in corso.

/dj add <role> [role-2] [role-3] [role-4] [role-5]

Aggiunge uno o più ruoli DJ.

OpzioneTipoRichiestaDescrizione
role ruolo obbligatoria Il ruolo da definire come ruolo DJ.
role-2 ruolo facoltativa Un ruolo DJ aggiuntivo.
role-3 ruolo facoltativa Un ruolo DJ aggiuntivo.
role-4 ruolo facoltativa Un ruolo DJ aggiuntivo.
role-5 ruolo facoltativa Un ruolo DJ aggiuntivo.

/dj remove <role> [role-2] [role-3] [role-4] [role-5]

Rimuove uno o più ruoli DJ.

OpzioneTipoRichiestaDescrizione
role ruolo obbligatoria Il ruolo da definire come ruolo DJ.
role-2 ruolo facoltativa Un ruolo DJ aggiuntivo.
role-3 ruolo facoltativa Un ruolo DJ aggiuntivo.
role-4 ruolo facoltativa Un ruolo DJ aggiuntivo.
role-5 ruolo facoltativa Un ruolo DJ aggiuntivo.

/dj list

Mostra i ruoli DJ configurati.

/dj clear

Rimuove tutti i ruoli DJ.

  • È DJ: il proprietario del server, un amministratore, un membro con «Gestire il server», o un membro che porta uno dei ruoli aggiunti qui.
  • Senza alcun ruolo DJ configurato, i comandi riservati ai DJ rispondono quindi solo a questi tre profili. Non per questo sono aperti a tutti.
  • I ruoli staff (/staff) sono un elenco distinto: non concedono lo stato di DJ.

Esempi

/dj add role:@DJ role-2:@Moderatore

/lingua

Gestisci server 3 s

Cambia la lingua del bot per questo server.

Lingua del bot per tutto il server: embed, menu, errori, ma anche nomi e descrizioni dei comandi.

/lingua <lingua>

OpzioneTipoRichiestaDescrizione
lingua testo obbligatoria La lingua da utilizzare.
  • Tredici lingue complete. Il cambiamento si applica nel giro di un secondo, senza riavvio.
  • La lingua di un singolo membro non entra in gioco: è un'impostazione del server.

Esempi

/lingua lingua:Italiano

/backup

Amministratore 10 s

Salva e ripristina la struttura del tuo server.

Fotografa la struttura del server (ruoli, canali, permessi) e la ripristina più tardi.

/backup create

Salva la struttura di questo server (ruoli, canali, permessi).

/backup import <code>

Ripristina uno dei tuoi backup in questo server.

OpzioneTipoRichiestaDescrizione
code testo obbligatoria Il codice del backup (inviato in MP).16 caratteri al massimo

/backup list

Elenca i tuoi backup del server e i loro codici.

/backup delete <code>

Elimina uno dei tuoi backup del server.

OpzioneTipoRichiestaDescrizione
code testo obbligatoria Il codice del backup (inviato in MP).16 caratteri al massimo
  • 3 backup conservati per proprietario. Oltre, eliminane uno con delete.
  • Il codice viene inviato per messaggio privato: è quello che permette il ripristino, non deve circolare in un canale.
  • Un backup non contiene nessun messaggio: non è una cronologia di conversazione.
  • Il ripristino ricrea la struttura nel server corrente, puoi quindi clonare un server importando il codice altrove.

Esempi

/backup create

Il codice arriva in MP.

/backup import code:M9XAP4RNK7

Community

Aperti a tutti i membri, senza alcun permesso particolare.

9 comandi

/help

Aperto a tutti MP 5 s

Elenca tutti i comandi disponibili.

Menu interattivo di tutti i comandi disponibili, filtrato in base a ciò che hai il diritto di usare.

/help

  • Utilizzabile in messaggio privato.

/rank

Aperto a tutti 5 s

Mostra il livello e la scheda di rango di un membro.

Scheda di rango generata al volo: livello, XP accumulato, posizione nella classifica del server.

/rank [user]

OpzioneTipoRichiestaDescrizione
user membro facoltativa L'utente preso di mira.

Esempi

/rank user:@sofia

Senza opzione, il comando mostra la tua scheda.

/leaderboard

Aperto a tutti 5 s

Mostra la classifica XP del server.

Classifica del server per esperienza, pagina per pagina.

/leaderboard

/userinfo

Aperto a tutti 3 s

Mostra informazioni su un utente.

Scheda di un membro: ingresso nel server, creazione dell'account, ruoli, ID.

/userinfo [user]

OpzioneTipoRichiestaDescrizione
user membro facoltativa L'utente preso di mira.

/serverinfo

Aperto a tutti 5 s

Mostra informazioni su questo server.

Scheda del server: membri, canali, ruoli, livello di boost, data di creazione.

/serverinfo

/avatar

Aperto a tutti MP 3 s

Mostra l'avatar di un utente.

Mostra l'avatar in grande, con i link di download.

/avatar [user]

OpzioneTipoRichiestaDescrizione
user membro facoltativa L'utente preso di mira.
  • Utilizzabile in messaggio privato.

/ping

Aperto a tutti MP 3 s

Mostra la latenza del bot.

Latenza del gateway Discord e tempo di risposta del bot.

/ping

  • Utilizzabile in messaggio privato.

/hug

Aperto a tutti 3 s

Abbraccia qualcuno.

Comando di atmosfera, senza effetto sulla configurazione.

/hug <user>

OpzioneTipoRichiestaDescrizione
user membro obbligatoria L'utente preso di mira.

/slap

Aperto a tutti 3 s

Schiaffeggia qualcuno (solo per divertimento).

Comando di atmosfera, senza effetto sulla configurazione.

/slap <user>

OpzioneTipoRichiestaDescrizione
user membro obbligatoria L'utente preso di mira.

Musica

Il modulo musica si appoggia a un'infrastruttura audio dedicata. Se non è disponibile, questi comandi rispondono «servizio non disponibile» e il resto del bot continua a funzionare normalmente.

11 comandi

/play

Aperto a tutti 2 s Bot: Connetti, Parla

Riproduce un brano o lo aggiunge alla coda.

Lancia una ricerca o prende un link, e accoda il risultato nella lista d'attesa.

/play <query> [source]

OpzioneTipoRichiestaDescrizione
query testo obbligatoria Nome del brano o link.
source testo facoltativa Piattaforma di ricerca (predefinito: YouTube).Scelte: YouTube, Spotify
  • Devi essere connesso a un canale vocale; il bot ti raggiunge lì.
  • Un link a una playlist aggiunge tutti i suoi brani in una volta.
  • La riproduzione si appoggia a un'infrastruttura audio dedicata: se non è disponibile, il comando lo dice e nient'altro ne risente.

Esempi

/play query:daft punk one more time

/play query:https://open.spotify.com/track/... source:Spotify

/skip

Aperto a tutti 2 s

Salta il brano corrente.

Passa al brano successivo della coda.

/skip

/pause

Riservato ai DJ 2 s

Mette in pausa il brano corrente.

Sospende la riproduzione mantenendo il punto esatto.

/pause

  • Riservato ai DJ: il proprietario del server, un amministratore, un membro con «Gestire il server», o chi possiede un ruolo aggiunto con /dj add. Vedi /dj.

/resume

Riservato ai DJ 2 s

Riprende la riproduzione.

Riprende una riproduzione sospesa.

/resume

  • Riservato ai DJ: il proprietario del server, un amministratore, un membro con «Gestire il server», o chi possiede un ruolo aggiunto con /dj add. Vedi /dj.

/stop

Riservato ai DJ 2 s

Ferma la musica e svuota la coda.

Ferma la riproduzione, svuota la coda e libera il canale vocale.

/stop

  • Riservato ai DJ: il proprietario del server, un amministratore, un membro con «Gestire il server», o chi possiede un ruolo aggiunto con /dj add. Vedi /dj.

/queue

Aperto a tutti 3 s

Mostra la coda attuale.

Coda d'attesa completa, pagina per pagina, con la durata cumulata.

/queue

/nowplaying

Aperto a tutti 3 s

Mostra il brano attualmente in riproduzione.

Brano in corso, con la sua barra di avanzamento.

/nowplaying

/loop

Riservato ai DJ 2 s

Imposta la modalità di ripetizione.

Ripetizione del brano corrente, di tutta la coda, o niente.

/loop <mode>

OpzioneTipoRichiestaDescrizione
mode testo obbligatoria La modalità di ripetizione da applicare.Scelte: Off, Brano, Coda
  • Riservato ai DJ: il proprietario del server, un amministratore, un membro con «Gestire il server», o chi possiede un ruolo aggiunto con /dj add. Vedi /dj.

Esempi

/loop mode:Coda

La coda ricomincia da capo una volta esaurita.

/volume

Riservato ai DJ 2 s

Cambia il volume di riproduzione.

Volume di riproduzione, da 1 a 150.

/volume [volume]

OpzioneTipoRichiestaDescrizione
volume numero intero facoltativa Livello del volume (1-150).Da 1 a 150
  • Riservato ai DJ: il proprietario del server, un amministratore, un membro con «Gestire il server», o chi possiede un ruolo aggiunto con /dj add. Vedi /dj.
  • Oltre 100, la qualità si degrada rapidamente.

/clearqueue

Aperto a tutti 3 s

Svuota tutti i brani in arrivo dalla coda.

Svuota i brani successivi senza interrompere quello in riproduzione.

/clearqueue

/lyrics

Aperto a tutti 5 s

Mostra il testo del brano in riproduzione.

Testo del brano in corso, quando è disponibile.

/lyrics

Ti manca un comando?

La dashboard spiega ogni impostazione accanto al suo interruttore, e la FAQ risponde al resto.