Discord Moderation Bot

Bot de moderación de discordia modular

¡Un bot modular para moderar a los usuarios en Discord! Agregue comandos personalizados y controladores de eventos para personalizar el bot a su gusto. Recargue el bot con el comando Builtin !reload o de !reload events para ver sus cambios aplicados en vivo!

Una nota con respecto a los intentos de mensajes

Este bot solo funcionará para bots que son más pequeños, ya que requiere el uso de intentos de mensajes, que para bots más grandes requieren verificación de Discord. Esto significa que si su bot estará en más de 100 secciones, no podrá usar este método para hacer comandos y deberá codificar sus propios manejadores de comandos utilizando las nuevas interacciones.

Vea estas preguntas frecuentes de Discord con respecto a estos cambios.

Hay un plan vago para actualizar para usar los nuevos comandos basados ​​en la interacción que ofrece una experiencia de usuario más agradable, pero por ahora permanecerá basado en mensajes hasta que realmente me aburra y necesite algo que hacer.

Enlaces rápidos

Agregar sus propios comandos

Agregar sus propios manejadores de eventos

Agregar su propio almacenamiento persistente

Instalación/configuración

Requisitos de instalación

• Versión de Python > = 3.8
• discord.py probado en 2.3.2
  • Instalación de Windows: python -m pip install discord.py
  • Instalación de Linux: pip3 install discord.py

Creación de una cuenta de bot con Discord

1. Vaya al portal de desarrollador de discords y cree una nueva aplicación
2. Navegue a la sección Bot y haga clic en Add a bot . Complete la información necesaria (como el nombre y una imagen si lo desea)
3. Desplácese hacia abajo hasta la sección Privileged Gateway Intents y asegúrese de seleccionar la SERVER MEMBERS INTENT y MESSAGE CONTENT INTENT . Haga clic en Guardar para que guarde sus cambios.
4. Ahora desplácese de nuevo y haga clic en el botón Reset Token , siga las indicaciones de la pantalla hasta que pueda copiar ese token. Así es como el programa iniciará sesión como esta cuenta BOT. ¡No compartas esta ficha con nadie!
5. Pegue el token recién copiado en un archivo de texto llamado token.txt en la misma carpeta que el archivo bot.py

Invitar al bot a su servidor

1. En la página de la aplicación para su bot en el portal del desarrollador de Discord, haga clic en la sección OAuth2 .
2. Ahora haga clic en la sección URL Generator en la barra lateral
3. Seleccione el alcance bot y luego seleccione el permiso Administrator en la lista de verificación de permisos BOT recientemente mostrados
4. Copie la URL desde la parte inferior y péguela en su navegador. Siga las indicaciones en pantalla para invitar el bot a su servidor. Debe ser un administrador para invitar al bot al servidor.

Ejecutando el bot

1. Abra un símbolo del sistema en el directorio raíz de los archivos BOT (donde está bot.py ) y ejecute el comando python bot.py para ejecutar el bot.
2. Debería ver alguna salida en la pantalla hablando sobre los comandos de carga e iniciar sesión como bot. Si todo funciona, ¡ahora puedes usar el bot!
3. ¡Agregue cualquier roles de moderador que desee al bot usando los comandos a continuación!

Información de bots

• Prefijo predeterminado : !
• <argument> = Argumento requerido
• [argument] = argumento opcional
• Las duraciones pueden ser un tiempo formateado que se parece a lo siguiente: ( 1w2d3h4m5s ) ​​o tiempo en segundos.
• Las duraciones también pueden usar tipos individuales como 2m o 1w por ejemplo,
• Todos los comandos requieren que esté en un rol de moderador. Consulte los comandos a continuación sobre cómo agregar o eliminar un rol de mod (requiere permiso de administrador para agregar roles de mod)
• Lea cómo obtener la identificación de usuario aquí

Comandos

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

  • Agrega, elimina la identificación de roles a la lista de roles moderadores.
  • Si desea list los roles, no necesita la identificación de roles al final.

• !mute <user ID> [reason]

  • Momete permanentemente al usuario. Debe no ser declarado manualmente.

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

  • Momete temporalmente al usuario.

• !unmute <user ID>

  • Desmuta al usuario

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

  • Prohíbe al usuario del servidor durante la duración especificada
  • Se requiere razón. Si no tiene una razón, no debe prohibirlos.

• !unban <user ID>

  • Deslizadores el usuario del servidor.

• !reload

  • Recarga el Registro de Comando para cualquier cambio que se haya realizado a los comandos

• !reload events

  • Recarga el registro de eventos para cualquier cambio que se hiciera

Cómo obtener el ID de usuario

Debes seguir la guía de discordias aquí

Pero la esencia es:

• Habilitar el modo de desarrollador en Discord
• Haga clic derecho en su nombre de usuario en el chat o en la barra lateral
• Haga clic en Copy ID

¿Problemas con comandos personalizados?

Asegúrese de que:

• Su comando es una subclase de la clase de comando base. (Use from commands.base import Command y luego defina la clase de esta manera: class MyCommand(Command): entonces es una subclase de ello)
• Tiene un async def execute(self, message, **kwargs): función para ejecutar el comando
• No tiene errores básicos de sintaxis de Python.