MOMOPARK

Deno は、JavaScript/TypeScript ランタイム環境です。

Deno で Discord Bot を実装するにあたりやったことを文章として書き起こしました。

Deno で Bot を開発する参考になればうれしいです。

趣味で『クトゥルフ神話TRPG』というゲームを遊んでいます。進行役となる「キーパー」と「プレイヤー」がともに会話して物語を進める遊びです。

クトゥルフ神話TRPGとは？ | クトゥルフ神話TRPG | KADOKAWA

クトゥルフ神話TRPGとは？ 『クトゥルフ神話TRPG』とはごく普通の人々が恐るべきクトゥルフ神話の脅威に立ち向かう、神秘と恐怖のTRPG（テーブルトーク・ロールプレイングゲーム）です。 TRPGと…

https://product.kadokawa.co.jp

プレイヤーは、ルールブックをもとにゲームに参加するキャラクターの設定値を書き込む「キャラクターシート」を作成します。

【初心者向け】能力値からわかる“クトゥルフ神話TRPG”入門！新版で探索者を創造しよう！ | クトゥルフ神話TRPGの楽しみ方 | クトゥルフ神話TRPG | KADOKAWA

これから”クトゥルフ神話TRPG”を始めようとする初心者は「どこから始めたらいい？」「いろいろな用語がわからない」など悩んでしまう人も多いはず。　この記事では、入門ルールである『新クトゥルフ…

https://product.kadokawa.co.jp

キャラクターシートを作成したあとは、ゲームが始まる前にキーパーさんにキャラクターの設定値に気になるところがないかなどをチェックしてもらうのが慣例になっています。文脈が異なりますが、アプリケーション開発でいうところのPull Request に対してレビューをもらうようなイメージですかね。

さて自分がプレイヤーとしてよくやらかしてしまうミスに、「技能値の振り忘れ」があります。

キャラクターシートを提出する前に頑張ってチェックすれば防げるミスではあるのですが、
せっかくプログラミングに慣れ親しんでいるので、仕組みで解決してみようと思いました。

そこで、キャラクターシートの技能値をチェックする Discord bot を実装しました。

詳しい実装はリポジトリを参照してください。

オンラインでキャラクターシートを保管できるサービスがいくつか公開されていて、私はCharaeno(キャラエノ)を利用しています。Charaeno の API を使って、キャラクターシートのURLをもとにキャラクターシートのデータを取得しています。

Charaeno | 新クトゥルフ神話TRPG対応のキャラシ保管所

Charaenoは新クトゥルフ神話TRPGとクトゥルフ神話TRPGのキャラクターシート保管所です。ココフォリアへのコマ自動作成やクイックスタート・ルールに対応しています。

https://charaeno.com

1. ユーザーが Discord Bot にスラッシュコマンド、条件値、キャラクターシートのURLを渡す
   • /check こぶし>=70,回避>=30 https://charaeno.com/6th/{id}
2. 条件値にしたがって評価する
3. Discord Bot がユーザーに評価結果を返す

オンラインでクトゥルフ神話TRPGを遊ぶときは、ツールとして Discord を使うことが多いです。自分もDiscordを多用していることと、Deno を使って Bot を作った経験がなく触ってみたかったことから、今回は Discord Bot として実装しました。Botを作成し、テストを書いて、デプロイするところまでやりました。

Denoでアプリケーションを作るのは初めてだったので、Denoの公式ドキュメントのQuick Startから始め、必要に応じて参照しつつ実装を進めていきました。Deno で Discord Bot を構築するにあたり、Discord APIライブラリの Discordeno を使用しています。

JavaScript、TypeScriptについても普段業務では触っておらずあまり知識がなかったので、基本的な文法についてはJavaScript PrimerやプログラミングTypeScriptなどの書籍を参照しました。

ユーザー入力を受け取って何かしらの返答を返すような簡単なBotを作った経験が何度かあり、言語が違ったとしても実装の流れは大まかに把握できていたので、あまりつまづくことなく進められたかなと思います。

Denoでは、ビルトインでリンター、コードフォーマッター、テストの仕組みが入っていて、やりたいことに即座にとりかかれたのがたいへん開発体験が良かったです。

deno taskコマンドを使用して任意の定義したタスクを実行できます。

deno.json configuration file | Deno Docs

Deno supports a configuration file that allows you to customize the built-in

https://docs.deno.com

環境変数の定義は Deno.env APIが提供されています。

Environment variables | Deno Docs

There are a few ways to use environment variables in Deno:

https://docs.deno.com

デプロイには Deno Deploy を使いました。デプロイに利用するための GitHub Actions テンプレートをデフォルトで作成してくれたのが便利でした。

Deno Deploy | Deno

Run JavaScript, TypeScript, and WebAssembly at the edge, worldwide.

https://deno.com

Discordeno のリポジトリには example テンプレートがあるのですが、内容がやや古いところがあります。example をベースに、Discordeno の公式ドキュメントや Discordeno 本体の実装を読みながら調整していく必要がありました。

ちょっとした Bot をつくるのに Deno はとても便利でした。JavaScript や TypeScript は入門した程度、Deno はほぼ触ったことがない状態でしたが、ドキュメントのおかげで実装しやすかったです。今後も Bot をつくることになったら、Deno を利用すると思います。

• Deno Docs
  • Denoの使い方がわかりやすく解説されています。Quick Start, Basics, Testing などを中心に一通り読みました。
• Discordeno Docs
  • Discordeno のドキュメントです。Usageを参考にしました。
• Charaeno 開発者向け情報
  • APIの使い方、インターフェース定義を参考にしました。
• Deno標準モジュール解説
  • Stubの書き方を学びました。