SL 频道点数模组

SL 频道点数模组

一个允许通过twitch频道点数奖励触发游戏内事件的模组。

迷你游戏

SLChannelPointMod

一个 Minecraft Fabric 模组,将 Twitch 频道点数兑换与游戏内动作集成。当观众在你的 Twitch 直播中兑换频道点数时,模组会自动在你的 Minecraft 世界中触发动作。

功能特性

  • Twitch 集成 - 连接到 Twitch EventSub 以接收实时的频道点数兑换
  • 便捷的 GUI 配置 - 所有设置均通过直观的游戏内菜单完成
  • 多种动作类型:
    • 生成生物 - 在玩家附近生成任意生物
    • 随机生物 - 从可配置的生物池中生成随机生物
    • 给予物品 - 给予玩家物品
    • 随机物品 - 给予玩家随机物品
    • 施加效果 - 对玩家施加药水效果
    • 随机效果 - 从可配置的效果池中施加随机效果
    • 播放音效 - 播放任意音效,音量与音调可调
    • 执行命令 - 执行任意服务器命令,支持占位符
    • 特殊动作 - 洗牌物品栏、丢弃手持物品、丢弃整个物品栏
  • 从 Twitch 同步 - 从你的 Twitch 频道导入已有的频道点数奖励
  • 发布到 Twitch - 直接从模组创建新的频道点数奖励
  • 屏幕 HUD - 兑换发生时实时显示,位置与缩放可自定义
  • 持久化配置 - 奖励会被保存,并在服务器重启后保留

环境要求

  • Minecraft 1.21.10~~~~
  • Fabric Loader 0.18.1+
  • Fabric API
  • Java 21+

安装

  1. 安装 Fabric Loader
  2. 下载 Fabric API
  3. 下载 SLChannelPointMod 的最新版本
  4. 将所有模组放入你的 mods 文件夹

设置

1. 打开配置 GUI

(UI 基于 GUI 3 设计,在其他设置下可能会显示异常。)

有两种方式打开配置 GUI:

  • 在游戏内按 K(默认按键绑定)
  • 在聊天中输入 /channelpoints

2. 登录 Twitch

  1. 前往 Settings 标签页
  2. 展开 Twitch Connection
  3. 点击 Login with Twitch
  4. 将打开一个浏览器窗口 - 授权该应用
  5. 认证完成后返回游戏

3. 连接 Twitch

登录后,点击 Connect 开始接收频道点数兑换。

4. 配置奖励

方式 A:从 Twitch 同步已有奖励

  1. 前往 Rewards 标签页
  2. 点击 Sync from Twitch 导入你已有的频道点数奖励
  3. 选择一个奖励并点击 Edit 配置其触发的动作

方式 B:创建新奖励

  1. 点击 + Add Reward 创建新奖励
  2. 输入名称、花费,并配置动作
  3. 点击 Save
  4. 可选:点击 Publish 在你的 Twitch 频道上创建该奖励

就这样!当观众兑换频道点数时,配置的动作将在游戏内触发。

动作类型

生成生物(Spawn Mob)

在随机玩家附近生成生物。

  • 使用浏览按钮选择生物类型
  • 设置数量(或使用随机范围)

随机生物(Random Mob,相同/各自)

从配置的生物池中生成随机生物。

  • 相同(Same):所有生成的生物都是同一种随机类型
  • 各自(Each):每个生物单独随机选择
  • 可为每个奖励配置自定义生物池,或使用默认的敌对/被动列表

给予物品(Give Item)

给予随机玩家物品。

  • 使用浏览按钮选择物品
  • 设置数量

随机物品(Random Item,相同/各自)

从所有可用物品中给予玩家随机物品。

  • 相同(Same):给予的所有物品都是同一种随机类型
  • 各自(Each):每个物品单独随机选择

施加效果(Apply Effect)

对玩家施加药水效果。

  • 使用浏览按钮选择效果
  • 设置等级(1 = I 级,2 = II 级,以此类推)
  • 设置持续时间(秒)

随机效果(Random Effect)

从可配置的效果池中施加随机药水效果。

  • 使用预设(有害、有益)或自定义选择配置效果池
  • 设置等级与持续时间

播放音效(Play Sound)

在玩家位置播放音效。

  • 从所有 Minecraft 音效中选择,带预览按钮
  • 调整音量(0.0 - 1.0)与音调(0.5 - 2.0)

执行命令(Execute Command)

运行服务器命令,支持占位符。

  • {player} - 替换为目标玩家的名称
  • {redeemer} - 替换为兑换的 Twitch 用户名
  • {random:min:max} - 替换为该范围内的随机数

示例:say {redeemer} says hello to {player}! 示例:tp {player} ~ ~{random:5:20} ~

特殊动作(Special Actions)

预配置的特殊动作:

  • 洗牌物品栏(Shuffle Inventory) - 随机打乱玩家物品栏中的所有物品
  • 丢弃手持物品(Drop Held Item) - 丢弃玩家当前手持的物品
  • 丢弃物品栏(Drop Inventory) - 丢弃玩家的整个物品栏

HUD 设置

模组会在奖励被兑换时显示屏幕通知。可在 Settings > HUD Settings 中自定义:

  • 位置(Position) - 左上、右上、左下或右下
  • 最大消息数(Max Messages) - 同时显示的兑换数量(1-10)
  • 缩放(Scale) - HUD 文字大小(0.5x - 2.0x)

配置

配置存储在 .minecraft/config/slchannelpointmod.json,包括:

  • Twitch 认证令牌
  • 频道信息
  • 已配置的奖励及其动作
  • HUD 设置
  • 随机生物池

权限

模组需要以下 Twitch 权限(登录时请求):

  • channel:read:redemptions - 用于接收频道点数兑换事件
  • channel:manage:redemptions - 用于创建和删除频道点数奖励

故障排除

无法登录 / 浏览器未打开

从聊天/日志中复制 URL,并在浏览器中手动打开。

奖励未触发

  • 确认你已连接(检查 Settings 中的 Twitch Connection 状态)
  • 确保奖励已配置动作(未显示为红色/未配置)
  • 尝试断开连接后重新连接

令牌过期

前往 Settings > Twitch Connection 并点击 Re-login。

从源码构建

git clone https://github.com/andrewccard/SLChannelPointMod.git
cd SLChannelPointMod
./gradlew build

构建出的 JAR 将位于 build/libs/。

许可证

CC0-1.0