Cambiare bot Discord: porta livelli, menu ruoli e comandi su Lizbot

Molti server usano lo stesso bot da anni. Spesso non si cambia bot Discord per paura di perdere qualcosa per strada: i livelli dei membri, i ruoli a reazione nel canale dei ruoli, i comandi personalizzati o quel messaggio di benvenuto scritto con tanta cura. A questo si aggiunge il timore che per un po' due bot facciano tutto doppio.

Lizbot ha un'area dedicata al cambio, che legge il tuo server e propone cosa si può trasferire. Molte cose vanno in automatico o con un clic, poche altre le completi tu in un attimo. In questa guida affronti il cambio passo dopo passo: partire in parallelo, scansionare, trasferire livelli e menu ruoli, importare i comandi e rimuovere il vecchio bot in modo pulito. Perché conviene riunire subito più bot in uno solo lo spiega la guida Un bot invece di tanti.

Cosa si può trasferire e cosa no

Non si può trasferire quello che sta solo nel database o nella dashboard del vecchio bot: le sue impostazioni AutoMod, le domande dei ticket, le modalità speciali dei menu ruoli, i benvenuti in DM, i comandi slash, l'economia e i giveaway. La logica nei comandi, come condizioni o variabili, Lizbot non la traduce. Il resoconto finale ti dice per ogni punto se è stato trasferito, cosa devi fare a mano o perché non è possibile. Come configurare da capo l'AutoMod lo trovi nella guida sull'AutoMod.

Se stai lasciando proprio Ticket Tool, la guida Alternativa a Ticket Tool mostra come trasferire pannelli, categorie e ruoli dello staff senza interrompere il supporto.

1. Aggiungere Lizbot in parallelo

Aggiungi Lizbot dalla dashboard senza rimuovere il vecchio bot. I due possono funzionare fianco a fianco per un po'. Il cambio lo trovi nella dashboard, in Strumenti, scheda Cambia bot. Per usarlo ti servono permessi da amministratore sul server.

In cima alla pagina, in Bot trovati, Lizbot mostra quali bot conosciuti ha trovato sul tuo server e quali moduli può trasferire da loro. Dove i due possono sovrapporsi, per esempio con i messaggi di benvenuto, Lizbot te lo segnala. Se usi quella funzione nel vecchio bot, disattivala in uno dei due.

Fai attenzione all'ordine dei ruoli: Lizbot può assegnare solo i ruoli che stanno sotto il suo. Nelle impostazioni del server trascina il ruolo di Lizbot sopra tutti i ruoli di livello, di notifica e di interesse. Se qualcosa continua a non funzionare, ti aiuta la guida sui permessi mancanti del bot.

2. Far scansionare il server

Nella scheda Assistente scegli le aree e la profondità: Rapida legge fino a 40 canali con 100 messaggi ciascuno, Completa fino a 80 canali con 500 messaggi ciascuno e il log di moderazione fino a 5000 messaggi indietro. In Ricerca più precisa puoi indicare, se serve, canali, link ai messaggi e il log di moderazione del vecchio bot. Con Avvia scansione si parte. Puoi lasciare la pagina, la scansione continua.

Lizbot legge solo il tuo server tramite Discord: ruoli, canali, autorizzazioni, messaggi di altri bot, le regole AutoMod di Discord, il registro attività e la lista dei ban. I messaggi dei membri li analizza solo brevemente per riconoscere i comandi usati e non li salva. Se a Lizbot manca un'autorizzazione, come Visualizza registro attività o Gestisci server, la scansione va avanti lo stesso. L'area interessata compare poi nel resoconto, con l'autorizzazione mancante.

Durante la scansione non cambia ancora nulla. Da più messaggi di benvenuto reali Lizbot ricostruisce il modello: la menzione del nuovo membro diventa {user.mention}, il nome {user.name}, il nome del server {guild.name} e il numero di membri {guild.memberCount}. I punti che non riesce ad abbinare con sicurezza li segna, così li controlli tu. Come personalizzare ancora il modello dopo lo spiega la guida sul messaggio di benvenuto su Discord.

3. Controllare le proposte, fare un backup e trasferire

Dopo la scansione vedi una scheda per area con tutte le proposte. Per ognuna Lizbot mostra quanto è sicuro:

• sicura: preselezionata
• da controllare: non preselezionata, di solito basta un'occhiata all'anteprima
• incerta: compressa; gli abbinamenti come ruolo o canale li confermi tu, prima non si può spuntare la proposta

Aprendo una proposta vedi il prima e il dopo, la fonte con il link al messaggio, e puoi modificare testi e abbinamenti. I ruoli con permessi da staff e quelli sopra quello di Lizbot non vengono mai abbinati in automatico.

Con Importa selezionate Lizbot crea prima un backup delle impostazioni di Lizbot e, per i livelli, anche della tabella dei livelli. Se il backup non riesce, non viene cambiato nulla. Poi trasferisce le proposte una dopo l'altra. Se una non va a buon fine, le altre proseguono.

Alla fine c'è un Resoconto in tre parti: cosa è stato trasferito, cosa devi fare a mano, con istruzioni come "elimina il vecchio pannello", e cosa non è possibile, con il motivo. Se vuoi, scarichi il resoconto come file per il tuo team.

Annulla: per 30 giorni puoi annullare singole proposte o tutto. Lizbot rimuove esattamente ciò che il cambio ha creato e riporta le impostazioni modificate allo stato precedente. Se dopo il cambio hai modificato qualcosa, Lizbot lo lascia com'è, a meno che tu non scelga Ripristina comunque. I livelli tornano indietro solo tramite il backup. Puoi anche ripristinare l'intero backup, ma così annulli anche le modifiche fatte dopo il cambio.

4. Trasferire i livelli

Nella scheda Livelli scegli la fonte:

• File: CSV o JSON con ID utente e XP, e facoltativamente livello e numero di messaggi. Se il tuo vecchio bot offre un'esportazione, caricala direttamente; Lizbot riconosce i nomi di colonna più comuni. Molti bot di livelli non hanno un'esportazione: in quel caso inserisci i valori nel modello che puoi scaricare lì. Il file può pesare fino a 8 MB. Prima dell'importazione Lizbot mostra quante voci ha riconosciuto e come abbina le colonne.
• Classifica pubblica: per un bot di livelli molto diffuso Lizbot può caricare direttamente la classifica pubblica del tuo server. Lì deve essere impostata come pubblica. Se funziona con il tuo vecchio bot lo vedi nella scheda.

Poi definisci la Conversione:

• Mantieni i livelli: ognuno ottiene in Lizbot lo stesso livello di prima, qualunque sia la curva di XP.
• XP 1:1: gli XP vengono trasferiti e il livello deriva dalla curva di Lizbot.

Se il tuo server ha già livelli in Lizbot, scegli tra Unisci (vince il valore più alto) e Sostituisci. Con Assegna poi i ruoli premio tutti ricevono subito i ruoli di livello che gli spettano. Configura prima i ruoli premio in Livelli e XP. Maggiori dettagli nella guida Sistema di livelli.

Se arrivi da Arcane, i passaggi per livelli e ruoli premio li trovi nella guida Alternativa ad Arcane.

5. Trasferire i menu ruoli

Nella scheda Menu ruoli incolli i link ai messaggi (clic destro sul messaggio, Copia link messaggio) oppure scegli i canali in cui Lizbot deve cercare. Con Cerca menu ruoli Lizbot riconosce quale emoji o quale pulsante appartiene a quale ruolo e per ogni risultato mostra quanto è sicuro.

Qui c'è una differenza importante:

• Ruoli a reazione: Lizbot adotta il messaggio esistente. Il messaggio resta com'è e i tuoi membri continuano a reagire come sempre. Maggiori dettagli nella guida sui ruoli a reazione.
• Menu con pulsanti o menu a tendina: questi componenti appartengono al vecchio bot e senza di lui non funzionano. Per questo Lizbot pubblica un nuovo menu ruoli con pulsanti nello stesso canale. Il vecchio messaggio lo elimini tu dopo.

I ruoli con permessi da staff, come bannare o gestire i messaggi, Lizbot non li assegna mai tramite menu. Come personalizzare ancora i menu ruoli dopo lo trovi nella guida Configurare i ruoli su Discord.

Come funziona in pratica con ruoli a reazione, tag e log di Carl-bot lo spiega la guida Alternativa a Carl-bot.

6. Trasferire i comandi personalizzati

Nella scheda Comandi incolli i tuoi comandi come testo, uno per riga, per esempio !regole Leggi #regole, per favore oppure regole: Leggi #regole, per favore. In alternativa carichi un file CSV o JSON con nome e risposta.

In Segnaposto di scegli da quale bot arrivano i testi. Lizbot traduce allora i segnaposto conosciuti nei suoi e lascia quelli sconosciuti come sono. Condizioni, altra logica ed embed Lizbot non li traduce, quindi quei comandi li sistemi poi velocemente a mano. Il comando con prefisso diventa un comando slash: il prefisso sparisce, il nome passa in minuscolo e le lettere accentate vengono convertite, quindi !Regole diventa /regole.

Con Verifica vedi prima cosa verrà creato, aggiornato o saltato. Un comando viene saltato se il nome appartiene a Lizbot, se esiste già, se compare due volte o se hai raggiunto il limite del tuo piano. Lizbot sostituisce i comandi esistenti solo se attivi Sovrascrivi i comandi esistenti. Come modificare e ampliare poi i comandi trasferiti lo trovi nella guida sui comandi personalizzati su Discord.

7. Rimuovere il vecchio bot

Quando tutto funziona, rimuovi tu il vecchio bot dalle impostazioni del server, in Integrazioni, oppure con il clic destro nell'elenco dei membri. Lizbot non rimuove altri bot. Poi elimina i vecchi messaggi dei menu ruoli che non funzionano più e crea un backup della tua nuova configurazione.

Limiti per piano

Checklist

• Lizbot aggiunto, il vecchio bot funziona ancora
• Ruolo di Lizbot sopra tutti i ruoli che deve assegnare
• Scansione fatta e proposte controllate
• Livelli importati e ruoli premio assegnati
• Menu ruoli trasferiti e vecchi menu con pulsanti eliminati
• Comandi personalizzati importati e provati
• Funzioni doppie disattivate nel vecchio bot
• Vecchio bot rimosso, backup creato

Errori comuni

• Rimuovere il vecchio bot troppo presto: senza di lui Lizbot riesce ancora a leggere i suoi messaggi, ma i menu con pulsanti smettono di funzionare. Rimuovilo solo quando hai trasferito tutto.
• Lasciare che entrambi i bot facciano la stessa cosa: due messaggi di benvenuto o salite di livello doppie confondono i membri. Disattiva subito in uno dei due bot le funzioni che si sovrappongono.
• Ruolo di Lizbot troppo in basso: in quel caso l'assegnazione dei ruoli di livello e dei menu non riesce.
• Spuntare alla cieca le proposte incerte: controlla gli abbinamenti poco sicuri prima di trasferirli.
• Classifica non pubblica: Lizbot non può caricare una classifica privata. Rendila pubblica nel vecchio bot oppure usa l'importazione da file.