TwitchRandomizer

插件

· 作者 exnfachjanTTV

由你的 Twitch 聊天室控制的 Minecraft 随机化挑战

0 本站下载 0 关注 更新于 3 个月前

最新 1.7.3 · 26.2 · Paper / Spigot

一键开服(送7天)

TwitchRandomizer

TwitchRandomizer 是一款功能强大的 Minecraft(Paper 1.21+)插件,为服务器带来互动的随机挑战——全部由你的 Twitch 观众控制!它将你的 Minecraft 游戏体验与 Twitch 聊天无缝集成,让观众能够实时影响并触发游戏内事件。


? 主要特性

  • Twitch 聊天集成:
    Twitch 观众可以通过订阅或捐赠 Bits 来触发随机事件!

  • 与你的 Twitch 好友一起挑战:
    该插件可以读取多个 Twitch 账户的订阅和 Bits 数据——包括 StreamElements 和 Tipeeestream 的捐赠。因此,你可以与你的 Twitch 好友一起玩这个挑战!

  • StreamElements & Tipeeestream 捐赠集成:
    通过 StreamElements 或 Tipeeestream 进行的捐赠会触发游戏内事件。两者均支持同时连接多个主播账户。配置完全通过在插件文件夹中的 donations.yml 文件进行。

  • 频道名称显示:
    当与多个 Twitch 频道一起玩时,每个触发事件的来源频道会以方括号形式显示在名称之后——例如:exnfachjan (fuxelbau) 造成 4 颗心的伤害。

  • Twitch 角色颜色:
    观众名称在 Minecraft 聊天中以不同颜色区分——主播(红色)、版主(绿色)、VIP(粉色)、捐赠者(水蓝色),普通观众(白色)。

  • 事件权重与自定义:
    调整每个事件出现的概率——让某些事件更常见、某些更稀有,或直接禁用它们。随时轻松重新加载或调整设置。一键重置所有权重为默认值。

  • 最近事件冷却:
    内置的冷却系统自动降低同一事件连续出现多次的概率——无需任何配置。

  • 同步多人事件:
    当多名玩家一起游戏时,每个事件内的所有随机值(持续时间、物品、生物类型等)对所有玩家均保持一致。不再出现玩家 1 遭遇“地板是岩浆”持续 10 秒,而玩家 2 却只有 69 秒的情况。

  • 死后旁观模式:
    当一名玩家死亡时,所有玩家会同时进入旁观模式。计时器和队列暂停,直到新一轮开始。可针对每轮配置为“尝试次数”(团队生命数)或经典的“死亡次数”计数器。

  • 死亡计数与统计:
    内置死亡追踪和玩家统计数据,非常适合挑战玩法和社区竞赛。

  • 队列系统:
    由观众触发的事件可以排队并管理,确保节奏流畅且避免事件刷屏。队列在服务器重启和世界重置后依然保留!

  • 暂停系统:
    当玩家处于死亡画面或所有玩家都处于旁观模式时,计时器和队列会自动暂停。完全可配置。

  • 暂停光环:
    当计时器暂停时,所有在线玩家周围会出现螺旋火焰粒子光环——这是挑战暂停的清晰视觉提示。

  • 图形界面 (GUI):
    通过游戏内图形界面直接调整插件设置、管理事件权重、控制计时器以及配置行为。无需任何 OP 权限即可轻松设置!

  • 多语言支持:
    完整的德语和英语用户界面,支持自动检测客户端语言。玩家可在 GUI 中手动覆盖自己的语言选择。

  • 会话与世界重置:
    如果希望获得真正的挑战,可以在每次死亡后重置种子!支持 BungeeCord 备用服务器回退机制。


✔️ 主要命令

  • /trgui — 打开图形配置界面。

可选命令(非必需,因为你可以无缝地从图形界面管理所有内容):

  • /timer — 开始、停止、暂停或重置挑战计时器。
  • /reset — 在确认后启动世界/会话重置。
  • /queue add <数量> <用户名> — 手动向队列中添加事件。
  • /cleardeath — 清除死亡计数器。
  • /trconfig — 通过命令配置插件(支持 Tab 补全)。

? 事件

事件 描述
spawn_mobs 在玩家附近生成随机生物(敌对生物会追击你!)
potion 施加随机药水效果
give_item 给予随机物品
clear_inventory 清空玩家背包中的随机槽位
teleport 传送至随机位置(安全的 Y 轴高度)
damage_half_heart 受到半颗心的伤害
fire 点燃玩家
inv_shuffle 打乱整个背包
hot_potato 一只快速僵尸追击你——如果它追上你,就会爆炸!
no_crafting 阻止合成一段时间(带有 Boss 栏倒计时)
safe_creepers 苦力怕以时钟样式围绕你并爆炸(不造成伤害,不破坏方块)
floor_is_lava 脚下的地面变为岩浆块(带有方块还原功能)
nasa_call 将玩家发射到高空
slippery_ground 地面变为压制的冰(带有方块还原功能)
hell_is_calling 追踪火球如雨般向你落下
tnt_rain TNT 矿车从天而降
anvil_rain 铁砧从天而降
skyblock 所有玩家被传送到一起——周围的区块将被删除!
fake_totem 获得一个实际上无效的不死图腾
equipment_shuffle 背包中所有带等级的工具和护甲会被随机升级或降级

? 开始使用

你可以通过 config.yml 配置文件或在游戏内通过 GUI(无需 OP 权限)来配置该插件。

  1. 安装:
    将 TwitchRandomizer.jar 放入服务器的 plugins 文件夹中。

  2. 配置 Twitch 集成:

    • 使用 /trgui 打开 GUI;在左上角,你会找到一本名为 "twitch-info" 的书。
    • 左击该书输入你的 Broadcaster Username(主播用户名),然后点击 done 确认。
      你可以输入多个频道,用逗号、分号或换行符分隔。
    • 右击该书输入你的 Bot OAuth(机器人 OAuth 令牌),然后点击 done 确认。
      你可以在这里获取 OAuth 令牌:
      确保以下权限范围已激活:bits.read、chat:read、channel:read:subscriptions 和 user:read:subscriptions。
  3. 配置 StreamElements(可选):
    编辑 plugins/TwitchRandomizer/donations.yml —— 该文件会在首次启动时自动创建,且插件永远不会覆盖此文件。

    se_enabled: true
    se_accounts: "YOUR_CHANNEL:YOUR_JWT_TOKEN"
    

    对于多个主播,条目之间用分号分隔:

    se_accounts: "Channel1:JWT1;Channel2:JWT2"
    

    从以下地址获取你的 JWT 令牌:

  4. 配置 Tipeeestream(可选):
    在同一个 donations.yml 文件中:

    tipeee_enabled: true
    tipeee_accounts: "YOUR_CHANNEL:YOUR_APIKEY"
    

    多账户的用法相同:"Ch1:KEY1;Ch2:KEY2"
    从以下地址获取你的 API 密钥:

    编辑完 donations.yml 后,在游戏内执行 /trconfig donations reload 应用更改 —— 无需重启服务器。

  5. 重载/重启:
    如果你使用的是 GUI 进行配置,则不需要重启服务器。

  6. 设置触发器
    你可以测试连接是否正常。启用测试触发器(在 Debug Menu 调试菜单中找到),你可以模拟事件,例如关注(!test)、赠送关注(!gift)或关注炸弹(!giftbomb [N])。

    请确保你的计时器正在运行!否则,你无法通过 Twitch 向队列中添加事件!

    如果你想向队列中添加一些事件,只需使用命令 /queue add <AMOUNT> <Username> 即可。即使计时器未运行,此命令也有效!


? 非 OP 用户的权限说明(需要 LuckPerms)

权限 描述
twitchrandomizer.gui 完整 GUI 访问权限(超级节点)
twitchrandomizer.gui.use 使用 GUI(基础权限)
twitchrandomizer.admin.save 保存并热重载配置
twitchrandomizer.admin.edit 通过 GUI 编辑数值
twitchrandomizer.admin.twitch 设置 Twitch 频道/token
twitchrandomizer.timer.start 启动计时器
twitchrandomizer.timer.stop 停止/暂停计时器
twitchrandomizer.timer.reset 重置计时器
twitchrandomizer.reset 重置流程
twitchrandomizer.reset.force 强制重置(跳过确认)

GUI 会对每个操作执行合理的权限检查。

? 要求

  • Minecraft Paper 服务器 1.21+

  • Java 21 或更高版本

  • Twitch 账号(至少为合作伙伴 Affiliate)以及用于聊天集成的 OAuth 令牌

  • Tipeeestream 多账户支持 — donations.yml 现在使用 tipeee_accounts,格式与 StreamElements 相同,为 "Channel:APIKEY;Channel2:APIKEY2"。

  • 频道标签显示 — 当连接多个 Twitch 频道时,每个事件触发后会在括号内显示来源频道名称。

  • 同步多人事件 — 同一事件分发中的所有随机值(持续时间、物品、生物类型、药水效果等)对所有玩家均保持一致。

  • Skyblock 队伍修复 — 在清除区块前,所有玩家将被传送至同一个集合点,防止玩家互相掉入虚空。

  • 死后旁观模式下的队伍修复 — 当一名玩家死亡时,所有在线玩家将同时进入旁观者模式。计时器和队列暂停功能恢复正常。

  • 尝试次数 vs 死亡次数计数器 — 启用“死后旁观模式”时,计数器标记为 “Tries/Versuche”,仅统计每支队伍的一次死亡;禁用时则按之前的逻辑统计个人死亡次数。

  • 单次捐赠/事件金额上限 — 每次触发事件的捐赠金额上限设为 5.0€(标准价格)。只能低于此值,不能更高。

  • 近期事件冷却机制 — 新增防重复算法,降低最近触发过的事件在下一次或下两次抽取中的权重,使事件池体验更加多样化。

  • 全员旁观时暂停队列 — 当所有玩家进入旁观者模式时,计时器和队列会立即正确暂停。

v1.4.0

  • 新事件:equipment_shuffle — 背包中所有带等级系统的工具和护甲会随机升阶或降阶一级。附魔、自定义名称和描述信息将被保留。
  • StreamElements 捐赠集成 — 通过 StreamElements 进行的捐赠现在可触发游戏内事件。支持同时绑定多个主播账户。
  • 暂停光环特效 — 计时器暂停期间,所有在线玩家周围会显示螺旋火焰粒子效果。
  • 权重调整: 默认数值略有变动。

v1.3.1

  • 首次公开发布。

? 致谢

由 exnfachjan 开发,并借助 AI(Anthropic 的 Claude)协助完成。
感谢 Paper/Spigot 社区以及 Twitch4J 提供的坚实基础。


? 许可证

本项目遵循 GNU General Public License v3.0 许可证 ——
详见 LICENSE。


❤️ 支持

喜欢我的插件吗?欢迎支持我的工作:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源