2024年9月10日 - @asami@trpger.usの投稿

BCDice-API provided by TRPGer.us
の提供を始めました。

Q.BCDiceってなあに？

日本で最も使われている、TRPG用ダイスロール処理システムです。どどんとふ、ココフォリア、ユドナリウム、TRPGスタジオなど様々なオンセツールで使われています。

Q.APIってなあに？

BOTやWebサイトなど、プログラムの中にBCDiceを取り入れたいときに便利な連携システムのこと

Q.BCDice-API provided by TRPGer.usってなあに？

BCDiceをプログラム（BOTやWebサイト）で使いたいさんむけに、
卓すきーが提供するAPIのこと。

Q.利用するための条件は？

であれば誰でもどうぞ。

※負荷実験をしていないので落ちるとかあれば言って下さい。ちゃんと実装します。

【仕様】

エンドポイント:
https://bcdice.trpger.us

バージョンは以下の通り。
api: 3.0.0
bcdice: 3.13.0
https://bcdice.trpger.us/v2/version

【使い方】

※試すときはアドレス直打ち推奨。misskeyのリンクから飛ぶとForbiddenに。

①ゲームシステム一覧を調べる：
https://bcdice.trpger.us/v2/game_system

②振りたいシステムのダイス情報を見る：https://bcdice.trpger.us/v2/game_system/システム名

例：

のダイス情報を見たい。
https://bcdice.trpger.us/v2/game_system/Cthulhu7th

{"ok":true,
"id":"Cthulhu7th",
"name":"新クトゥルフ神話TRPG",
"sort_key":"しんくとうるふしんわTRPG",
"command_pattern":"^S?([+\\-(]*(\\d+|D\\d+)|\\d+B\\d+|\\d+T[YZ]\\d+|C[+\\-(]*\\d+|choice|D66|(repeat|rep|x)\\d+|\\d+R\\d+|\\d+U\\d+|BCDiceVersion|CC|CBR|FAR|BMR|BMS|FCL|FCM|PH|MA)",
"help_message":"・判定　CC(x)<=（目標値）\n　x：ボーナス・ペナルティダイス。省略可。\n　目標値が無くても1D100は表示される。\n　ファンブル／失敗／　レギュラー成功／ハード成功／\n　イクストリーム成功／クリティカル を自動判定。\n　例）CC<=30　CC(2)<=50 CC(+2)<=50 CC(-1)<=75 CC-1<=50 CC1<=65 CC+1<=65 CC\n\n・技能ロールの難易度指定　CC(x)<=(目標値)(難易度)\n　目標値の後に難易度を指定することで\n　成功／失敗／クリティカル／ファンブル を自動判定する。\n　難易度の指定：\n　　r:レギュラー　h:ハード　e:イクストリーム　c:クリティカル\n　例）CC<=70r CC1<=60h CC-2<=50e CC2<=99c\n\n・組み合わせ判定　(CBR(x,y))\n　目標値 x と y で％ロールを行い、成否を判定。\n　例）CBR(50,20)\n\n・自動火器の射撃判定　FAR(w,x,y,z,d,v)\n　w：弾丸の数(1～100）、x：技能値（1～100）、y：故障ナンバー、\n　z：ボーナス・ペナルティダイス(-2～2)。省略可。\n　d：指定難易度で連射を終える（レギュラー：r,ハード：h,イクストリーム：e）。省略可。\n　v：ボレーの弾丸の数を変更する。省略可。\n　命中数と貫通数、残弾数のみ算出。ダメージ算出はありません。\n例）FAR(25,70,98)　FAR(50,80,98,-1)　far(30,70,99,1,R)\n　　far(25,88,96,2,h,5)　FaR(40,77,100,,e,4)　fAr(20,47,100,,,3)\n\n・各種表\n　【狂気関連】\n　・狂気の発作（リアルタイム）（Bouts of Madness Real Time）　BMR\n　・狂気の発作（サマリー）（Bouts of Madness Summary）　BMS\n　・恐怖症（Sample Phobias）表　PH／マニア（Sample Manias）表　MA\n　【魔術関連】\n　・プッシュ時のキャスティング・ロール（Casting Roll）の失敗表\n　　強力でない呪文の場合　FCL／強力な呪文の場合　FCM\n"}

③ダイスを振る：https://bcdice.trpger.us/v2/game_system/システム名/roll?command=

例：

の感情表（FT)が振りたい。
https://bcdice.trpger.us/v2/game_system/Insane/roll?command=FT

の2DM<=5が振りたい。
https://bcdice.trpger.us/v2/game_system/Emoklore/roll?command=2DM<=5

DiceBotで1D100が振りたい。
https://bcdice.trpger.us/v2/game_system/DiceBot/roll?command=1D100

#管理人からのお知らせ