Discordボットの作り方を徹底解説！開発者ポータルでの登録からコード作成・サーバー追加まで

オリジナルのDiscordボットを作成すると、コミュニティサーバーをより楽しく活気ある場所にできます。自分が不在の間も、ボットがメンバー同士のやり取りを代わりに管理してくれるのが魅力です。例えば、迷惑行為を行うユーザーが現れたら、ボットが自動的にキックすることも可能です。

ボットを作るには、最低限のプログラミング知識と、ボットを作成してサーバーに追加するまでの手順を理解しておく必要があります。このガイドでは、わかりやすいスクリーンショット付きで、やるべきことを順番に解説していきます。

開発者ポータルでDiscordボットを作成する

まず自分のDiscordアカウントにログインし、開発者ポータル（Developer Portal）へアクセスします。ここで新しいボット用の「アプリケーション」を作成できます。

アプリケーションに好きな名前を入力して「Create」をクリックしましょう。

次のステップでは、このアプリケーションの概要などの詳細情報を入力します。アプリアイコンも設定できるので、お好みの画像を選んでください。入力後は忘れずに変更を保存しましょう。

続いて、ポータルの「Build-A-Bot」機能を使ってボットを追加します。

アプリへのボット追加について同意を求められるので、「Yes, Do It!」を選択します。なお、この操作は取り消せないので注意してください。

以上の手順を完了すると、ボットがひとつ作成されます。ただし、この段階ではまだ公開・共有できる状態ではありません。追加情報を設定する必要があります。

次に、ボットに持たせる権限のチェックリストを作りましょう。管理者権限は与えないのが鉄則です。管理者権限を持つボットはサーバーそのものを操作できてしまうためです。一方で、メンバーのミュートやBAN、発言者の優先設定、リアクションの追加、リンクの埋め込み、ニックネームの管理など、さまざまな権限は自由に付与できます。付与した各権限には固有のIDが割り振られており、ダッシュボード上で確認可能です。

Discordボットのコードを作成する

プログラミング経験があるなら、ボットの機能をかなり細かくカスタマイズしたくなるはずです。この記事では、JavaScriptの実行環境であるNode.jsを使って解説します。Windowsにインストールした後、「Additional Tools」（追加ツール）も入れておくと便利です。コマンドターミナルから直接インストールでき、Windows PowerShell経由でChocolateyやVisual Studioなどが必要なプログラムがまとめて導入されます。

Node.js（Windows x64版）をダウンロード・インストールしたら、スタートメニューから「Node.js command prompt」を起動します。別のNode.jsアプリケーションファイルは用途が異なるため、実行しないように注意してください。

Node.jsの環境が整ったら、次のコマンドで音声対応のdiscord.jsをインストールします。

npm install discord.js @discordjs/opus

作成されたパッケージ数とともに成功ステータスが表示されればOKです。

続いて、ファイルの変更を自動検出して再起動してくれるnodemonもインストールしておきましょう。

npm i -g nodemon

ここで、開発者ポータルのページに戻り、ボットのトークンを確認します。「Click to Reveal Token」のアイコンをクリックすると英数字のキーが表示されます。これがあなたのボットの管理者キー（トークン）です。トークンを知られると第三者にボットを乗っ取られる恐れがあるため、絶対に他人と共有しないでください。

次に、Discord公式サイトに掲載されているサンプルコードを確認します。

const Discord = require('discord.js');
const client = new Discord.Client();
client.on('ready', () => {
    console.log(`Logged in as ${client.user.tag}!`);
});
client.on('message', msg => {
    if (msg.content === 'ping') {
        msg.reply('pong');
    }
});
client.login('token');

コード最終行の「token」部分を、先ほど取得した自分のボットのトークンに置き換えます。このサンプルは「ping」と入力すると「pong」と返信するシンプルな動作確認用のコードです。

ファイルを「index.js」という名前で保存します。保存場所は、コマンドプロンプトから直接アクセスできるフォルダならどこでも構いません。ファイル名は「.js」拡張子さえ付いていれば自由に決められます。

準備ができたら、次のコマンドでボットを実行します。

nodemon --inspect "file name".js

正常に起動すると、Node.jsがあなたをDiscord APIにログインさせます。また、Node.jsにはエディタモードもあり、「.help」オプションからアクセスできます。ここでボットにさらなる編集を加えていくことになります。

補足： discord.jsはバージョン13以降でAPI仕様が大幅に変更されています。最新版（v14系）を使用する場合は、イベント名やクラス構成が本記事のサンプルと異なるため、必ず公式ドキュメントの記述に合わせてコードを読み替えてください。

ボットを自分のサーバーに追加する

ボットの作成が完了したら、次は自分のDiscordサーバーに招待しましょう。そのために必要なのは、以下のような形式のURLです。

https://discordapp.com/oauth2/authorize?client_id=123456789012345678&scope=bot

URL内の「client_id」は、開発者ポータルの「General Information」欄で確認できます。ボットを保存したアプリケーションのページに表示されているので、そこからコピーしましょう。

下のスクリーンショットは、最初のセクションで作成したボットのクライアントIDが表示された画面です。

ブラウザを開き、上記のリンクにアクセスします。URLのクライアントID部分を自分のものに差し替えるだけでOKです。認証画面で、ボットを追加したいサーバーを選択できます。

認証が完了すると「Authorized」というメッセージが表示され、アプリがDiscordサーバーに接続されたことがわかります。Windows版のDiscordアプリをインストールしている場合は、システムトレイにも通知が表示されるはずです。

これで、作成したボットが無事にDiscordサーバーへ追加されました。

Discordボットは、サーバーへの関心を高めるためのインタラクティブな仕組みとして非常に有効です。カスタムボットの詳しい扱い方については、Discord公式の開発者ドキュメントも参考にしてみてください。

あなたは独自のDiscordボットを作ったことはありますか？　どんな用途で使っていますか？　ぜひコメント欄でアイデアをシェアしてください。