この記事は公開から3年以上が経過しています。内容が古くなっている場合があります。
こんにちは。 最近Discordを使用してセッションする方が増えたようで嬉しい限りですね。 私の周りでも「このBotの入れ方教えて下さい!」と聞かれる機会が多くなったので、図を入れつつなるべくわかりやすいようにまとめておきます。
記事は【BCDice3.3.0】 【discord-bcdicebot v2.3.0】時点のもので、Windows10で操作しています 異なるバージョン、OSによっては動作が変わる場合があります。
関連記事
- DiscordでDiceBot(BCDice)を使う方法 その1 ←今ここ
Bot作成から起動までの説明記事 - DiscordでDiceBot(BCDice)を使う方法 その2
起動後に使えるコマンド・オリジナルダイスボット表の入れ方等の説明記事
BCDiceとは
日本で最も使われている、TRPG用ダイスロール処理システムです。 どどんとふ、ココフォリア、ユドナリウム、TRPGスタジオなど様々なオンセツールで使われています。 対応ゲーム一覧にかかれているシステムは100を超え、現在も更新が盛んに行われています。
TRPGのオンセツールを使ったことがある方は一度ぐらいは触ったことがある、親しみ深いツールです。 BCDice - https://bcdice.org/ より引用
準備
必要なもの
- java
- DiceBot使用する画像
これは必須ではありませんが、Discordに表示されるのでわかりやすいものがいいと思います
使用するツール
- discord-bcdicebot
しゅんしゅんひよこ(@Shunshun94)さんのDiceBotです
使い方を参考にしてDiceBotをDiscordサーバーに導入していきます - BCDice-API
酒田 シンジ(@ysakasin)さんが開発されているココフォリア、Udonarium、TekeyなどTRPGツールで使われているBCDiceが使えるようになるものです
公開サーバーの一覧の中にあるURLを使うので、自分でこれから設置する必要等はありません - Discord
Discordは、Windows・macOS・Linux・Android・iOS・Webブラウザで動作する、ビデオ通話・音声通話・VoIPフリーウェアです
自分が管理権限を持っているサーバーを用意して、その中にDiceBotを入れていきます
操作はWindows10で行っています
Mac/LinuxOSの方への対応はQ&Aに書いてありますので参照してみて下さい
(Mac/Linuxの検証はできていないので、動いた/動かないの意見いただけるとありがたいです)
Bot作成~起動まで
まずはDiscordに新規のBotを作成するところから始めていきます。
Botを作成する
Botに名前をつける
Now Loading
- DiscordのDEVELOPER PORTAL にアクセスしてログイン 右上にあるNew Applicationsをクリック
Now Loading
- CREATE AN APPLICATIONという画面のNAMEに任意のアプリケーション名を入力してCreateをクリック
アイコンとプロフィールを設定する
Now Loading
- General InformationにあるAPP ICON(画像黄色)で任意の画像を設定
- DESCRIPTION(画像青色)部分に任意の説明文章を記入(400文字以内)
この説明はBotのプロフィール画面に表示されます - 編集し終わったら、Save Changesをクリック
Botユーザを作成する
Now Loading
- SETTINGSのBotをクリック
-
BotにあるBuild-A-BotのAdd Botをクリック ADD A BOT TO THIS APP?という画面のYes, do it!をクリック
※2024年6月19日追記: Add Botボタンが不要になったので削除しました。
MESSAGE CONTENT INTENTをオンにする
2024年6月19日追記
Botのページ中央下にあるMESSAGE CONTENT INTENTをオンにしてくださいNow Loading
TOKENをコピーして保管しておく
Now Loading
- Build-A-Botに表示されたTOKEN部分のCopyをクリック
このTOKENはメモ帳などに貼り付けておいてください(TOKENの文字は他の人に教えないでください)
APPLICATION IDをコピーしてアクセス
Now Loading
- SETTINGSのGeneral Informationをクリック
- APPLICATION IDのCopyをクリック
- https://
discordapp.com /oauth2/authorize?client_id=[APPLICATION ID]&scope=bot&permissions=0 にアクセス
- コピー用
- 例: APPLICATION IDが123456789の場合
https://discordapp.com /oauth2/authorize?client_id=123456789&scope=bot&permissions=0
サーバーを選択して導入する
Now Loading
- 自分が管理権限を持つ、Botを入れたいサーバーを選択して認証をクリック - Discord – サーバーの作り方と削除する方法
Now Loading
DiscordでサーバーにDiceBotが追加されているか確認します
※Botはオフライン状態で大丈夫です
これでBot作成は完了です
discord-bcdicebotを設定・起動する
ファイルをダウンロードする
Now Loading
- discord-bcdicebotにアクセスし、概要にあるDOWNLOADをクリック
Googleドライブのダウンロードボタンをクリック
※2024年5月20日追記: Googleドライブではなく、直接DLできるようになっていたので削除しました。- ダウンロードしたファイルを解凍して開く
start.batを編集する
Now Loading
- start.batファイルを右クリックし、編集をクリック
TOKENの貼り付け
Now Loading
- Bot作成の「9.Build-A-Botに表示されたTOKEN部分のCopyをクリック」でコピーしたTOKENをset DISCORD_BOT_TOKEN=に貼り付け
TOKENとAPPLICATION IDを間違えないようにしよう
- TOKEN
60文字前後のピリオドと英数字
ODY3NjkwMTM3NTA3NzI1MzQy.YPkxaQ.yzBtmH7zYQS8M6XQwomwOtgDOlQ(ダミーです) - APPLICATION ID
20文字前後の数字
123456789123456789(ダミーです) - start.batに記入するのはTOKENです
BCDice-APIのURLを貼り付け
Now Loading
- BCDice-API バージョン一覧にアクセスし、ERROR表示されていないURL(画像黄色部分のどれか)をクリックしてコピーする
選び方
画像青枠のAPIとBCDiceが最新リリースと同じものを選ぶのがいいでしょう
下記の2つのサイトがとくに更新が早いのでおすすめです
- とあるTRPG鯖
https://bcdice.onlinesession.app/ - クリエイターズネットワーク
https://bcdice.trpg.net
利用規約
使用する際は使うURLの画像赤枠部分にあるリンクへアクセスし、利用規約等をきちんと読んでから使用しましょう
- メモ帳にもどりset BCDICE_API_URL=にURLを貼り付け
その他設定
必須項目は20.までですが、これ以外にも設定できる項目があります
- REM set BCDICE_PASSWORD=
管理パスワードを設定できます PleaseChangeMeIfYouUseThisを任意のパスワードに変更して行頭の"REM "を削除します - REM set BCDICE_API_SECONDARY=
BCDICE_API_URLで指定したサイトがメンテナンス等で動かない場合に使えるURLを指定できます
http://secondary.bcdice-api.yourdomain.co.jp/ を任意のURLに変更して行頭の"REM"を削除します - REM set BCDICE_DEFAULT_SYSTEM=DiceBot
デフォルトで使うシステムを変更できます
DiceBotを任意のシステムIDに変更して行頭の"REM "を削除します IDは対応ゲームシステム一覧参照してください - REM set BCDICE_MENTION_MODE=1 ダイスを振った時に振った人にメンションされるようになります 行頭の"REM "を削除します
- メンションとは
メンションについては別サイトを参照してください
設定例
Now Loading
-
設定が終わったら保存してメモ帳を閉じる
-
start.batをダブルクリックして起動する
Now LoadingBotがオンラインになっていれば成功です
これでdiscord-bcdicebotを設定・起動するは完了です、お疲れさまでした 正しく起動できていればDiscordでダイスが振れるようになっていると思います
discord-bcdicebotの詳しい使い方は、次の記事のDiscordでDiceBot(BCDice)を使う方法 その2をご覧ください
Q&A
よくある質問まとめ
Q.MacOS/Linuxを使っている
A. Botを作成するまではWindowsと同様に行います discord-bcdicebotを設定・起動するの部分はstart.shを編集して起動して下さい 「"REM "を削除します」の部分は「"# "を削除します」に置き換えて読んで下さい
Q.Botを常に起動していたい
A. Heroku、VPS、Glitch、Google Cloud Platformを使って動かす方法などがあります。参考になる記事・サイトをいくつか挙げておきます。
無料で動かせるのはGlitchとGoogle Cloud Platformです(2024年6月時点)。
- Herokuでdiscord-bcdicebotを動かす
- discord-bcdicebot - 中級者以上向け:heroku を使って動かす手順
- Discord-BCDicebotをさくらのVPSに設置して24時間スマホからでも利用可能な自鯖Discordダイスbotを作る
- BCDiceを Discordのダイスボットにして動かす
- GCP上でDiscord用ダイスボットを動かしてみる&設定を自動化する
Q.APPLICATION IDがない
A. ClientIDなど別の名称になっている場合があります 20桁程度の数字のIDを探して試してみて下さい
Q.起動したのにオンラインにならない
A. コマンドプロンプト(start.batを起動した時に出る黒い画面)に「続行するには何かキーを押してください . . .」と表示されている場合 TOKENが間違っているかもしれません もう一度DEVELOPER PORTALアクセスしてTOKENをコピー start.batのset DISCORD_BOT_TOKEN=の横に貼り付けてみて下さい TOKENは「ODY3NjkwMTM3NTA3NzI1MzQy.YPkxaQ.yzBtmH7zYQS8M6XQwomwOtgDOlQ(ダミーです)」のような60桁程度のピリオドと英数字です
Q.Privileged Gateway Intents の MESSAGE CONTENT INTENT が ON になっていません。
A. start.batを起動したときに、Privileged Gateway Intents の MESSAGE CONTENT INTENT が ONになっていません。テキストチャットへの入力によるダイスロールはできませんと表示される場合のチェック項目
- start.batのDISCORD_BOT_TOKEN=にTOKENが正しく入力されているか確認する。
- DEVELOPER PORTALにアクセスする。
- My Applications → Bot → Botページ中央下にあるPrivileged Gateway Intents項目のMESSAGE CONTENT INTENTがONになっているかを確認する。
画像付きの説明はこちら
Q.Discordにコマンドを打つとERRORが出る
A. Discordの画面に「[ERROR]v2([BCDice-APIのURL])」と表示される場合 BCDice-APIのURLが間違っているか、サーバーメンテナンス中などで使用できない状態かもしれません。
BCDice-API バージョン一覧でERRORになっていないURLをコピーして、
DiscordでDiceBot(BCDice)を使う方法 その2 - 管理コマンドを使う - BCDice-API サーバを変更するを参照して下さい。
start.batを直接編集して編集して再起動しても大丈夫です。
質問・リンク切れ・記事への指摘等々ございましたらTwitter【えいむ(@aimsssssot)】に連絡して下さい Twitterのリプライ、DMが一番返答が早いと思います
関連記事
- DiscordでDiceBot(BCDice)を使う方法 その1 ←今ここ
Bot作成から起動までの説明記事 - DiscordでDiceBot(BCDice)を使う方法 その2
起動後に使えるコマンド・オリジナルダイスボット表の入れ方等の説明記事
使用素材・参考にさせていただいたサイト
敬称略・順不同