Discord で BCDice を使うための bot です。各サーバに対して、ユーザが導入して利用します。
このアプリは Discord のチャットに参加するユーザのうち、1人の環境で動かす必要があります。動かす人には以下の準備が求められます
Java 実行環境 のインストール方法は Javaをインストールするには をご覧ください。
BCDice-API が動作しているサーバを用意してください。ローカルでも構いませんし、貸してくれる人から借りてもかまいません。
Discord に新規の Bot を作成します。サーバ1つにつき代表者1人がいれれば大丈夫です
NDA0MgAIC0QK18lU0dxMt99F.HuWAIt.Nh9OTLbjxdMp3pcmw3Lsqd4aQlb のような形式の値となります（この値はダミーです）。Bot を起動し、 Discord 上で BCDice を利用可能にします。サーバ1つにつき代表者1人がアプリを起動すれば大丈夫です
http://secondary.bcdice-api.yourdomain.co.jp/ を予備の BCDice-API サーバの URL に書き換えますDiceBotを利用するデフォルトのシステム名に書き換えますチャットにただただ 2d6 等と打ち込めばダイスが振られます。
各システム向けの機能を使いたい場合、ダイスボットを切り替えましょう。bcdice set [利用するダイスボットの名前] とチャット上で発言してください。
例えば bcdice set SwordWorld2.0 等です。
どんなダイスボットが利用できるのかは bcdice list と発言すれば確認できます。
各ダイスボットでどんな機能が利用できるのかを確認する際は bcdice help [ダイスボットの名前] と発言すれば表示できます。
例えば bcdice help SwordWorld2.0 等です。
ダイスを振る際にダイスコマンドの手前にダイスを振る回数を記入することでその回数分ダイスを振ることができます。例えば3 2d6とすれば3回 2d6 を振ることが可能です。
また、数字ではなく[と]でカンマ区切りのリストを与えるとそのリストのそれぞれについてダイスを振ることができます。例えば[こぶた,たぬき,きつね,ねこ] 2d6 とすることでこぶた、たぬき、きつね、ねこのそれぞれについて 2d6 を振ることが可能です。
管理者はオリジナルのランダム表を追加することもできます。詳細は管理コマンドをご確認ください。
チャットに bcdice help と打てば何ができるのかが一覧されるので困ったときは実行してみてください。
チャットに bcdice admin [パスワード] help と打てば管理者として利用できるコマンドの一覧が出力されます
接続する BCDice-API サーバを変更する場合は bcdice admin [パスワード] [BCDice-APIサーバのURL]
各部屋ごとに設定されたダイスボットの一覧を取得する場合は bcdice admin [パスワード] export
以下のような結果が得られます
331084010098917376:SwordWorld2.0 551310555730673666:DoubleCross 541477835299356673:Cthulhu
複数の部屋に対してダイスボットを設定する場合は以下のようにします。
アプリを再起動した際は全部屋のダイスボット設定がリセットされますので、import と組み合わせると原状復帰が容易です
bcdice admin [パスワード] import 331084010098917376:SwordWorld2.0 551310555730673666:DoubleCross 541477835299356673:Cthulhu
チャットに送信されたメッセージを全て BCDice-API サーバに送信したい場合は次のようにします。bcdice admin [パスワード] suppressroll disable
BCDice-API サーバに送る必要のありそうな発言だけを送信するようにする場合は次のようにします。こちらがデフォルト設定です。bcdice admin [パスワード] suppressroll on
また、先頭に /r 等が無いと BCDice-API サーバにコマンドを送信しないようにすることもできます。bcdice admin [パスワード] suppressroll /r
このコマンドワードは / で始まる物であれば任意のものを設定できます。bcdice admin [パスワード] suppressroll /diceroll
とすれば発言の戦闘に /diceroll があるものだけを BCDice-API サーバに送信します。
独自のダイスボットを追加する場合は Discord にダイスボットの情報をアップロードし、アップロード時のコメントに次のように記載してください。bcdice admin [パスワード] addDiceBot [ダイスボット名]
追加した後ダイスボット名がチャット上で発言されるとダイスボットが振られます。この際にアップロードするダイスボットのサンプルは originalDiceBots ディレクトリ内のファイルないしはdiscord-bcdicebot/originalDiceBots/サンプルダイスボット-夜食表を参照してください。
ダイスボットを削除する際は以下のようにしてください。bcdice admin [パスワード] removeDiceBot [ダイスボット名]
ダイスボットの一覧は次のようにすると確認できます。bcdice admin [パスワード] listDiceBot
Twitter アカウントは@Shunshun94。ないしはリポジトリに issue を追加してください。
このアプリ (ソースコードなどを含む) は GPLv3 でライセンスします。
ソースコードはhttps://github.com/Shunshun94/discord-bcdicebotから入手可能です。
@Shunshun94 ないしは github の issues に。
どんな出力が出たのか、出力をコピペして頂けると調査が捗ります。
一般ユーザの PC に Ruby や○○の実行環境が導入されているとは思えなかった
Mac ユーザやら Linux ユーザやらごとにバイナリを作るのが面倒だった。 Linux はともかく Mac ユーザはいる気がしたから
start.bat の IGNORE_ERROR=0 の 0 を 1 と書き入れてみてください。治るかもしれません
環境変数BCDICE_PASSWORDの値が使われます。
環境変数を指定していない場合は起動直後に Admin Password: SGO7C0XYtBJouE75 みたいな文字列がでます。この英数字ランダム16桁の文字列がパスワードです。起動するたびに変わるので注意してください
BCDice を作成・公開してくださったFacelessさんと、 Ruby 移植をしてくださったたいたい竹流さん。 さらにメンテを引き継いでくださっている酒田 シンジさん。 そもそも、BCDice が無ければこのアプリは着想すらありませんでした。 BCDice が多機能である点、2017年現在、国内オンラインセッションツールのデファクトスタンダードであるどどんとふが採用しているダイスボットであるため、 国内におけるダイスボットのデファクトスタンダードが BCDice となっていたことが実装の必要を感じたそもそもの理由でした。
BCDice-API を実装・公開してくださった酒田 シンジさん。 BCDice-API が無ければ本アプリの実装は気が遠くなるものだったに違いありません。
発表前の動作確認に付き合ってくださったかし＊さんと離凛さん。 色々な想定漏れについて指摘していただき、公開前にアプリが大幅に改善されました。
Nanasu さんが作ってくださったBCDiscord for Browser のコマンドは本アプリの物を参考にしてくださいました。 ブラウザのみで動くため、大変に便利です。
ダイスを振るコマンド以外を入力すると [ERROR][500] ～ って出る。設定は合っているはずなのにを参照してください
BCDice-API サーバを自分で構築するのは一定の専門知識が必要です。 独自のダイスボットを追加するのでなければ、bcdice/bcdice-api-servers に記載されている公開サーバを利用する方が良いでしょう。 各公開サーバには利用ルールがあるため、利用前に事前にご確認ください。
また、中級者向けに Heroku を用いての自分用 BCDice-API サーバの設置手順も共有されています。
https://github.com/ysakasin/bcdice-api/blob/master/docs/heroku.md