“WoWs Minimap Renderer”のDiscordボットを作った

World of Warships (WoWs) のリプレイファイルをDiscordで共有する際、専用クライアントを起動せずに試合展開を確認できると便利です。
そこで、リプレイファイルをアップロードするだけで、ミニマップの動きを動画化して返信するDiscordボットを作成しました。

本記事では、このボットを誰でも簡単に自身のサーバーへ導入する方法を紹介します。
個人の利用範囲であれば、Google Cloud Platform (GCP) の無料枠を活用して運用できるよう設計されています。

ボットの機能

Discord のスラッシュコマンド /render に .wowsreplay ファイルを添付して送信すると、クラウド上で自動的にリプレイを解析し、数分後にミニマップの戦況遷移を動画として返信します。

クラウドサービスを利用するためコストが懸念されますが、本ボットは以下の構成により費用を抑えています。

待機中は0円: ボットのフロントエンド (Google App Engine) は、リクエストがない時は無料枠内で収まるインスタンスクラスを使用します。
オンデマンド実行: 動画生成を行う負荷の高い処理 (Cloud Run) は、リクエストがある時だけ起動し、処理完了後は直ちに停止します。

これにより、「個人やクランでの通常利用であれば、ほぼ無料枠に収まる」 運用が可能です。
※大量のリクエストが発生した場合は課金される可能性がありますが、GCP側で予算アラートや上限を設定することでリスクを回避できます。

コマンドライン操作に不慣れな方でも導入できるよう、ブラウザのみで完結する手順を説明します。

まず、Discord上でボットのアカウントを作成します。

次に作成したボットアカウントをサーバーに招待します。
左メニューの「OAuth2」を選択すると、右側にスコープの選択リストが表示されるので、bot と applications.commands にチェックを入れます。

そうすると、その下にボットの権限選択リストが表示されるので、Send Messages と Attach Files にチェックを入れます。

後は一番下の Generated URL をコピーし、ブラウザでアクセスしてサーバーに招待します。

ボットを稼働させるためのGoogle Cloudプロジェクトを用意します。

ブラウザ上で利用できるターミナル「Cloud Shell」を使用して設定を行います。

以下のボタンをクリックして、Cloud Shellでセットアップ画面を開きます。
画面下にターミナルが表示されるまで待機します。
Terminalメニューから「New Terminal」を選択して、別ウィンドウでターミナルを開きます。
以下のコマンドをコピーし、ターミナルに貼り付けて Enter キーを押します。
```
cd cloudshell_open/wows-minimap-renderer-bot && npm install && npm run gcp:deploy
```
対話形式で設定項目が尋ねられるため、順に入力します。
- 「プロジェクトIDは？」→ Step 2でメモしたIDを入力
- 「Discordのトークンは？」→ Step 1でメモしたトークンを入力
- その他、指示に従って入力を進めます。
- 最後に「スラッシュコマンドを登録しますか？」と聞かれるので、そのまま Enter (Yes) を押してください。

「デプロイ完了！」と表示されれば成功です。
最後に表示された URL をコピーし、Discord Developer Portal の「Interactions Endpoint URL」に貼り付けることで設定は完了です。(Save Changesを忘れずに！)

ボットが不要になった場合は、以下の手順でプロジェクトを削除してください。これにより以降の料金発生を防げます。

これでプロジェクトに関連する全てのリソースが削除されます。

本ボットのソースコードは GitLab で公開されています。

主な使用技術

システムアーキテクチャ

GCP以外にも、Docker Compose を使用したセルフホスティング（自宅サーバーやVPSでの運用）もサポートしています。
インフラ構築に関心のある方は、リポジトリも併せてご覧ください。

レンダラー本体のリポジトリはこちらです。

使ってみたいけど記事を読んでもよくわからん！って人は遠慮なくお尋ねください👍

以上！