Questa sezione raccoglie i passaggi essenziali per iniziare a usare UrbanBoi sul tuo server Discord: dall'invito iniziale, alla configurazione minima consigliata, fino a come diventare partner ufficiale.

1. Invitare il bot

Per aggiungere UrbanBoi al tuo server serve un account con permesso Gestisci Server.

Al primo accesso, il bot invia automaticamente un messaggio di benvenuto nel canale di sistema del server (o nel primo canale disponibile in cui può scrivere), invitando gli amministratori a configurarlo con /config.

2. Dargli un ruolo adeguato

Dopo l'invito, Discord crea automaticamente un ruolo dedicato a UrbanBoi. Ti consigliamo di verificare che abbia, come minimo, questi permessi nei canali in cui deve operare:

• Visualizza Canale e Invia Messaggi
• Incorpora Link - necessario per mostrare le definizioni Urban Dictionary e i pannelli di configurazione (sono tutti embed)
• Usa Comandi Applicazione - per i comandi slash come /define e /config
• Leggi Cronologia Messaggi - necessario sia per la funzione "menziona in risposta" (deve poter leggere il messaggio originale a cui stai rispondendo), sia per la cancellazione messaggi con reazione
• Gestisci Messaggi - necessario se attivi il canale bait (per eliminare i messaggi altrui scritti al suo interno) e/o se usi /sticky (per eliminare la vecchia copia ad ogni bump) - non serve per la normale cancellazione via reazione, che riguarda solo i messaggi del bot stesso
• Bannare Membri - necessario solo se attivi il canale bait, per applicare il ban automatico ed eliminare i messaggi delle ultime 24 ore
• Gestisci Ruoli - necessario solo se usi il comando /sudo, per creare il ruolo Sudoer e assegnarlo/rimuoverlo ai membri
• Allega File - necessario solo se usi /sticky su un messaggio che contiene allegati Se il tuo server ha canali con permessi personalizzati, assicurati che il ruolo del bot non venga bloccato da override più restrittivi.

3. Configurazioni di base fondamentali

UrbanBoi si configura tramite il comando /config, riservato agli Amministratori del server.

/config help                        → mostra la guida rapida ai config
/config list-available              → elenca le chiavi di config disponibili
/config list-rich                   → elenca le chiavi con i relativi valori attuali
/config get chiave:<chiave>         → mostra il valore attuale di una chiave
/config set chiave:<chiave> valore:<valore>  → imposta il valore di una chiave

/config è un gruppo di sottocomandi: digitando /config su Discord vedrai help, list-available, list-rich, get e set come opzioni separate, ognuna con solo i parametri che le servono davvero.

Le chiavi di configurazione seguono convenzioni fisse di naming:

• le chiavi che terminano in _role o _role_id si aspettano l'ID di un singolo ruolo
• le chiavi che terminano in _roles si aspettano una lista di ID ruolo, es. [123456789, 987654321]
• le chiavi che terminano in _channel o _channel_id si aspettano l'ID di un canale Ti consigliamo di eseguire /config list-available subito dopo l'invito per vedere quali config sono già impostabili sul tuo server, e di impostarle prima di iniziare a usare le feature che ne dipendono.

In particolare, tra le prime cose da impostare consigliamo:

• log_channel_id(W.I.P.) - canale dove UrbanBoi invia i log di sistema (errori, eventi rilevanti di moderazione automatica)
• bait_channel_id - attiva il canale bait, la trappola anti-scam che banna automaticamente chi ci scrive dentro.
• sudo_channel_id - canale dove arrivano le richieste di approvazione del comando /sudo.

4. Diventare partner

Se gestisci un server con una community attiva e vuoi diventare partner ufficiale di UrbanBoi e del GDP, scrivi a:

[email protected]

Includi nome del server, numero indicativo di membri e un breve link o descrizione della community: verrà tutto valutato dal team e se approvato sarete visibili nella sezione Parnters!