艾克索拉Discord机器人

概述

该Bot直接在您的Discord服务器中运行，使用户能够在不离开Discord环境的情况下登录、领取奖励和进行购买。此外，该Bot支持向频道发送外部消息。

Discord中的用户流程：

1. 用户在Bot连接的任何频道中输入/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

先决条件

要使用Bot销售您的游戏内物品，您需要：

1. 使用Discord与用户沟通。
2. 创建一个物品目录。您可以手动、通过API或从JSON文件或外部平台导入。
3. 配置以下Webhook以验证用户并授予用户购买权限：
   • 用户验证
   • 订单成功支付
   • 订单取消
4. 与艾克索拉签署许可协议。

如何设置

创建Bot

1. 在您的发布商帐户项目中，转到Storefront > 艾克索拉Bot在Discord部分。
2. 点击Create。

3. 上传Logo并指定Bot名称。
4. 点击Create。
5. 转到Settings选项卡完成Bot配置：
   1. 在Player ID help configurator块中，点击Set up并提供用户如何找到其玩家ID的简要说明。当用户点击How to find player ID时，它将在Discord用户界面中显示。

2. API密钥会自动生成。如果您想更新它，点击Generate key。
3. Bot令牌会自动生成。如果您已经在Discord中有一个Bot，点击Change并在相应字段中提供其令牌。

在Discord中查找Bot令牌的说明

1. 转到Discord开发者门户中的应用程序页面。
2. 转到Overview > Bot部分。
3. 在Token部分，点击Reset token。您可能需要通过验证。
4. 复制新的令牌值。

要检查您是否成功添加了令牌，请在发布商帐户中重新加载页面。如果您在页面顶部看到邀请链接，则配置成功。按照此链接将Bot添加到您的Discord服务器。

4. 在User authentication webhook块中，点击Change并指定项目设置 > Webhooks部分的Webhook URL。
5. 如果您不需要连接您的网页商城，请保持Web Shop URL块不变。

一旦您配置了所有必需的设置，Bot状态将更改为Active。

配置物品

要配置待售物品：

1. 转到Shop选项卡并点击Build your shop。
2. 在Shop items选项卡上：
   1. 上传商店封面图片。
   2. 指定商店标题（必填）。
   3. 勾选您希望通过Discord销售的物品（必填）。
   4. 点击Confirm。

之后，您可以转到您的Discord服务器检查Bot是否正常工作。

配置奖励物品

为了激励用户更频繁地访问您的商店，您可以设置以下奖励：

• 登录奖励——用户首次登录商店时可获得的奖励。
• 每日奖励——每天可领取一次的独家物品。

要设置它：

1. 转到Shop选项卡并点击Build your shop。

2. 设置奖励物品：
   1. 在Login rewards选项卡上，选择一个免费物品并点击Confirm。
   2. 在Daily rewards选项卡上，选择免费物品并点击Confirm。要按正确顺序重新排列物品，请在主设置页面上拖放它们。

之后，您可以转到您的Discord服务器检查Bot是否正常工作。