Discord Moderation Bot

Модульный бот модерации разногласий

Модульный бот для модерирования пользователей при Discord! Добавьте пользовательские команды и обработчики событий, чтобы настроить бот по вашему вкусу. Перезагрузить бот, используя команду Builtin !reload или !reload events чтобы увидеть ваши изменения вживую вживую!

Примечание, касающееся сообщений

Этот бот будет работать только для ботов, которые меньше, так как это требует использования сообщений, которые для более крупных ботов требуют проверки от Discord. Это означает, что если ваш бот будет в более чем 100 северо -коричке, вы не сможете использовать этот метод выполнения команд и потребуется кодировать свои собственные обработчики команды, используя новые взаимодействия.

Смотрите этот FAQ от Discord в отношении этих изменений.

Существует смутный план обновления для использования новых команд на основе взаимодействия, которые предлагают более приятный пользовательский опыт, но сейчас он останется на основе сообщений, пока мне не станет скучно, и мне нужно чем -то сделать

Быстрые ссылки

Добавление собственных команд

Добавление собственных обработчиков событий

Добавление собственного настойчивого хранилища

Установка/установка

Установка требований

• Версия Python > = 3.8
• Discord.py проверяется на 2.3.2
  • Установка Windows: python -m pip install discord.py
  • Установка Linux: pip3 install discord.py

Создание учетной записи бота с Discord

1. Перейдите на портал разработчиков Discord и создайте новое приложение
2. Перейдите в раздел Bot и нажмите Add a bot . Заполните необходимую информацию (например, имя и изображение, если хотите)
3. Прокрутите вниз в раздел Privileged Gateway Intents и обязательно выберите SERVER MEMBERS INTENT и MESSAGE CONTENT INTENT . Нажмите Сохранить, чтобы это сохраняло ваши изменения!
4. Теперь прокрутите обратно и нажмите кнопку Reset Token , следите за подсказками экрана, пока не сможете скопировать этот токен. Вот как программа войдет в систему в качестве этой учетной записи бота. Не делитесь этим токеном ни с кем!
5. Вставьте недавно скопированный токен в текстовый файл, вызываемый token.txt в ту же папку, что и файл bot.py

Приглашение бота на ваш сервер

1. На странице приложения для вашего бота в портале разработчика Discord нажмите на раздел OAuth2 .
2. Теперь щелкните раздел URL Generator на боковой панели
3. Выберите «Область bot , а затем выберите «Разрешение Administrator в недавно отображенном списке флажков разрешений бота
4. Скопируйте URL снизу и вставьте его в свой браузер. Следуйте на экране подсказок, чтобы пригласить бота на ваш сервер. Вы должны быть администратором, чтобы пригласить бота на сервер.

Запуск бота

1. Откройте командную строку в корневом каталоге файлов BOT (где есть bot.py ) и запустите команду python bot.py чтобы запустить бот.
2. Вы должны увидеть некоторые выводы на экране, говорящий о загрузке команд и входа в систему как бот. Если все это работает, теперь вы можете использовать бот!
3. Добавьте любые роли модератора, которые вы хотите, чтобы бот, используя команды ниже!

BOT Информация

• Префикс по умолчанию !
• <argument> = требуемый аргумент
• [argument] = необязательный аргумент
• Продолжительность может быть либо форматированным временем, которое выглядит как следующее: ( 1w2d3h4m5s ), либо время за считанные секунды.
• Продолжительность может также использовать отдельные типы, например, 2m или 1w например,
• Все команды требуют, чтобы вы находились в роли модератора. См. Ниже команды о том, как добавить или удалить роль мода (требуется разрешение администратора для добавления ролей мод)
• Прочтите, как получить идентификатор пользователя здесь

Команды

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

  • Добавляет, удаляет идентификатор роли в список ролей модератора.
  • Если вы хотите list роли, вам не нужен идентификатор роли в конце.

• !mute <user ID> [reason]

  • Постоянно связывает пользователя. Должен быть незамеченным вручную.

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

  • Временно смягчить пользователя.

• !unmute <user ID>

  • Ниже приведет пользователя

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

  • Запретить пользователю с сервера на указанное время
  • Причина требуется. Если у вас нет причины, вы не должны запрещать их.

• !unban <user ID>

  • Отказ от пользователя с сервера.

• !reload

  • Перезагружает реестр команд для любых изменений, которые были внесены в команды

• !reload events

  • Перезагружает реестр событий для любых изменений, которые были внесены

Как получить идентификатор пользователя

Вы должны следовать руководству по депозитам здесь

Но суть:

• Включить режим разработчика в Discord
• Щелкните правой кнопкой мыши их имя пользователя в чате или на боковой панели
• Нажмите Copy ID

Проблемы с пользовательскими командами?

Убедитесь, что:

• Ваша команда - это подкласс базового командного класса. (Используйте from commands.base import Command , а затем определите класс, как это: class MyCommand(Command): Так что это подкласс)
• Он имеет async def execute(self, message, **kwargs): функция для выполнения команды
• У него нет основных ошибок синтаксиса Python.