Twitch市场 - Twitch集成

这是我为Unity游戏使用BepInEx创建的第一个模组，也是我在这个平台上发布的首个模组。希望你们喜欢！
此模组新增功能，允许Twitch观众通过聊天指令，以顾客、收银员、顾客助手、保安、清洁工、补货员或行人的身份在游戏中看到自己。
此外，观众们还有可能在游戏中与主播互动对话！


功能特性

• 用于显示已连接频道个人资料图片及主要命令（或您在配置中设置的自定义命令）的界面
• Twitch用户可以在聊天中使用!visit来访问主播的超市
• 头上显示Twitch用户名的游戏内NPC
• Twitch用户从队列中随机选出
• 使用 !talk 可以说话的 Twitch 用户已生成。
• 对话消息队列（更多信息见下方）
• 观众可以成为顾客、收银员、顾客助手、保安、清洁工、补货员或行人
• 为默认指令设置自定义指令
• 设置命令权限，仅允许特定群组使用，例如：订阅者、VIP、管理员等。
• 使用Bits作为!talk命令，并在配置中设置最小的Bits数量。
• 使用指定数量的Subgifts、指定数量的续订月数或新订阅数，即可进入收银员、顾客帮手、保安、清洁工或补货员名字的排队队列。
• 在“招聘”选项卡的电脑上，为你的收银员、顾客帮手、保安、清洁工和补货员挑选一个新名字。 （无需雇佣和解雇他们）
• 存档系统 -> 理货员、顾客助手、保安、清洁工和收银员如果在上次游玩时有名字，则会保留其名字。
• 包含许多设置的配置文件，可根据您的喜好定制游戏体验。
• 以下语言的本地化：英语、德语、法语、波兰语、意大利语、西班牙语、葡萄牙语、土耳其语、俄语 
• 游戏内版本检查器，可在有更新时通知你
• 投票系统（详情见下文）
• 小型主播功能（详见下文）
  

指令

!visit - 你的Twitch观众用来加入Twitch顾客队列的默认命令
此队列中的用户会被随机分配为顾客、收银员、顾客助手、保安、清洁工、补货员或行人（默认在配置中启用）

!talk <text> - 你的Twitch观众在游戏内发言时所使用的默认指令。
- 使用者必须以顾客身份生成才能使用此命令
- 默认情况下，只有顾客可以在游戏中交谈（在配置中为收银员、顾客助手、保安、清洁工、补货员和行人启用了此命令）

!leave - 你的Twitch观众离开Twitch顾客队列的默认命令
只有尚未进入游戏的观众才能离开队列。
- 此命令在配置中默认禁用。


管理

Twitch 版主可以在聊天中删除 !talk 指令，以移除游戏内的消息。
以下是更多管理选项：

管理命令 (1.4.0版本新增)
为下列所有命令添加自定义命令： BepInEx/config/TwitchModeration.cfg 文件。
- !smblock <username> - 阻止用户使用该模组的任何功能
- !smblockvisit <username> 阻止某个用户使用!visit
- !smblocktalk <username> - 阻止用户使用 !talk
- !smunblock <username> - 解除对用户使用该模组任何功能的限制
- !smunblockvisit <username> 解除对用户使用!visit的封锁
- !smunblocktalk <username> 解除用户使用!talk的屏蔽
- !smremove <username> - 将用户从队列中移除，并在NPC已生成时将其移除（仅限顾客和行人）


聊天消息队列 (NEW with 1.4.0)
此功能在配置中默认处于禁用状态。请在配置中启用它。 BepInEx/config/TwitchIntegration.cfg 下方 [Twitch 通用选项] -> 对话消息队列 = false 并将其设为真值
当用户处于Twitch用户队列中并使用 !说话 <消息> 当此功能启用时，该消息将被添加到新的对话消息队列中。
当用户以顾客身份生成并进入商店时，排队消息将显示在NPC上方。
当用户使用!talk且已有消息在队列中时，旧消息将被新消息替换。
版主可以删除!talk消息，将其从谈话消息队列中移除。
当用户已在商店中时，将直接显示对话消息。

Twitch投票系统 (NEW with 1.4.0)
有了新的投票系统，你的Twitch观众终于可以发表意见了！
你的观众具体可以决定什么，以及最大效果是多少，都可以根据你的偏好来设置。

但它究竟是如何运作的呢？
基本上很简单：新的一天开始时可能会出现一次投票。当你加载存档时，第一次投票将在配置中指定的最短天数之后出现。
下次投票将在配置指定的最短和最长天数之间随机出现。

当前共有6种不同的投票，但每次投票的时长可能更长或更短。
类型如下：

缩短营业时间
您的观众可以决定您的商店今天是否应该提前打烊。
商店提前关闭的小时数是随机选择的。
配置中可以设置最大小时数。

更多顾客还是更少顾客：
你的观众可以决定光顾你店铺的顾客是更多还是更少。
您的商店顾客人数增减的百分比是随机决定的。
可在配置中设置最大百分比。

电脑购物车折扣：（仅限1天）
您的观众可以决定您在电脑上购买新产品时是否享受1天的折扣。
您在电脑购物车中享受的折扣百分比是随机选择的。
可在配置中设置最大折扣百分比。

停用补货员：（仅1天）
您的观众可以决定是否将补充者停用1天。

自己算算账吧：（仅限1天）
你的观众们可以决定你是否应该亲自在收银台前计算找零一天。


投票的某些效果只会持续1天，其他效果则可持续数个游戏日。
投票效果在游戏中可持续的最长天数可在配置中设定。

投票时间也可以在配置文件中设置，路径为 BepInEx/config/TwitchVoting.cfg


你是个小主播吗？ （新增于1.4.0版本）

BepInEx/config/TwitchIntegration.cfg 中有一个新设置。

小型主播 = false
如果此项设置为 真，即使指定了特定文件，也会选择所有文本文件中的名称。 [Twitch NPC] 选项已禁用（设为false）
[Twitch NPC] 选项适用于普通队列。

启用小型主播设置后，开始游戏 生成以下文件：

你会在下面找到4个新的文本文件。 BepInEx\config\TwitchIntegration\data
那个 customers.txt 在此处输入的名称将在队列为空时被选为客户。
这个 收银员.txt 在这里，你可以添加名字，在没有人在队列中时，将其选为收银员。
他 补货员.txt 在其中，你可以输入名字，以便在队列中无人时被选为补货员。
The customer_helpers.txt 你可以在其中输入姓名，以便在队列中无人时被选为顾客助手。
这 security_guards.txt 你可以在其中输入姓名，队列中若无人时即可被选为保安。
The 保管员.txt 在此处输入名字，若队列中无人，可被选为清洁工。
该 你提供的内容是文件名“pedestrians.txt”，而非实际需要翻译的文本。请提供具体的待翻译内容，我将按照要求进行翻译。 在该队列中无人时，您可输入名字以被选为行人。


如何编辑文本文件？
用常规文本编辑器打开每个文件。
每个用户名必须独占一行，因为每一行代表一个用户名。这一规则适用于所有文本文件。


我们如何禁用某些Twitch NPC？
将该NPC的特定文本文件留空。


重要： 如果某个用户名出现在多个文本文件中，则只能生成一次。用户名是随机选取的，生成的用户名会保存至当日，次日重置。
如果用户名已在常规队列中，则文本文件中的用户名将被忽略！


功能构思 (尚未最终确定，仅为构思！)

• Twitch观众可以使用!visit命令选择他们想要购买的商品
• 其他平台集成，如YouTube、TikTok等。
  

安装

• 安装 Tobey的BepInEx x MelonLoader整合包 - 超市模拟器
• 下载 Twitch市场 - Twitch集成 来自 文件选项卡 或 手动下载按钮 在右上方
• 拆开 Twitch市场 - Twitch集成 进入 BepInEx/插件 (应该只是一个单一的 .dll 文件)
• 启动游戏以生成配置文件，然后关闭游戏。
• 编辑配置文件以连接到Twitch（请参阅下方“如何连接到Twitch？”部分）
  

观看来自此处的视频 satsu2cents详细安装说明：
感谢你制作这个教程！


如何连接到Twitch？

打开 BepInEx/config/TwitchIntegration.cfg 用任意编辑器打开文件
2. 搜索 [Twitch 认证] 章节
3. 在以下位置输入你的Twitch用户名 用户 = 玩家 (请将 REPLACE 替换为你的用户名)
4. 在下方输入你的Twitch频道名称 渠道 = 替换 （请将REPLACE替换为您的频道名称）
频道名称基本上就是你的Twitch用户名，或者是你要连接的另一个频道的用户名
5. 在下方输入你的Twitch OAuth令牌 OAuth = REPLACE (请将REPLACE替换为您的OAuth令牌)
- 点击/前往配置中的链接并生成一个OAuth令牌。(https://letsi.github.io/Twitchmarket)
- 然后将完整的 OAuth 令牌（包含 oauth:）复制并粘贴到配置中。
- 别给任何人看
6. 保存配置文件并启动游戏
7. 读取存档或开始新游戏。
如果你在屏幕顶部看到Twitch已连接，那就说明你已正确完成所有设置。
如果显示未找到OAuth令牌或您已断开连接，请重复上述步骤并生成新的OAuth令牌。


FAQ

游戏无法连接到Twitch，我该怎么办？
- 请检查你的配置，确保OAuth令牌已按 oauth:TOKEN 的格式正确填写，而非仅填写TOKEN
频道名称和用户名是否输入正确？请检查是否有拼写错误

这个模组与另一个模组不兼容。你能检查一下吗？
- 是的，我可以检查这个，请在Discord上告诉我。

你能添加X功能吗？
加入Discord，告诉我你的想法！

名字显示了两次。你能修复这个问题吗？
你需要在选项中把视野（FOV）设为60。那是游戏的默认值。
- 或移除 自定义视野（FOV） 将视野（FOV）调整为高于默认值60的模组

你会说其他语言吗？
- 是的，德语！如果这对你来说更方便，请尽管用德语写！

我的问题不在常见问题解答中！
加入下方的Discord并在那里提问。希望我能给你一个答案。

游戏一会儿后覆盖层就卡住了！我该怎么办？
- 按 F5 键刷新连接，或在设置中自定义按键。 TwitchIntegration.cfg