Discordのエクソーラボット

概要

このボットは、Discordサーバー内で直接動作し、ユーザーがDiscord環境を離れることなくサインイン、報酬の受け取り、購入を行えるようにします。さらに、ボットはチャンネルへのアウトバウンドメッセージもサポートしています。

Discordでのユーザーフロー：

1. ユーザーは、ボットが接続されている任意のチャンネルで/shopと入力します。ショップはコマンドを使用したユーザーにのみ表示され、他のユーザーには表示されません。

2. ユーザーはプレイヤーIDでログインします。
3. ユーザーはカタログを閲覧します。
4. ユーザーは目的のアイテムの横にある購入ボタンをクリックします。
5. ユーザーは決済UIにリダイレクトされます。
6. 支払いが成功すると、ユーザーはDiscordチャンネルに戻り、ゲーム内でアイテムがユーザーに付与されます。

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant U as User
    participant D as Discord Bot
    participant X as Xsolla
    activate U
    U->>D: /shop command
    activate D
    D-->>U: Shop UI appears
    deactivate D
    U->>D: Log in with Player ID
    activate D
    D-->>U: Catalog displayed
    deactivate D
    U->>D: Click purchase on desired item
    activate D
    D->>X: Player ID + Item SKU
    activate X
    X-->>D: Return link to Payment UI
    D-->>U: Redirect to Payment UI
    deactivate D
    U->>X: Complete payment
    activate X
    note right of X: Grant item to player inventory
    deactivate X
    X->>D: Webhook: item granted notification
    deactivate X
    activate D
    D-->>U: Confirmation of successful purchase
    deactivate D
    deactivate U

前提条件

ボットを使用してゲーム内アイテムを販売するには、以下が必要です：

1. Discordを使用してユーザーとコミュニケーションを取ります。
2. アイテムカタログを作成します。手動で行うか、API経由、JSONファイルまたは外部プラットフォームからインポートすることができます。
3. ユーザーを検証し、購入をユーザーに付与するための以下のウェブフックを設定すること：
   • ユーザー検証
   • 注文の成功した支払い
   • 注文のキャンセル
4. エクソーラとのライセンス契約を締結する。

セットアップ方法

ボットの作成

1. パブリッシャーアカウントのプロジェクトで、ストアフロント > Discordでのエクソーラボットセクションに移動します。
2. 「作成」をクリックします。

3. ロゴをアップロードし、ボット名を指定します。
4. 「作成」をクリックします。
5. 設定タブに移動し、ボットの設定を完了します：
   1. プレイヤーIDヘルプコンフィギュレーターブロックで、「セットアップ」をクリックし、ユーザーがプレイヤーIDを見つける方法について簡潔な指示を提供し、「セットアップ」をクリックします。ユーザーが「プレイヤーIDの確認方法」をクリックすると、Discord UIに表示されます。

2. UIセレクターブロックで、「変更」をクリックします。ストアでアイテムを表示する方法を選択し、「保存」をクリックします：
   • ドロップダウンセレクター（デフォルト） — ストアは利用可能なアイテムのドロップダウンリストを表示します。アイテムを購入するには、ユーザーはリストで選択し、アイテムカードを開いて購入ボタンをクリックします。
   • 購入ボタン — ストアはすべての利用可能なアイテムを一度に表示し、各アイテムの横に購入ボタンがあります。
3. APIキーは自動的に生成されます。更新したい場合は、「キーを生成」をクリックします。
4. ボットトークンは自動的に生成されます。すでにDiscordにボットがある場合は、「変更」をクリックし、対応するフィールドにそのトークンを入力し、「変更」をクリックします。変更を保存した後は、以前のトークンを使用できなくなることに注意してください。

Discordでのボットトークンの見つけ方法に関する説明

1. Discordの開発者ポータルでアプリケーションのページに移動します。
2. Overview > Botセクションに移動します。
3. Tokenセクションで、「Reset token」をクリックします。確認を求められる場合があります。
4. 新しいトークンの値をコピーします。

5. ユーザー認証ウェブフックブロックで、「変更」をクリックし、ユーザー認証ウェブフックを受信したいサーバーのURLを指定し、「保存」をクリックします。
6. ウェブフックをお持ちでない場合は、ウェブショップURLブロックを変更せずそのままにしてください。

Discordサーバーにボットを追加するには、ページ上部の招待リンクに従ってください。

すべての必須設定を設定すると、ボットのステータスが「アクティブ」に変わります。

アイテムの設定

販売するアイテムを設定するには：

1. 「ショップ」タブに移動し、「編集」をクリックします。
2. 「ショップアイテム」タブで以下を行います：
   1. ショップのカバー画像をアップロードします。
   2. ショップタイトルを指定します（必須）。
   3. Discordで販売したいアイテムの横にあるボックスにチェックを入れます（必須）。
   4. 「確定」をクリックします。

その後、ご自身のDiscordサーバーに移動して、ボットが正しく動作するか確認できます。

報酬アイテムの設定

ユーザーがストアを訪れる頻度を高めるため、以下の報酬を設定することができます：

• ログイン報酬 — ユーザーが初めてストアにログインしたときに利用可能になる報酬。
• デイリー報酬 — 1日1回受け取ることができる限定アイテム。

セットアップ方法：

1. 「ショップ」タブに移動し、「編集」をクリックします。
2. 報酬アイテムをセットアップします：
   • 「ログイン報酬」タブで一つアイテムを選択し、「確認」をクリックします。
   • 「デイリー報酬」タブで一つアイテムを選択し、「確認」をクリックします。正しい順序にアイテムを並べ替えるには、メイン設定ページでドラッグ＆ドロップします。

その後、Discordサーバーに移動して、ボットが正しく動作するか確認できます。