BCDice-API

BCDiceを提供するWebAPIサーバー

Public servers

有志によって運営されている公開サーバーの一覧

https://api-status.bcdice.org/

What is BCDice

BCDiceは日本のTRPGセッションツールにおいて、デファクトスタンダードとも言えるダイスロールエンジンです。初めは、Faceless氏によってPerlを用いて作成されました。後に、たいたい竹流氏によってRubyへの移植され、現在までメンテナンスされています。

BCDiceはどどんとふをはじめとして、TRPGオンラインセッションSNSやOnset!においてダイスロールエンジンとして使われています。

Setup

$ git clone https://github.com/bcdice/bcdice-api.git
$ cd bcdice-api
$ git checkout `git describe --abbrev=0` #直近のリリースに移動
$ git submodule init
$ git submodule update
$ bundle install

Run

Development

$ bundle exec rackup

Production

$ APP_ENV=production bundle exec rackup -E deployment

実際に運用する場合には、Pumaの利用をお勧めします。

公開サーバーとして運用する場合、 /v2/admin の情報を設定するようにしてください。

/v2/admin 設定方法

API

/v2

Method	Description
/v2/version	BCDiceとAPIサーバーのバージョン
/v2/admin	APIサーバ提供者の名前と連絡先
/v2/game_system	ゲームシステムの一覧
/v2/game_system/{id}	ゲームシステムの情報
/v2/game_system/{id}/roll	ダイスロール
/v2/original_table	オリジナル表の実行

Plugin

plugins/ ディレクトリにダイスボットのコードを入れておくと、サーバー起動時にロードし、使うことができます。既存のダイスボットを上書きすることもできます。

Documents

Herokuで独自ダイスボット入りのBCDice-APIサーバーを立てる (中級者向け)

Cases

discord-bcdicebot
Line botでダイスを振る - Qiita
HTTPS版BCDice-API | 大ちゃんのいろいろ雑記 : どどんとふ公式鯖による公開サーバー
オンラインセッションツール – Hotch Potch . : えいむ氏による公開サーバー

Donate

Amazonほしい物リスト
Amazonギフト券宛先: ysakasin@gmail.com

The Auther

酒田　シンジ (@ysakasin)

bcdice / bcdice-api

readme