Pythonで簡易的なDiscordのBotを作成する

discord.pyを使って、決まったメッセージに返事をするだけの簡単なDiscordのBotを作ります。Pythonの開発環境がまだない場合は、以下の記事を参考にしてください。

macOSにPythonの開発環境を構築する

VS CodeでPythonを書くために、以下の拡張機能を入れておきます。

Python - Visual Studio Marketplace⁠（新しいタブで開く）

Pylance - Visual Studio Marketplace⁠（新しいタブで開く）

1. Discord Developer Portal⁠（新しいタブで開く）にアクセスし、右上の[New Application]を押して新しいアプリケーションを作成します。

   

   右上の[New Application]を押す

2. NameにBotの名前を設定し、規約とポリシーの同意にチェックを入れてから[Create]を押します。

   

   NameにBotの名前を入れ、同意にチェックして[Create]を押す

3. Botメニューから「TOKEN」セクションの[Reset Token]を押します。アカウントのパスワードを入力するとTOKENが表示されるので忘れずにメモしておきます。トークンがあれば誰でもこのBotを操作できてしまうので、他人に教えたり、GitHubなどに公開したりしないでください。

   

   [Reset Token]を押してトークンを発行する

4. Botメニューから「Privileged Gateway Intents」セクションの「MESSAGE CONTENT INTENT」にチェックを入れてください。Botがメッセージの本文を読むために必要な設定です。

   

   「MESSAGE CONTENT INTENT」をオンにする

VS Codeで新規プロジェクトを作成します。今回は「discord-bot-test」というフォルダにしています。

1. プロジェクトの依存関係を管理しやすくするために、Pythonの仮想環境を作成してアクティベートします。

   コマンドを実行するとvenvフォルダが作成されます。

   ターミナルbash · 5行折り返すコピー（ターミナル）

   # 仮想環境を作成$python3 -m venv venv# 仮想環境をアクティベート$source venv/bin/activate

2. Discord Botの開発に必要なdiscord.py⁠（新しいタブで開く）をインストールします。

   ターミナルbash · 2行折り返すコピー（ターミナル）

   # discord.py ライブラリをインストール$pip install discord.py

1. プロジェクトのルートディレクトリに.envを作成します。

   Discord Botのセットアップ時に取得したトークンを=の右側に指定してください。

   .env.env · 1行折り返すコピー（.env）

   .env

   1DISCORD_BOT_TOKEN=あなたが取得したトークン

   Gitで管理する場合は、.envとvenvを.gitignoreに書いて、リポジトリに含めないようにします。

2. python-dotenv⁠（新しいタブで開く）をインストールして、.envから環境変数を読み込めるようにします。

   ターミナルbash · 2行折り返すコピー（ターミナル）

   # python-dotenv パッケージをインストール$pip install python-dotenv

3. プロジェクトのルートディレクトリにbot.py（任意のファイル名でOK）を作成します。
4. 以下のテストコードを記述します。

   bot.pyPython · 36行折り返すコピー（bot.py）

   bot.py

   1from dotenv import load_dotenv2import os3import discord45# .envファイルから環境変数を読み込む6load_dotenv()78# 環境変数からトークンを取得する9TOKEN = os.getenv('DISCORD_BOT_TOKEN')1011# 既定のインテント（特権インテント以外）を有効にしたIntentsオブジェクトを作成12intents = discord.Intents.default()13intents.message_content = True # メッセージの内容を受け取る（MESSAGE CONTENT INTENTが必要）1415# Discordのクライアントを作成16client = discord.Client(intents=intents)1718@client.event19async def on_ready():20  print(f'{client.user}としてログインしました')2122@client.event23async def on_message(message):24  # Bot自身のメッセージには反応しないようにする25  if message.author.bot:26    return27  28  # 'Botさん、こんにちは！'というメッセージに反応する29  if message.content == 'Botさん、こんにちは！':30    # メッセージ送信者の表示名を取得31    user_name = message.author.display_name32    # 応答するメッセージを作成33    response = f'こんにちは、{user_name}さん！'34    await message.channel.send(response)3536client.run(TOKEN)

   残り20行を表示

1. Discordの左にある+アイコンをクリックします。
2. 「オリジナルの作成」を選択します。

   

   「オリジナルの作成」を選択します。

3. とりあえずサーバーを作成したいだけなので「この質問をスキップ」を選択します。

   

   質問には答えずスキップします。

4. 任意のサーバー名を入れて「新規作成」を押します。

   

   サーバー名を入力します。

1. Discord Developer Portal⁠（新しいタブで開く）にアクセスし、左のメニューから[OAuth2]タブを選択します。
2. 「OAuth2 URL Generator」セクションにある「bot」にチェックを入れてスコープに追加します。

   

   SCOPESで「bot」にチェックを入れる

3. すると下にさらに項目が出てくるので、「BOT PERMISSIONS」セクションで必要な権限にチェックを入れます。

   今回は「Read Messages/View Channels」（メッセージを読む/チャンネルを見る）と「Send Messages」（メッセージを送信する）にチェックを入れます。

   

   「Read Messages/View Channels」と「Send Messages」にチェックを入れる

4. 最後に「GENERATED URL」セクションにURLが生成されるので、コピーしてそのURLにアクセスします。
5. 「サーバーに追加」の項目に先ほど作成したテストサーバーが出てくるのでそれを選択して、「はい」を選択します。

   

   サーバーを選択して次に進みます。

6. 次の項目もそのまま「認証」を押します。

   

   そのまま認証を押します。

7. Discordを見るとサーバーにBotがやってきました。

   

   サーバーにBotが追加された

「Botさん、こんにちは！」と送信するとBotが「こんにちは、<ユーザー名>さん！」と返すプログラムを書いたので動作するか確認します。

1. bot.pyを開いた状態でVS Codeの画面右上の▷を押すと、画面下部にターミナルが表示され、ファイルが実行されます。ターミナルでpython bot.pyを実行しても同じです。ターミナルに「〇〇としてログインしました」と表示されれば、Botが起動しています。

   

2. Discordに「Botさん、こんにちは！」と送信し、「こんにちは、<ユーザー名>さん！」と返ってくればテスト完了です。

   

• ゲートウェイインテント入門⁠（新しいタブで開く）