Discord Moderation Bot

Bot de moderação de discórdia modular

Um bot modular para moderadores de usuários no Discord! Adicione comandos personalizados e manipuladores de eventos para personalizar o bot ao seu gosto. Recarregue o bot Usando o comando Builtin !reload ou !reload events para ver suas alterações aplicadas ao vivo!

Uma nota sobre as intenções da mensagem

Esse bot funcionará apenas para os bots menores, pois requer o uso de intenções de mensagem, que para bots maiores, requer a verificação da discórdia. Isso significa que, se o seu bot estiver em mais de 100 cortes, você não poderá usar esse método de realizar comandos e precisará codificar seus próprios manipuladores de comando usando as novas interações.

Veja esta FAQ da Discord em relação a essas mudanças.

Há um plano vago a ser atualizado para usar os novos comandos baseados em interação que oferecem uma melhor experiência do usuário, mas por enquanto permanecerá baseado em mensagens até que eu realmente fique entediado e precise de algo para fazer

Links rápidos

Adicionando seus próprios comandos

Adicionando seus próprios manipuladores de eventos

Adicionando seu próprio armazenamento persistente

Instalação/configuração

Instalação de requisitos

• Versão Python > = 3.8
• discord.py testado em 2.3.2
  • Windows Instale: python -m pip install discord.py
  • Linux Instale: pip3 install discord.py

Criando uma conta de bot com discórdia

1. Vá para o portal do Discord Developer e crie um novo aplicativo
2. Navegue até a seção Bot e clique em Add a bot . Preencha as informações necessárias (como nome e uma imagem, se quiser)
3. Role para baixo até a seção Privileged Gateway Intents e selecione a SERVER MEMBERS INTENT e MESSAGE CONTENT INTENT . Clique em Salvar para salvar suas alterações!
4. Agora role de volta e clique no botão Reset Token , siga as solicitações da tela até que você possa copiar esse token. É assim que o programa efetuará login como essa conta de bot. Não compartilhe esse token com ninguém!
5. Cole o token recém -copiado em um arquivo de texto chamado token.txt na mesma pasta que o arquivo bot.py

Convidando o bot para o seu servidor

1. Na página de aplicativo para o seu bot no portal do Discord Developer, clique na seção OAuth2 .
2. Agora clique na seção URL Generator na barra lateral
3. Selecione o escopo Administrator bot e, em seguida
4. Copie o URL de baixo e cole -o no seu navegador. Siga as instruções na tela para convidar o bot para o seu servidor. Você deve ser um administrador para convidar o bot para o servidor.

Executando o bot

1. Abra um prompt de comando no diretório raiz dos arquivos bot (onde está bot.py ) e execute o comando python bot.py para executar o bot.
2. Você deve ver alguma saída na tela falando sobre carregar comandos e fazer login como o bot. Se tudo isso funcionar, agora você pode usar o bot!
3. Adicione quaisquer funções de moderador que você deseja ao bot usando os comandos abaixo!

Informações de bot

• Prefixo padrão : !
• <argument> = argumento necessário
• [argument] = argumento opcional
• As durações podem ser um tempo formatado que se parece com o seguinte: ( 1w2d3h4m5s ) ​​ou tempo em segundos.
• Durações também podem usar tipos únicos como 2m ou 1w , por exemplo
• Todos os comandos exigem que você esteja em uma função moderadora. Veja os comandos abaixo sobre como adicionar ou remover uma função de mod (requer permissão de administrador para adicionar funções de mod)
• Leia como obter o ID do usuário aqui

Comandos

• !mod <add|remove|list> <role ID>

  • Adiciona, remove o ID da função à lista de funções moderadoras.
  • Se você deseja list as funções, não precisa do ID da função no final.

• !mute <user ID> [reason]

  • Silenciar permanentemente o usuário. Deve ser inútil manualmente.

• !tempmute <user ID> <duration> [reason]

  • Silenciar temporariamente o usuário.

• !unmute <user ID>

  • Usuta o usuário

• !ban <user ID> <duration> <reason>

  • Proíbe o usuário do servidor para a duração especificada
  • Razão é necessária. Se você não tem um motivo, não deve proibi -los.

• !unban <user ID>

  • Unbrans o usuário do servidor.

• !reload

  • Recarregue o registro de comando para quaisquer alterações feitas nos comandos

• !reload events

  • Recarregue o Registro de Eventos para quaisquer alterações que foram feitas

Como obter ID de usuário

Você deve seguir o guia do discórdia aqui

Mas a essência é:

• Ativar modo de desenvolvedor em discórdia
• Clique com o botão direito do mouse no nome de usuário no bate -papo ou na barra lateral
• Clique em Copy ID

Problemas com comandos personalizados?

Certifique -se de que:

• Seu comando é uma subclasse da classe de comando base. (Use from commands.base import Command e, em seguida, defina a classe como esta: class MyCommand(Command): por isso é uma subclasse dela)
• Possui um async def execute(self, message, **kwargs): função para executar o comando
• Não possui erros básicos de sintaxe do Python.