
Twitch2Gether
欢呼比特,触发混乱。你的观众决定接下来什么降临你的Minecraft世界!
Cheer Bits,触发混乱。Twitch2Gether 让观众通过 Twitch Bits 直接进入你的 Minecraft 世界。只需一次 Cheer,苦力怕就会在你身边出现、闪电劈下,或正午变成午夜。每个 Bits 数量都可以触发各自的动作,并在聊天中显示各自的消息,让你的社区清楚看到是谁造成了混乱。
你在一个简单的配置文件中决定哪个数量触发什么。动作可以小到只是一条感谢消息,也可以狂野到你能想到的任何 Minecraft 命令。冷却时间和等待队列确保混乱保持有趣,而不是所有事情同时发生。你可以将动作瞄准你的主播,或让它们作用于服务器上的每位玩家。
设置完成后,它会自行运行:你的 Twitch 登录会被保存、自动刷新,并在连接断开时重新连接。几条管理员命令让你可以暂停乐趣、清空队列或测试一笔捐赠而不花费任何一个 Bit。该模组仅在服务端运行,因此你的玩家无需安装任何东西。
==========================================================
STREAM2GETHER – 维基
观众通过 Twitch Bits 在 Minecraft 中触发动作
==========================================================
该模组仅在服务端运行。玩家无需安装任何东西。
前置要求(必须已就位):
- 运行 Fabric 的 Minecraft 服务器,版本 26.3(Fabric Loader 0.20.1+)
- Java 25
- "mods" 文件夹中的 Fabric API
- 一个可以接收 Bits 的 Twitch 频道(附属或合作伙伴)
----------------------------------------------------------
第 1 部分:安装模组
----------------------------------------------------------
1. 停止服务器。
2. 将文件 "stream2gether-1.0.0.jar" 放入服务器的
"mods" 文件夹(例如通过 SCP 或 SFTP 上传)。
3. 启动服务器。
4. 日志中必须包含:"Twitch2Gether loaded"
"config" 文件夹中也会创建这些文件:
twitch2gether-settings.json (设置)
twitch2gether-actions.json (动作)
模组更新时:停止服务器,用新 .jar 替换旧文件,启动服务器。配置文件会被保留。
在服务器控制台输入命令(不带 "/"),或在游戏内以
管理员身份输入(带 "/")。
----------------------------------------------------------
第 2 部分:连接 Twitch(一次性)
----------------------------------------------------------
该模组通过你自己创建的 Twitch 应用程序连接到你的频道。
你使用你自己的 Twitch 账户登录。
该应用程序仅获得读取你频道 Bits 捐赠的权限。
第 1 步 – 设置 Twitch 应用程序:
1. 打开 https://dev.twitch.tv/console/apps,并使用
应拥有该应用程序的 Twitch 账户登录。
(Twitch 可能要求为此启用双重验证。)
2. 点击 "Register Your Application" 并严格按如下填写:
Name: "Application name"(可以是任意唯一名称)
OAuth Redirect URLs: http://localhost
Category: Game Integration
Client Type: Public (重要!不要选 "Confidential")
3. 点击 "Create"。
4. 在列表中,点击 "Application name" 旁边的 "Manage"。
5. 复制 "Client ID"。这是该模组的每位用户
在第 3 步中输入的字符串。
不需要 "Client Secret",也不得在任何地方输入它。
重要:代码登录需要类型为 "Public"。
这样每位主播都能用自己的账户使用该应用程序。
第 2 步 – 获取你创建的应用程序的 Client ID
Client ID 显示在 Twitch 开发者控制台
(dev.twitch.tv/console/apps)中应用程序
"Application name" 的 "Manage" 下。
第 3 步至第 6 步必须在服务器运行时
在服务器控制台 / screen 会话中完成!
第 3 步 – 在模组中输入 Client ID
twitch clientid set CLIENT-ID-OF-APPLICATION-NAME
第 4 步 – 登录
twitch connect
控制台会显示一个网址和一个代码。
1. 在浏览器中打开该网址。
2. 输入代码。
3. 使用应接收 Bits 的频道所属的 Twitch 账户
(主播)登录。
4. 点击 "Authorize"。
成功:"Connected as YOURNAME!"
登录会被保存,并在下次服务器启动时自动使用。
你只需执行一次。
第 5 步 – 设置主播玩家
twitch streamer set YOUR-MINECRAFT-NAME
动作仅影响该玩家。如果该玩家不在线,
捐赠会被丢弃(之后不会补做)。
未设置时,动作会作用于所有玩家。
第 6 步 – 测试
twitch status -> 显示 "Connected as ..." 且为 "active"?
twitch testbits 100 -> 显示将会触发什么
然后在你的频道中自己 Cheer 1 Bit,以检查真实连接。
完成:观众现在可以通过 Bits 触发动作。
----------------------------------------------------------
第 3 部分:配置动作
----------------------------------------------------------
文件:config/twitch2gether-actions.json
(首次启动时创建并带有示例;示例消息为英文。已存在的文件会保留其旧文本。)
示例:
{
"actions": [
{
"bits": 100,
"message": "{user} sends a Creeper!",
"commands": [
"execute as {player} at @s run summon minecraft:creeper ~ ~ ~"
]
}
]
}
bits 此动作所需的最低 Bits 数量
message 发送给所有玩家的消息(空 = 无)
commands Minecraft 命令(空 = 仅消息)
占位符:
{user} 捐赠者名字(仅用于 "message")
{bits} Bits 数量(仅用于 "message")
{player} 主播名字,未设主播时为 "@a"(仅用于 "commands")
层级规则:
只执行一个动作:Bits 阈值最高且小于等于
捐赠数量的那个动作。
以层级 50、300、1000 为例:400 Bits -> 执行 300 的动作。
低于最低层级时不会发生任何事。
修改后: twitch reload
----------------------------------------------------------
第 4 部分:设置
----------------------------------------------------------
文件:config/twitch2gether-settings.json
修改后: twitch reload
cooldownSameSeconds (默认 300)
同一动作再次执行前的等待时间。
cooldownOtherSeconds (默认 60)
任意两个动作之间的时间。
queueTimeoutSeconds (默认 600,最低 10)
超过此时间后,排队的捐赠将过期。
队列:
- 带有命令的动作在冷却期间会进入队列等待(最多 50 个)。
- 仅消息动作(无命令)没有冷却时间。
- 如果主播离线,队列会被清空。
- 空服务器上 Minecraft 会在 60 秒后暂停(默认)。
此时冷却也不会推进。
----------------------------------------------------------
第 5 部分:所有命令
----------------------------------------------------------
谁可以使用它们?仅管理员(op)和服务器控制台。
在控制台中输入时不要带 "/",在游戏内带 "/"。
--- 连接 ---
twitch connect
启动 Twitch 登录。显示一个网址和一个代码,
你需要在浏览器中输入。
twitch disconnect
断开 Twitch 连接并删除已保存的登录。
之后需要重新执行 "twitch connect"。
twitch status
显示:以谁的身份连接、处于活动还是已暂停(PAUSED),
以及队列中有多少动作在等待。
twitch clientid
显示是否已设置 client ID(仅显示前 4 个字符)。
twitch clientid set <id>
保存你 Twitch 应用程序的 client ID。使用新 ID 时,
旧登录会被删除,然后运行 "twitch connect"。
--- 主播 ---
twitch streamer
显示当前设置为主播的玩家。
twitch streamer set <name>
设置接收动作的玩家。
twitch streamer clear
移除主播。之后动作会作用于所有玩家。
--- 控制 ---
twitch pause
停止执行。已排队的动作会被保留,带有命令的新动作
会进入队列。仅消息动作会被跳过。
twitch resume
暂停后继续执行。
twitch clear
立即丢弃所有已排队的动作。
twitch reload
从文件重新加载设置和动作。
报告已加载多少个动作。
--- 测试 ---
twitch testbits <amount>
模拟用户 "TestUser" 的捐赠,并报告
发生了什么(已执行、等待中、已丢弃等)。
twitch testbits <amount> <name>
同上,但使用你自己的捐赠者名字。
----------------------------------------------------------
第 6 部分:常见问题
----------------------------------------------------------
"No client ID set"
-> twitch clientid set CLIENT-ID-OF-APPLICATION-NAME
捐赠时没有任何反应
-> twitch status:是否已连接并处于活动状态?
-> 主播玩家是否在线?名字拼写是否正确?
-> 捐赠是否达到最低 Bits 层级?
-> 用 twitch testbits <amount> 检查。
登录已过期或被撤销
-> 再次运行 twitch connect。
模组未加载
-> Java 25、Minecraft 26.3、Fabric Loader 0.20.1 或更新版本,
以及 "mods" 文件夹中的 Fabric API 是否就位?
安全提示
-> 文件 config/twitch2gether-auth.json 可访问你的频道。
绝不要分享它。
-> 只将可信玩家设为管理员,他们可以使用所有
twitch 命令。
-> 在公共服务器上保持 "online-mode=true"。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。