Wiki / Core Features / Leveling e XP / Importar níveis de outro bot

Importar níveis de outro bot

Atualizado por Maxime_48 · há 2 horas · Visualizações: 115

Idiomas: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

Trocar de bot de níveis normalmente significa avisar sua comunidade de que todo mundo voltou ao nível 0. Você não precisa fazer isso. Abra Níveis → Importar no painel e traga o XP dos seus membros - direto do MEE6, ou de uma exportação JSON de qualquer outro bot de níveis.

Nada é gravado até você ver uma pré-visualização e confirmar.

Vindo especificamente do MEE6? Migrar do MEE6 para o YAWBDB acompanha a mudança inteira, e não só a tela de importação.

A aba Importar da página Níveis com a escolha da origem, o campo do ID do servidor e o botão Pré-visualizar destacados

  1. Escolha a origem: MEE6 ou um arquivo JSON.
  2. Informe o ID do servidor Discord no MEE6.
  3. Pré-visualizar mostra o que seria importado. Nada é gravado até você confirmar.

📥 Importar do MEE6

Escolha MEE6, informe o ID do servidor Discord (o seu já vem preenchido) e clique em Pré-visualizar.

A classificação do MEE6 precisa ser pública. No painel do MEE6, ative "Make my server's leaderboard public". Sem isso, o MEE6 se recusa a entregar os dados e a importação para com uma explicação, em vez de um resultado parcial silencioso.

Você pode importar de um servidor diferente daquele que está configurando - basta colar o ID desse servidor. Útil se você estiver unificando duas comunidades.

A pré-visualização mostra quantos membros foram encontrados, quantos deles já têm XP aqui e uma amostra do topo da classificação.


📄 Importar de um arquivo JSON

A API pública do Amari foi desativada, e a maioria dos outros bots de níveis nunca teve uma - então a segunda via é um arquivo. Escolha Ficheiro JSON e envie uma exportação.

O leitor é propositalmente tolerante. Ele aceita:

  • um array JSON simples de membros,
  • um objeto contendo um array players (uma resposta bruta do MEE6 funciona como está),
  • um objeto contendo um array data (o formato que o Amari usava - XP como texto não é problema),
  • e os apelidos de campos usuais: id / user_id / discord_id, e xp / exp / experience.

Cada entrada só precisa de duas coisas para ser aproveitada: um ID de usuário do Discord e uma quantidade de XP. As entradas que não têm uma delas são ignoradas, em vez de fazer o arquivo inteiro falhar.

Se o arquivo também trouxer recompensas de cargo (role_rewards ou rewards), elas também são aproveitadas.

O caminho de ida e volta já vem pronto: o ↓ Exportar JSON de Níveis → Classificação gera um arquivo exatamente nesse formato, com o array players. Exporte de um servidor, importe em outro - ou guarde como backup que você pode trazer de volta direto. Veja Cartão de nível e classificação pública.


📐 A curva de níveis - a decisão que vale a pena ler

Dois bots podem guardar exatamente o mesmo XP e ainda assim mostrar níveis diferentes, porque o nível é só uma consulta em uma curva, e nem todo bot usa a mesma.

O MEE6 cobra 5·l² + 50·l + 100 de XP para sair do nível l. A fórmula do YAWBDB tem o mesmo formato, mas é indexada pelo nível a ser alcançado. A consequência prática: importar o XP do MEE6 na nossa predefinição padrão faz todos os membros caírem exatamente um nível. O XP deles continua intacto e correto - só que corresponde a um degrau abaixo.

Por isso, a pré-visualização mede isso nos seus dados reais e avisa com clareza, por exemplo: "412 dos 900 membros que pudemos comparar mudariam de nível aqui - até 1 nível a menos."

Depois você escolhe:

  • Manter a sua curva - o XP é importado exatamente, e os níveis são recalculados pela sua fórmula. Os membros veem o número deles cair em um.
  • Usar a curva da origem - o YAWBDB muda a fórmula deste servidor para a predefinição personalizada a = 5, b = 40, c = 55, que reproduz a curva do MEE6 até o último XP. Todos mantêm o nível que tinham.

Adotar a curva é uma configuração do servidor inteiro, então ela também recalcula o nível dos membros que já estavam aqui antes da importação. O XP deles nunca é modificado - só o nível ao qual ele corresponde. É de propósito: deixar metade da classificação na fórmula antiga pareceria um bug.

Se o seu servidor já usa uma curva idêntica à do MEE6, a pergunta nem é feita.


⚙️ Membros que já têm XP aqui

Escolha o que acontece em caso de colisão:

Opção O que faz
Manter o XP mais alto Importa só quando a origem tem mais. A opção mais segura e a padrão.
Substituir pelo XP importado A origem vence, mesmo quando é mais baixa.
Não lhes tocar Só são importados os membros que não têm nenhum XP aqui.

Os membros que estão na importação mas nunca falaram aqui nunca são afetados pelo decaimento de XP até ficarem de fato ativos - uma importação não inicia uma contagem de decaimento.


🎖️ Recompensas de cargo

Se a origem expõe recompensas de cargo, você pode importá-las ao mesmo tempo. Cada uma é adicionada ao seu Gráfico de recompensas como um par "nível atingido → atribuir cargo".

Os caminhos existentes são verificados primeiro, então refazer uma importação não empilha ramificações duplicadas no seu canvas. Se o seu gráfico de recompensas estiver no limite de nós, a importação preenche o que for possível e informa quantas foram adicionadas de quantas foram encontradas.


🔕 O que uma importação não faz

Uma importação é uma migração de dados, não um evento ao vivo:

  • nenhuma mensagem de subida de nível é enviada, por mais níveis que um membro ganhe,
  • nenhuma recompensa é disparada retroativamente - o gráfico não é reexecutado sobre o histórico importado,
  • as recompensas de cargo que você importou valem a partir do próximo nível que um membro alcançar.

É de propósito. Anunciar milhares de subidas de nível de uma só vez inundaria o servidor, e preencher cargos retroativamente para uma classificação inteira raramente é o que você realmente quer.


⏳ Enquanto roda

As classificações grandes são importadas em segundo plano. A página mostra uma barra de progresso, e você pode fechá-la - a importação continua e o progresso ainda está lá quando você voltar.

Quando termina, você recebe um resumo: membros adicionados, atualizados, ignorados e recompensas de cargo importadas.

Só uma importação pode rodar por vez em cada servidor.


👍 Ordem recomendada

  1. Configure o Leveling primeiro (taxas de XP, tempo de espera, canal de subida de nível).
  2. Execute a Pré-visualização e leia a comparação de curvas.
  3. Decida sobre a curva antes de importar - mudá-la depois significa que o nível de todos os membros se move de novo.
  4. Importe e depois confira Níveis → Classificação.
  5. Adicione ou ajuste recompensas no Gráfico de recompensas.