Deslocamento de Posição de Cargos no Discord Após Bot Adicionar Novos Cargos: Correção

Quando um bot adiciona automaticamente novos cargos ao seu servidor Discord, as posições dos cargos organizados manualmente podem mudar inesperadamente. Esse deslocamento quebra hierarquias de permissão e pode fazer com que comandos de moderação ou acesso a canais parem de funcionar corretamente. A causa raiz é que o Discord atribui a posição mais alta disponível a um novo cargo por padrão, empurrando todos os cargos existentes para baixo. Este artigo explica exatamente por que o deslocamento ocorre e fornece uma correção passo a passo para restaurar e travar a ordem dos cargos.

Por que as Posições dos Cargos no Discord se Deslocam Após a Criação de Cargos por Bot

O Discord atribui uma posição numérica a cada cargo. A posição 0 é o cargo mais alto, diretamente abaixo do proprietário do servidor. Quando você cria um cargo manualmente, o Discord o coloca no topo da lista existente por padrão. Bots que criam cargos via API fazem o mesmo: eles chamam guild.createRole() sem especificar uma posição, e o Discord insere automaticamente o novo cargo na posição 0. Isso desloca cada cargo existente para baixo em um slot, quebrando qualquer hierarquia de permissão que você tenha configurado cuidadosamente.

Por exemplo, se seu cargo de moderador está na posição 3 e o cargo de membro na posição 4, um bot adicionando um novo cargo empurra o cargo de moderador para a posição 4 e o cargo de membro para a posição 5. Se o cargo de moderador anteriormente tinha permissão para expulsar membros, agora ele está abaixo do cargo de membro na hierarquia, e a permissão de expulsão pode não ser mais aplicada como esperado. Esse deslocamento não é um bug. É o comportamento padrão da API do Discord quando nenhuma posição é especificada.

A correção envolve duas ações: reordenar manualmente os cargos após a execução do bot e configurar o bot para colocar novos cargos em uma posição específica. Alguns bots suportam um parâmetro position em seu comando de criação de cargo. Outros não, exigindo uma solução alternativa usando um bot de gerenciamento de cargos ou um script agendado.

Passos para Corrigir e Prevenir o Deslocamento de Posição de Cargos

1. Identifique os cargos que se deslocaram
   Abra seu servidor e verifique a lista de cargos em Configurações do Servidor > Cargos. Procure por cargos que aparecem acima de cargos que deveriam estar abaixo. Por exemplo, se o cargo @everyone está acima de um cargo de equipe, isso é um indicador de deslocamento. Anote a ordem correta necessária: primeiro o cargo mais alto, por último o mais baixo.
2. Reordene manualmente os cargos arrastando
   Em Configurações do Servidor > Cargos, clique e segure o ícone de seis pontos à esquerda do nome do cargo. Arraste o cargo para sua posição correta na lista. Solte o mouse. Repita para cada cargo deslocado. Isso restaura a hierarquia imediatamente. Todas as permissões e acesso a canais voltam ao comportamento pretendido.
3. Verifique se o comando de criação de cargo do bot tem um parâmetro de posição
   Abra a documentação do bot ou digite /help em um canal onde o bot responde. Procure por um parâmetro chamado position ou index. Exemplo: /role create name: "trial-mod" position: 5. Se o bot suportar, use este parâmetro para colocar novos cargos abaixo de todos os cargos existentes. Isso evita o deslocamento completamente.
4. Se o bot não suportar um parâmetro de posição, use um bot de gerenciamento de cargos
   Instale um bot como Role Saver ou Auto Roles. Esses bots podem ser configurados para executar uma verificação agendada a cada poucos minutos. Quando detectam um cargo fora do lugar, eles o movem de volta para sua posição salva. Siga o guia de configuração do bot para salvar um instantâneo da ordem atual dos cargos e ativar a correção automática.
5. Crie um script personalizado usando webhooks do Discord ou um bot auto-hospedado
   Se você tem experiência em programação, escreva um script que escute o evento guildRoleCreate. O script lê a posição do novo cargo e a compara com uma lista armazenada. Se o novo cargo não estiver na posição pretendida, o script chama role.setPosition() para movê-lo. Hospede o script em um serviço de nuvem gratuito ou em um Raspberry Pi. Isso dá a você controle total sobre o posicionamento dos cargos.
6. Teste a correção fazendo o bot criar um cargo de teste
   Peça ao bot para criar um cargo fictício. Após a criação, verifique Configurações do Servidor > Cargos para confirmar que o novo cargo aparece no final da lista ou na posição especificada. Se ele se deslocou, repita o passo 2 e verifique a configuração do bot novamente.

Se os Cargos do Discord Ainda se Deslocarem Após Aplicar a Correção Principal

Bot cria cargos em posições aleatórias

Alguns bots, especialmente os personalizados ou mal codificados, atribuem uma posição aleatória ao criar um cargo. A única correção confiável é parar de usar esse bot para criação de cargos ou modificar seu código-fonte. Se você não puder modificar o bot, use um bot de gerenciamento de cargos que reordene os cargos a cada 30 segundos. Isso substitui rapidamente o posicionamento aleatório.

Deslocamento ocorre apenas após uma queda do servidor ou atualização da API do Discord

O Discord ocasionalmente muda a forma como os cargos são armazenados internamente. Após uma atualização da API, as posições dos cargos podem ser redefinidas para ordem alfabética ou ordem de criação. Isso é raro, mas documentado. Para se preparar, exporte sua lista de cargos como um arquivo JSON usando um bot como Dyno. Se ocorrer deslocamento, importe a ordem salva para restaurar as posições instantaneamente.

Bot adiciona cargos mais rápido do que o bot de gerenciamento consegue reordenar

Se um bot cria 50 cargos em um segundo, um bot de gerenciamento que verifica a cada 30 segundos pode não capturar todos os deslocamentos antes que as permissões quebrem. Solução: aumente a frequência de verificação do bot de gerenciamento para cada 5 segundos, ou use um bot que processe cargos em lotes. Alternativamente, crie cargos um de cada vez com um atraso entre cada criação.

Reordenação Manual vs. Ordenação Automática por Bot vs. Script Personalizado

Item	Reordenação Manual	Ordenação Automática por Bot	Script Personalizado
Tempo de configuração	Instantâneo	10 minutos	2 horas ou mais
Esforço contínuo	Repetir após cada criação de cargo por bot	Nenhum	Nenhum após a implantação
Custo	Gratuito	Assinatura de bot gratuita ou paga	Gratuito se auto-hospedado
Confiabilidade	100% precisa, mas depende do humano	Alta, depende do tempo de atividade do bot	Muito alta, controle total

A reordenação manual é a correção mais rápida quando o deslocamento já ocorreu. A ordenação automática por bot é a melhor prevenção de longo prazo para servidores com criação frequente de cargos por bot. Scripts personalizados oferecem o maior controle, mas exigem habilidade técnica para configurar e manter.

O deslocamento de cargos após a criação por bot é causado pelo Discord colocar novos cargos no topo da hierarquia por padrão. Você pode corrigi-lo imediatamente arrastando os cargos de volta à ordem em Configurações do Servidor > Cargos. Para evitar deslocamentos futuros, configure o bot para usar um parâmetro position ou instale um bot de gerenciamento de cargos que corrija automaticamente as posições. Para prevenção avançada, escreva um script personalizado que escute novos cargos e os mova para uma posição predefinida. Teste sua configuração com um cargo fictício para confirmar que a correção funciona antes de confiar nela em produção.