Discord Moderation Bot

模块不一度的节制机器人

一个模块化机器人，用于调节Discord上的用户！添加自定义命令和事件处理程序，以将机器人自定义为您的喜好。使用内置!reload或!reload events命令重新加载机器人，以查看您应用的更改现场！

有关消息意图的注释

该机器人只能适用于较小的机器人，因为它需要使用消息意图，该机器人需要对较大的机器人进行不和谐验证。这意味着，如果您的机器人将处于100个以上的速度中，则您将无法使用这种执行命令的方法，并且需要使用新的交互作用来编码自己的命令处理程序。

关于这些变化，请参阅此常见问题解答。

有一个模糊的计划来更新使用新的基于互动的命令，该命令提供了更好的用户体验，但是目前它将一直基于消息，直到我真的很无聊并需要做一些事情

快速链接

添加您自己的命令

添加您自己的活动处理程序

添加自己的持久存储

安装/设置

安装要求

• Python版本> = 3.8
• Discord.py在2.3.2测试
  • Windows安装： python -m pip install discord.py
  • Linux安装： pip3 install discord.py

与Discord创建机器人帐户

1. 转到Discord Developer Portal并创建一个新应用程序
2. 导航到Bot部分，然后单击Add a bot 。填写必要的信息（例如名称和图像，如果您愿意）
3. 向下滚动到Privileged Gateway Intents部分，并确保选择SERVER MEMBERS INTENT和MESSAGE CONTENT INTENT 。单击保存，以节省您的更改！
4. 现在滚动滚动，然后单击Reset Token按钮，按照屏幕提示，直到您可以复制该令牌为止。这就是该程序作为此机器人帐户登录的方式。不要与任何人分享这个令牌！
5. 将新复制的令牌粘贴到与bot.py文件同一文件夹中的称为token.txt的文本文件中。

邀请机器人到服务器

1. 在“ Discord Developer Portal”中的机器人的应用程序页面上，单击OAuth2部分。
2. 现在单击侧栏上的URL Generator部分
3. 选择bot范围，然后在新显示的bot权限复选框列表中选择Administrator权限
4. 从底部复制URL并将其粘贴到浏览器中。请按照屏幕上的提示邀请机器人到您的服务器。您必须是管理员邀请机器人到服务器的管理员。

运行机器人

1. 在bot文件的根目录中打开命令提示符（ bot.py是），然后运行命令python bot.py以运行bot。
2. 您应该在屏幕上看到一些输出，讨论加载命令并登录作为机器人。如果所有这些都可以使用，现在您可以使用该机器人！
3. 使用下面的命令添加您想要的任何主持人角色！

机器人信息

• 默认前缀： !
• <argument> =必需的参数
• [argument] =可选参数
• 持续时间可以是一个格式的时间，看起来如下：（ 1w2d3h4m5s ）或以秒为单位的时间。
• 持续时间也可以使用单一类型，例如2m或1w
• 所有命令要求您担任主持人角色。请参阅下面有关如何添加或删除mod角色的命令（需要管理员的权限以添加mod角色）
• 阅读如何在此处获取用户ID

命令

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

  • 添加，将角色ID删除到主持人角色列表中。
  • 如果要list角色，则最终不需要角色ID。

• !mute <user ID> [reason]

  • 永久静音用户。必须手动无效。

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

  • 暂时静音用户。

• !unmute <user ID>

  • 解散用户

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

  • 禁止用户在指定的持续时间内从服务器中使用
  • 需要原因。如果您没有理由，则不应禁止它们。

• !unban <user ID>

  • 将用户从服务器中释放。

• !reload

  • 重新加载命令注册表，以完成对命令的任何更改

• !reload events

  • 重新加载事件注册表以进行任何更改

如何获取用户ID

您应该在此处遵循Discord指南

但是要点是：

• 在不和谐中启用开发人员模式
• 右键单击聊天或侧边栏上的用户名
• 单击Copy ID

自定义命令的问题？

确保：

• 您的命令是基本命令类的子类。 （ from commands.base import Command使用，然后定义这样的类： class MyCommand(Command):它是它的子类）
• 它具有async def execute(self, message, **kwargs):函数执行命令
• 它没有基本的python语法错误。