BCDice API on Cloudflare Workers

BCDice APIをCloudflare Workers / Hono で動作するように、bcdice-js を利用して移植したプロジェクトです。

特徴

• Cloudflare Workers への対応: Cloudflare Workersのエッジ実行環境に対応。
• BCDice API v2 準拠: 既存のフロントエンド・クライアントとの互換性を維持。

技術スタック

• Runtime: Bun
• Platform: Cloudflare Workers
• Framework: Hono
• Core Logic: BCDice (via bcdice-js)

クイックスタート

1. 準備

リポジトリをクローンし、依存関係をインストールします。

git clone --recursive https://github.com/JanMaki/bcdice-api-cf.git
cd bcdice-api-cf
bun install

Note

bun install 時に postinstall スクリプトが走り、BCDice のパッチ適用や i18n ローダーの生成が自動的に行われます。

2. ローカル開発

開発サーバーを起動します。

bun run dev

3. テスト

bun test

4. デプロイ

bun run deploy

API 仕様

BCDice API v2 に準拠しています。 詳細な仕様については、本家リポジトリの API v2 Documentation を参照してください。

既知の問題 (Known Issues)

テストデータのTOMLパースエラー

• 対象ファイル: Aionia.toml, DoubleCross_Korean.toml, PastFutureParadox.toml, RuneQuest.toml
• 原因: BCDice v3.16.1 時点のテストデータに含まれる不備（キーの重複等）。BunのパーサーはTOML仕様に厳格なためエラーとなります。
• 詳細: この不備は BCDice の e06258b で修正されましたが、本プロジェクトが追従している v3.16.1 では未修正のままとなっている場合があります。
• 対応: テストランナー (test/dicebot.test.ts) 側でパースエラーをハンドリングし、スキップするようにしています。

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。 BCDice 自体のライセンスについては BCDice のリポジトリ を確認してください。