Twitch聊天名称集成

Twitch聊天名称集成

在敌人上方创建悬浮名称,名称来自你的Twitch聊天中的用户名。每个名称有1分钟冷却时间,之后才能再次用于另一个敌人。如果API失败或队列为空,则使用文本文件中的备用名称。

[color=#d4d4d8][u]安装此模组后,你需要在文本文件中进行一些额外的编辑。这是为了让你的游戏与 Twitch 建立连接所必需的。请阅读以下关于设置该模组的指南。[/u][/color]

[color=#D4D4D8]在敌人上方创建带有你 Twitch 聊天中用户名的漂浮名字。每个名字在可用于另一个敌人之前有 1 分钟的冷却时间。如果 API 失败或队列为空,则使用文本文件中的备用名字。[/color]


[heading][color=#D4D4D8][font=Arial][size=5]安装[/size][/font][/color][/heading]
[color=#D4D4D8]1. 将 TwitchNamesIntegration 文件夹复制到:
<game>/BladeAndSorcery_Data/StreamingAssets/Mods/
2. 启动游戏一次——这会自动在以下位置创建配置文件:
<game>/UserData/TwitchNamesIntegration.cfg
3. 使用你的 Twitch 凭据编辑配置文件(见下文)
4. 编辑模组文件夹中的 FallbackNames.txt 以自定义备用名字(见下文)
5. 重新启动游戏[/color]


[heading][color=#D4D4D8][size=5][font=Arial]配置[/font][/size][/color][/heading]
[color=#D4D4D8]编辑 UserData/TwitchNamesIntegration.cfg:

TwitchUsername | 你的 Twitch 频道名称(小写)
TwitchClientId | 你的 Twitch 应用程序 Client ID
TwitchOAuth | 你的 OAuth 令牌
BroadcasterId | 你的 Twitch 数字用户 ID[/color]


[heading][color=#D4D4D8][size=5]获取你的 Twitch 凭据[/size][/color][/heading]
[color=#D4D4D8][i]Client ID:[/i]
1. 前往 https://dev.twitch.tv/console
2. 使用你的 Twitch 账户登录
3. 点击“注册你的应用程序”
4. 为其命名(例如“B&S Crowd Control”)
5. 将 OAuth 重定向 URL 设置为你的面板 URL(例如 https://your-backend.onrender.com/extension/panel.html)
6. 选择“Chat Bot”作为类别
7. 创建后,复制应用程序页面上显示的 client id
[i]OAuth 令牌:[/i]
1. 前往 https://twitchtokengenerator.com/
2. 选择作用域:moderator:read:chatters
3. 点击“授权”并使用你的 Twitch 账户登录
4. 复制生成的 oauth token
或者,使用 Twitch CLI:
twitch token -u -s "moderator:read:chatters"
[i]Broadcaster ID:[/i]
1. 前往 https://streamsciences.com/twitch-username-to-id/(或任何 Twitch ID 转换器)
2. 输入你的 Twitch 用户名
3. 复制返回的数字 ID
或者,使用 Twitch API:
GET https://api.twitch.tv/helix/users?login=YOUR_USERNAME
Authorization: Bearer YOUR_OAUTH_TOKEN
Client-Id: YOUR_CLIENT_ID

响应 JSON 中包含 "id"——那就是你的 Broadcaster ID。[/color]


[heading][color=#D4D4D8][size=5]备用名字[/size][/color][/heading]
[color=#D4D4D8]编辑 Mods/TwitchNamesIntegration/FallbackNames.txt:
- 每行一个名字
- 忽略空行
- 在没有可用的 Twitch 聊天用户或队列为空时使用
- 你可以随时编辑此文件——更改将在下次游戏启动时生效
示例:

Ben
Michael
Frank
Jose[/color]

[heading][color=#D4D4D8]
[size=5]工作原理[/size][/color][/heading]
[color=#D4D4D8]- 启动时,模组会连接到 Twitch,并每 2 分钟轮询一次聊天用户列表
- 每个名字在可用于另一个敌人之前有 1 分钟的冷却时间
- 如果聊天用户 API 失败或队列为空,则使用文本文件中的备用名字
- 敌人死亡或消失时,名字标签会自动移除
- 鸡不会被命名[/color]