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. APIキーは自動的に生成されます。更新したい場合は、「キーを生成」をクリックします。
3. ボットトークンは自動的に生成されます。すでにDiscordにボットがある場合は、「変更」をクリックして、対応するフィールドにそのトークンを入力します。

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

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

トークンを正常に追加したか確認するには、パブリッシャーアカウントでページを再読み込みしてください。ページの上部に招待リンクが表示されていれば、設定は成功です。このリンクをクリックして、ボットをDiscordサーバーに追加します。

4. ユーザー認証ウェブフックブロックで「変更」をクリックし、プロジェクト設定 > ウェブフックセクションからウェブフックURLを指定します。
5. ウェブショップを接続する必要がない場合は、ウェブショップURLブロックを変更せずにそのままにします。

必要な設定がすべて完了すると、ボットのステータスが「有効」に変更されます。

アイテムの設定

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

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

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

報酬アイテムの設定

ユーザーがストアをより頻繁に訪れるよう促すために、以下の報酬を設定できます：

• ログイン報酬 — ストアに初めてログインした際にユーザーに提供される報酬。
• デイリー報酬 — 1日1回受け取れる限定アイテム。

設定するには：

1. 「ショップ」タブに移動し、「ショップを構築」をクリックします。

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

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