Discord Bot の作り方:初心者向け完全ガイド

Beatra Custom Bot をセットアップするなら、まず必要になるのが自分自身の Discord Bot ―― トークンと正しい Intent を有効化したアプリケーションです。このガイドでは、その手順を一つずつ解説します。動画で確認したい方は、以下に完全な動画チュートリアルのリンクがあります。

🎥 動画チュートリアル: https://www.youtube.com/watch?v=qddwRsNU2X8

Discord Bot の作成は無料で、数分で完了します。以下の手順に沿って進めてください。

ステップ1 ― Discord Developer Portal を開く

https://discord.com/developers/applications にアクセスして Discord Developer Portal を開き、Discord アカウントでサインインします。ここはすべての Discord Bot が作成・管理される公式の場所です。

ステップ2 ― 新しいアプリケーションを作成する

右上の New Application をクリックします。名前を入力します(これは Bot のプロジェクト名であり、後から変更できます)。利用規約に同意し、Create をクリックすると、アプリケーションが作成されます。

ステップ3 ― Bot タブを開く

左側のサイドバーから Bot タブをクリックします。Discord がアプリケーション用の Bot ユーザーを自動的に作成します。ここで Bot のユーザー名とプロフィール画像を設定でき、これがコミュニティに表示される見た目になります。

ステップ4 ― Privileged Gateway Intents を有効化する

ここが最も重要なステップであり、最も見落とされがちなポイントでもあります。Privileged Gateway Intents までスクロールし、3つすべてをオンにしてください。

• Presence Intent
• Server Members Intent
• Message Content Intent

Beatra はコマンドを読み取るために Message Content Intent を必要とし、他の2つはサーバー全体で正しく動作するために必要です。これらがオフになっていると、Bot が起動しなかったり応答しなかったりします。有効化したら Save Changes をクリックしてください。

ステップ5 ― Bot を公開する

引き続き Bot タブで Public Bot の設定を探し、オンになっていることを確認してください。これにより、あなた自身、そして Beatra のオンボーディングフローが、招待リンクを使って Bot をサーバーに追加できるようになります。オフのままだと自分以外は追加できず、セットアップが失敗する可能性があります。

ステップ6 ― トークンをコピーする

Bot タブの上部にある Reset Token をクリックし、確認します。Discord は Bot トークンを一度だけ表示します。Copy をクリックしてコピーしてください。

⚠️ トークンは絶対に秘密にしてください。 トークンを持つ人は誰でもあなたの Bot を完全に操作できます。共有したり、公開の場に投稿したりしないでください。万が一漏えいした場合は、ここに戻ってリセットしてください。Beatra はトークンを完全に暗号化して保存し、二度と表示することはありません。

ステップ7 ― Beatra に貼り付ける

Beatra Custom Bot のオンボーディング画面に戻り、トークン欄にトークンを貼り付けます。Beatra は次に進む前に、トークンの検証と Message Content Intent が有効になっているかのチェックを行います。Intent に関するエラーが表示された場合は、ステップ4に戻って Intent を有効化し、保存してから再度お試しください。

よくある問題

• 「Message Content Intent is disabled」 ― ステップ4を飛ばしています。3つの Intent をすべて有効化して保存してください。
• 「Invalid token」 ― トークンが正しくコピーされていないか、その後リセットされています。もう一度リセットして、新しいトークンをコピーしてください。
• Bot をサーバーに追加できない ― Public Bot がオフになっている(ステップ5)か、そのサーバーで「Manage Server」権限を持っていません。

完了です

トークンの検証が完了すると、Beatra が Bot をセットアップし、招待リンクを発行します。これで、あなたの Custom Bot はあなた自身の名前のもとで Beatra のフル機能を提供できるようになります。この機能自体について詳しく知りたい方は、Introducing Custom Bot をご覧ください。