Twitch2Gether

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"。