Trocar de bot de Discord: leve níveis, menus de cargos e comandos para o Lizbot

Muitos servidores rodam há anos com o mesmo bot. Trocar de bot de Discord costuma travar no medo de perder algo no caminho: os níveis dos membros, os cargos por reação do canal de cargos, os comandos personalizados ou aquele texto de boas-vindas escrito com carinho. Some a isso o receio de que dois bots façam tudo em dobro por um tempo.

O Lizbot tem uma área própria para a troca, que analisa seu servidor e sugere o que dá para trazer. Muita coisa vai sozinha ou com um clique, e algumas poucas você completa rapidinho. Neste guia você faz a troca passo a passo: começar em paralelo, analisar, trazer níveis e menus de cargos, importar comandos e remover o bot antigo sem deixar rastros. Por que vale a pena juntar logo vários bots em um só explica o guia Um bot em vez de vários.

O que dá para trazer e o que não dá

Não dá para trazer o que só existe no banco de dados ou no painel do bot antigo: as configurações de AutoMod dele, perguntas de tickets, modos especiais de menus de cargos, boas-vindas por MD, comandos de barra, economia e sorteios. O Lizbot não traduz lógica de comandos, como condições ou variáveis. O relatório no final diz para cada item se ele foi trazido, o que você precisa fazer na mão ou por que não é possível. Como configurar o AutoMod do zero está no guia sobre o AutoMod.

Se você está saindo especificamente do Ticket Tool, o guia Alternativa ao Ticket Tool mostra como trocar painéis, categorias e cargos da equipe sem parar o suporte.

1. Adicionar o Lizbot em paralelo

Adicione o Lizbot pelo painel sem remover o bot antigo. Os dois podem rodar lado a lado por um tempo. A troca fica no painel, em Ferramentas, aba Trocar de bot. Para isso você precisa de permissões de administrador no servidor.

No topo da página, em Bots encontrados, o Lizbot mostra quais bots conhecidos ele encontrou no seu servidor e quais módulos pode trazer deles. Onde os dois podem se sobrepor, por exemplo nas mensagens de boas-vindas, o Lizbot avisa você. Se você usa essa função no bot antigo, desative em um dos dois.

Atenção à ordem dos cargos: o Lizbot só consegue atribuir cargos que estejam abaixo do próprio cargo. Nas configurações do servidor, arraste o cargo do Lizbot para cima de todos os cargos de nível, de notificação e de interesses. Se mesmo assim algo não funcionar, o guia sobre permissões que faltam ao bot ajuda.

2. Analisar o servidor

Na aba Assistente você escolhe as áreas e a profundidade: Rápida lê até 40 canais com 100 mensagens cada, Completa até 80 canais com 500 mensagens cada e o registro de moderação até 5000 mensagens para trás. Em Busca mais precisa você pode indicar canais, links de mensagens e o registro de moderação do bot antigo. Com Iniciar varredura começa. Você pode sair da página, a varredura continua.

O Lizbot lê apenas o seu servidor pelo Discord: cargos, canais, permissões, mensagens de outros bots, as regras de AutoMod do próprio Discord, o registro de auditoria e a lista de banimentos. Mensagens de membros ele só analisa rapidamente para reconhecer os comandos usados e não as guarda. Se faltar ao Lizbot uma permissão, como Ver registro de auditoria ou Gerenciar servidor, a varredura roda mesmo assim. A área afetada aparece então no relatório, com a permissão que falta.

A varredura ainda não muda nada. A partir de várias mensagens de boas-vindas reais, o Lizbot reconstrói o modelo: a menção ao novo membro vira {user.mention}, o nome vira {user.name}, o nome do servidor vira {guild.name} e o número de membros vira {guild.memberCount}. Trechos que ele não consegue associar com segurança ficam marcados para você conferir. Como continuar ajustando o modelo depois mostra o guia sobre a mensagem de boas-vindas no Discord.

3. Conferir as sugestões, fazer backup e importar

Depois da varredura você vê um cartão por área com todas as sugestões. Para cada uma, o Lizbot mostra o quanto tem certeza:

• segura: pré-selecionada
• confira: não pré-selecionada, geralmente basta uma olhada na prévia
• incerta: recolhida; associações como cargo ou canal você confirma, antes disso não dá para marcar a sugestão

Ao abrir uma sugestão, você vê o antes e o depois, a fonte com link para a mensagem, e pode ajustar textos e associações. Cargos com permissões de equipe e cargos acima do próprio cargo do Lizbot nunca são associados automaticamente.

Com Importar selecionadas, o Lizbot primeiro cria um backup das configurações do Lizbot e, no caso de níveis, também da tabela de níveis. Se o backup falhar, nada é alterado. Depois ele importa as sugestões uma por uma. Se uma falhar, as outras continuam.

No fim há um Relatório em três partes: o que foi trazido, o que você precisa fazer na mão, com instruções como "excluir o painel antigo", e o que não é possível, com o motivo. Você pode baixar o relatório como arquivo para sua equipe.

Desfazer: durante 30 dias você desfaz sugestões avulsas ou tudo. O Lizbot remove exatamente o que a troca criou e volta as configurações alteradas para como estavam. Se você mexeu em algo depois da troca, o Lizbot não toca nisso, a não ser que você escolha Resetar mesmo assim. Os níveis só voltam pelo backup. Você também pode restaurar o backup inteiro, mas isso desfaz também as mudanças que você fez depois da troca.

4. Trazer os níveis

Na aba Níveis você escolhe a origem:

• Arquivo: CSV ou JSON com ID do usuário e XP e, opcionalmente, nível e número de mensagens. Se o seu bot antigo oferece exportação, envie direto; o Lizbot reconhece os nomes de coluna mais comuns. Muitos bots de níveis não têm exportação; nesse caso, preencha o modelo que você pode baixar ali. O arquivo pode ter até 8 MB. Antes de importar, o Lizbot mostra quantas entradas reconheceu e como associa as colunas.
• Ranking público: para um bot de níveis bem popular, o Lizbot consegue carregar direto o ranking público do seu servidor. Ele precisa estar como público lá. Se isso funciona com o seu bot antigo, você vê na aba.

Depois você define a Conversão:

• Manter níveis: cada membro fica no Lizbot com o mesmo nível de antes, seja qual for a curva de XP.
• XP 1:1: a XP é trazida e o nível sai da curva do Lizbot.

Se o seu servidor já tem níveis no Lizbot, você escolhe entre Mesclar (vence o valor mais alto) e Substituir. Com Atribuir cargos de recompensa depois, todos recebem na hora os cargos de nível a que têm direito. Crie as recompensas de cargos antes em Níveis e XP. Mais detalhes no guia Sistema de níveis.

Se você vem do Arcane, os passos para níveis e cargos de recompensa estão no guia Alternativa ao Arcane.

5. Trazer os menus de cargos

Na aba Menus de cargos você cola os links das mensagens (clique com o botão direito na mensagem, "Copiar link da mensagem") ou escolhe canais em que o Lizbot deve procurar. Com Procurar menus de cargos, o Lizbot detecta qual emoji ou qual botão pertence a qual cargo e mostra, para cada achado, o quanto tem certeza.

Aqui existe uma diferença importante:

• Cargos por reação: o Lizbot adota a mensagem existente. A mensagem fica como está, e seus membros continuam reagindo como sempre. Mais detalhes no guia sobre cargos por reação.
• Menus com botões ou menu suspenso: esses componentes pertencem ao bot antigo e não funcionam sem ele. Por isso o Lizbot publica um novo menu de cargos com botões no mesmo canal. A mensagem antiga você exclui depois.

Cargos com permissões de equipe, como banir ou gerenciar mensagens, o Lizbot nunca atribui por menus. Como continuar ajustando os menus de cargos depois está no guia Configurar cargos no Discord.

Como isso funciona na prática com os cargos por reação, as tags e os registros do Carl-bot explica o guia Alternativa ao Carl-bot.

6. Trazer os comandos personalizados

Na aba Comandos você cola seus comandos como texto, um por linha, por exemplo !regeln Bitte lies #regeln ou regeln: Bitte lies #regeln. Outra opção é enviar um arquivo CSV ou JSON com nome e resposta.

Em Placeholders de você escolhe de qual bot vêm os textos. O Lizbot então traduz os placeholders conhecidos para os dele e deixa os desconhecidos como estão. Condições, outras lógicas e embeds o Lizbot não traduz, então esses comandos você ajusta rapidinho na mão depois. O comando com prefixo vira um comando de barra: o prefixo some, o nome fica em minúsculas e caracteres especiais são convertidos, então !Regeln vira /regeln.

Com Verificar você vê antes o que vai ser criado, atualizado ou pulado. Um comando é pulado se o nome pertence ao Lizbot, se já existe, se aparece duplicado ou se o limite do seu plano foi atingido. O Lizbot só substitui comandos existentes se você ativar Sobrescrever comandos existentes. Como editar e ampliar os comandos importados depois está no guia sobre comandos personalizados no Discord.

7. Remover o bot antigo

Quando tudo estiver funcionando, remova você mesmo o bot antigo pelas configurações do servidor, em Integrações, ou com o botão direito na lista de membros. O Lizbot não remove outros bots. Depois, exclua as mensagens antigas de menus de cargos que não funcionam mais e crie um backup da sua nova configuração.

Limites por plano

Checklist

• Lizbot adicionado, o bot antigo ainda está rodando
• Cargo do Lizbot acima de todos os cargos que ele deve atribuir
• Varredura feita e sugestões conferidas
• Níveis importados e cargos de recompensa atribuídos
• Menus de cargos trazidos e menus antigos com botões excluídos
• Comandos personalizados importados e testados
• Funções duplicadas desativadas no bot antigo
• Bot antigo removido, backup criado

Erros comuns

• Remover o bot antigo cedo demais: sem ele, o Lizbot ainda consegue ler as mensagens dele, mas os menus com botões param de funcionar. Remova só quando tudo tiver sido trazido.
• Deixar os dois bots fazendo a mesma coisa: duas mensagens de boas-vindas ou subidas de nível em dobro confundem os membros. Desative logo em um dos bots as funções que se sobrepõem.
• Cargo do Lizbot muito embaixo: aí a atribuição de cargos de nível e de menu falha.
• Marcar sugestões incertas sem olhar: confira as associações com pouca certeza antes de importar.
• Ranking não público: o Lizbot não consegue carregar um ranking privado. Deixe o ranking público no bot antigo ou use a importação por arquivo.