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. パブリッシャーアカウントのプロジェクトで、Storefront > Xsolla Bot in Discordセクションに移動します。
2. Createをクリックします。

3. ロゴをアップロードし、ボット名を指定します。
4. Createをクリックします。
5. Settingsタブに移動してボットの設定を完了します：
   1. Player ID help configuratorブロックでSet upをクリックし、ユーザーがプレイヤーIDを見つける方法について簡潔な指示を提供します。ユーザーがHow to find player IDをクリックすると、Discord UIに表示されます。

2. APIキーは自動的に生成されます。更新したい場合は、Generate keyをクリックします。
3. ボットトークンは自動的に生成されます。すでにDiscordにボットがある場合は、Changeをクリックし、対応するフィールドにそのトークンを入力します。

Discordでのボットトークンの見つけ方

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

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

4. User authentication webhookブロックでChangeをクリックし、プロジェクト設定 > ウェブフックセクションからウェブフックURLを指定します。
5. ウェブショップを接続する必要がない場合は、Web Shop URLブロックを変更せずにそのままにします。

すべての必要な設定を完了すると、ボットのステータスはActiveに変更されます。

アイテムの設定

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

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

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

報酬アイテムの設定

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

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

設定するには：

1. Shopタブに移動し、Build your shopをクリックします。

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

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