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語法錯誤。