TwitchRewards999

插件

· 作者 Erik9994857

TwitchRewards999 是一款功能全面的 Minecraft 插件,旨在连接你的 Twitch 直播与 Minecraft 服务器。它根据玩家的观看时长给予奖励,从而培养更具吸引力和互动性的社区氛围。

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.10 · Bukkit / Paper

一键开服(送7天)

⚙️ 核心系统

  1. Twitch 账号绑定 玩家可以使用简单的游戏内命令将 Minecraft 账号绑定到其 Twitch 账号。这是追踪观看时长和奖励的基础。
  • 命令: /linktwitch <twitch_username>
  • 存储: 绑定的账号以 twitch_username: minecraft_uuid 的格式存储在 usernames.yml 中。
  1. 主播配置 服务器管理员可以轻松配置要追踪的主要 Twitch 频道。插件将监控该频道的直播状态更新。
  • 配置: 在 config.yml 中设置 twitch_channel 和 twitch_link。
  • API 集成: 需要在 config.yml 中添加 Twitch Client ID 和 Secret,以便与 Twitch API 进行通信。
  1. 直播公告 当配置的主播开播时,会向服务器上的所有玩家广播可自定义的公告,鼓励他们加入直播间。
  • 配置: 在 config.yml 中启用或禁用此功能,并自定义消息内容。
  • 示例消息: §d[Live] %streamer% is now streaming! Watch at: %streamlink%
  1. 观看时长追踪系统 插件会追踪所有已绑定且在线的玩家在主播放映期间的观看时长。
  • 逻辑: 每秒运行一个异步任务来检查主播的直播状态,并为在线的已绑定玩家更新观看时长。
  • 存储: 每个玩家的观看时长数据存储在 time.yml 中,包括 seconds_watched(已观看秒数)和 unclaimed_rewards(未领取奖励)。
  1. 奖励间隔逻辑 根据可配置的时间间隔自动向玩家发放奖励。
  • 配置: 在 config.yml 中设置 reward_interval(以秒为单位)、reward_type(points 或 item)以及具体的 reward。
  • 示例: 如果 reward_interval 为 600,则玩家每观看 10 分钟即可获得一次奖励。
  1. 离线奖励处理 如果玩家在离线期间获得了奖励,插件会将其存储为“未领取奖励”。当玩家重新登录时,他们会收到通知并获得一个唯一的兑换码来领取奖励。
  • 逻辑: PlayerJoinEvent 监听器会检查未领取的奖励并生成兑换码。
  • 通知: 玩家会收到类似如下消息:§eYou’ve earned rewards for watching %streamer%! Use /twitchredeem <code> to claim them.
  1. 兑换码系统 使用唯一代码灵活兑换奖励的系统。代码可以针对离线奖励自动生成,也可以由主播/管理员手动生成。
  • 存储: 代码及其 reward_type、reward 和 uses_left(剩余使用次数)存储在 redeemcodes.yml 中。
  • 过期: 当代码的 uses_left 降至 0 时,代码会自动移除。
  1. 主播奖励码生成 主播和管理员可以生成自定义奖励码,以便在直播期间与观众分享。
  • 命令: /twitchreward generate
  • 配置: 在 config.yml 中配置生成代码的奖励类型、数值和使用次数。
  1. Twitch 积分系统 插件内置的货币系统,允许玩家积累作为奖励的“Twitch Points”(Twitch 积分)。
  • 存储: 玩家的积分余额存储在 twitchpoints.yml 中。
  • 命令: 玩家可以使用 /twitchpoints 查看自己的余额。
  1. 观看时长追踪(通过 Twitch IRC) 为了提供准确的观看时长追踪系统,TwitchRewards999 现在直接集成 Twitch IRC。该系统追踪积极参与直播间聊天的玩家。
  • 工作原理:
    1. Minecraft 插件通过 Twitch IRC 连接到主播的 Twitch 聊天室。
    2. 它追踪进入或离开聊天室的用戶,以及发送消息的用户。
    3. 只有被识别为活跃聊天者的玩家才会被追踪观看时长。
  • 设置:
    1. 在插件的 config.yml 中配置你的 Twitch Client ID、Client Secret 和 OAuth Token。

第一部分:设置 Twitch 扩展

  1. 创建新的 Twitch 扩展:

    • 前往 Twitch Developer Console。
    • 点击左侧菜单中的“Extensions”(扩展)。
    • 点击“Create an Extension”(创建扩展)。
    • 为你的扩展命名(例如“MyRewardsExtension”),并选择“Panel”作为扩展类型。
    • 点击“Create Extension”(创建扩展)。
  2. 获取你的扩展凭据:

    • 在你的扩展仪表板中,你会看到你的 Client ID。
    • 点击“Settings”(设置)选项卡。你的 Extension Secret 就在这里。
  3. 生成并上传前端文件:

    • 启动安装了 TwitchRewards999 插件的 Minecraft 服务器。这将自动生成 extension_frontend 文件夹,其中包含 panel.html 和 viewer.js,位于插件配置文件夹的同一目录下(例如 plugins/TwitchRewards999/extension_frontend)。
    • 进入扩展仪表板的“Asset Hosting”(资源托管)选项卡。
    • 将新生成的 extension_frontend 文件夹的内容(panel.html 和 viewer.js)拖放到上传区域。
    • 将“Panel Viewer Path”(面板查看器路径)设置为 panel.html。
    • 点击“Save Changes”(保存更改)。

第二部分:设置 Minecraft 插件

  1. 安装插件:

    • 将 TwitchRewards999-1.0.0.jar 文件(来自 target 目录)放入 Spigot 服务器的 plugins 文件夹中。
    • 启动 Minecraft 服务器。这将生成插件的配置文件。
  2. 配置插件:

    • 打开 plugins/TwitchRewards999/config.yml 文件。
    • 将 twitch_channel 设置为你的 Twitch 用户名(你要追踪的频道)。
    • 将 twitch_link 设置为你的 Twitch 频道 URL。
    • 填入你的 twitch_client_id 和 twitch_client_secret(与你 Twitch 扩展中的相同)。
    • 获取 Twitch OAuth Token:
      • 前往 Twitch Chat OAuth 密码生成器(例如 )。
      • 授权该应用程序以获取你的 OAuth token,它将以前缀 oauth: 开头。
      • 复制完整的 token。
    • 在 config.yml 中将 twitch_oauth_token 设置为你刚刚获得的 OAuth token。
    • 根据你的喜好自定义其余设置(奖励、消息等)。
    • 保存 config.yml 文件并重启服务器,或运行 /twitchreload。

第 3 部分:最后步骤

  1. 激活扩展:

    • 返回你的 Twitch 扩展仪表板。
    • 进入“版本状态”选项卡,并按照步骤将你的扩展移至“托管测试”状态,然后移至“已发布”状态。
    • 发布后,你可以通过访问创作者仪表板 -> 扩展 -> 我的扩展,在你的频道上安装该扩展。
  2. 测试系统:

    • 在 Twitch 上开始直播,并确保扩展处于活动状态。
    • 让一名玩家在游戏中通过 /linktwitch <their_twitch_username> 链接他们的 Twitch 账号。
    • 观看达到配置的 reward_interval 时长。
    • 你应该能看到游戏中发放了奖励。
    • 检查服务器控制台是否有错误信息。

你现在已成功设置了完整的 TwitchRewards999 系统!


? 命令

命令 描述 权限
/linktwitch <twitch_user> 将你的 Minecraft 账号链接到你的 Twitch 账号。 (所有人)
/twitchpoints 显示你当前的 Twitch 积分余额。 (所有人)
/twitchreward generate 为主播生成一个可供分享的奖励代码。 twitchreward.admin
/twitchredeem <code> 兑换存储或共享的奖励代码。 (所有人)
/twitchreload 重新加载插件的配置和数据。 twitchreward.admin
/twitchtime <player> 查看玩家的观看时间和未领取的奖励。 twitchreward.admin

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源