Discord Moderation Bot

モジュール式Discord Moderationボット

Discordでユーザーをモデレートするためのモジュラーボット！カスタムコマンドとイベントハンドラーを追加して、ボットを好みに合わせてカスタマイズします。ビルトインを使用してボットをリロード!reloadまたは!reload eventsコマンドを使用して、変更をライブで確認してください！

メッセージの意図に関するメモ

このボットは、メッセージの意図を使用する必要があるため、より小さなボットでのみ機能します。これは、より大きなボットには不和からの検証が必要です。つまり、ボットが100を超えるセバーにある場合、このコマンドを実行するこの方法を使用できず、新しいインタラクションを使用して独自のコマンドハンドラーをコーディングする必要があります。

これらの変更に関して、このFAQをDiscordのFAQを参照してください。

より良いユーザーエクスペリエンスを提供する新しいインタラクションベースのコマンドを使用するために更新する漠然とした計画がありますが、今のところは本当に退屈して何かをする必要があるまでメッセージベースのままになります

クイックリンク

独自のコマンドを追加します

独自のイベントハンドラーを追加します

独自の永続的なストレージを追加します

インストール/セットアップ

要件のインストール

• Pythonバージョン> = 3.8
• Discord.pyは2.3.2でテストされました
  • Windowsのインストール： python -m pip install discord.py
  • Linuxインストール： pip3 install discord.py

不和でボットアカウントを作成します

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スコープを選択し、新しく表示されたボット許可チェックボックスリストでAdministrator許可を選択します
4. 下部からURLをコピーして、ブラウザに貼り付けます。画面上のプロンプトに従って、ボットをサーバーに招待します。ボットをサーバーに招待するには、管理者である必要があります。

ボットを実行します

1. ボットファイルのルートディレクトリ（ bot.pyがある場合）でコマンドプロンプトを開き、コマンドpython bot.py実行してボットを実行します。
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 Guideに従う必要があります

しかし、要点は次のとおりです。

• Discordで開発者モードを有効にします
• チャットまたはサイドバーでユーザー名を右クリックします
• Copy IDをクリックします

カスタムコマンドの問題？

それを確認してください：

• あなたのコマンドは、ベースコマンドクラスのサブクラスです。 （ from commands.base import Command使用して、次のようなクラスを定義します。 class MyCommand(Command):したがって、それはそれのサブクラスです）
• async def execute(self, message, **kwargs):コマンドを実行する機能
• 基本的なPython構文エラーはありません。