制作游戏与奖励

可以，你的游戏能够响应 TikTok 礼物

Social Stream Ninja 采集事件并发送到你的页面，再由你的 JavaScript 决定效果：推进火箭、种植花园、生成敌人或推进共同目标。操作和阈值由你在游戏中设定。SSN 不能更改平台礼物价格。

从这里开始： 试用三个模板，然后选择规则使用的计量方式： 平台单位、礼物身份或估算 USD.

对于新的视觉设计，请参见 自定义游戏并本地运行.

要触发声音、提示、OBS 操作或 webhook，请先使用 Event Flow。需要游戏界面或自己的游戏状态时，可以使用自定义 HTML 页面。现成游戏请查看 游戏库.

三个小型可编辑模板

每个预览都有示例按钮和“最近收到的数据”检查器。示例是虚构事件，不会购买礼物。预览模式不会加入直播会话。

• 金币火箭: 每 10 枚 TikTok 金币、100 个 Twitch Bits 或 100 颗 Facebook Stars 可推进一次。余量按观众和平台分别累计。修改 COST 以设置金额。
• 共同支持目标: 合并四个平台估算的 USD 支持来建设月球基地。修改 GOAL_USD ，或将进度显示替换为伤害、燃料或计时器。
• 礼物与事件花园: 选定的 TikTok 礼物增加花朵，采集到的 TikTok 关注增加树木，免费的 !water 聊天命令增加水量。将 GIFT_ID 设为采集到的 ID，或者将 GIFT_NAME 设为确切名称。“Demo flower” 是虚构示例。

打开 HTML 源代码并查找 EDIT THIS RULE 或 EDIT THESE RULES。 receive(data) 函数用于将示例操作替换成你的游戏逻辑。连接和计数辅助函数位于 starter.js；视觉样式位于 starter.css.

将模板连接到直播

1. 启动 SSN 并连接聊天来源，确认聊天和礼物/支持记录到达 dock。TikTok 设置请参阅 连接模式.
2. 打开模板时不要加 ?demo，使用你的 SSN 会话 ID。如果设置了会话密码，也需要提供。
3. 先在浏览器检查页面，再将同一网址加入 OBS 浏览器源，例如设置为 1000 × 800。添加 &clean 以隐藏检查器、连接状态和主播按钮。

https://socialstream.ninja/games/templates/coin-rocket.html?session=YOUR_SESSION&password=YOUR_PASSWORD&clean

使用 beta 网站时，请保留 /beta/ 在以下路径之前： games/。没有密码时请省略密码参数。请勿公开会话链接。

默认连接使用与 SSN 叠加层相同的 iframe 桥接。若要使用托管 WebSocket 的已采集聊天通道，请在 SSN 启用 通过服务器将扩展中的消息发送到停靠面板 设置并附加 &server2。请参阅 WebSocket 指南 了解本地设置；这些模板也接受 &server2&localserver 和 &localserverport=3000. localserver 本身不会启用通道。旧的 server 使用不同通道，并可能需要 dock 向该通道发布数据。

制作自己的副本

下载 beta 源代码 ZIP 并解压。编辑以下目录中的文件： games/templates/，并保留目录结构：模板还需要加载 js/local-server-url.js，支持目标还会加载 currency.js 从代码库根目录加载。

将起始 HTML 拖入 Chrome 或 Edge 并复制其 file:/// 地址。添加所有内容 ? 继续在您的工作 SSN 游戏链接中，包括您的会话和任何密码。在浏览器中打开该地址，然后将其粘贴到 OBS 浏览器源的 URL 场与 本地文件 未检查。 OBS 保存该地址以供下次使用。

file:///C:/SSN/social_stream-beta/games/templates/coin-rocket.html?session=YOUR_SESSION&clean

使用计算机上的实际路径。将解压的文件夹保留在同一位置；无需安装或启动服务器。请参阅 文件设置指南 了解更多示例。

自定义游戏设计并本地运行

使用上面的三个启动器来玩新游戏，或者复制您使用的确切页面 games/. games.html 和 battle.html 也有自己的游戏行为；初学者的规则常量不是通用的游戏 API。

下载源ZIP，将其解压，然后将所选 HTML 复制到原始文件旁边。例如，保留 例如， my-rocket.html 在 games/templates/，带有 starter.js, starter.css、根 js/ 助手，以及任何引用的图像或音频。给人工智能这些文件并 docs/event-reference.html.

使用以下命令直接从磁盘打开副本 文件设置步骤.编辑后的起始地址的示例地址是：

file:///C:/SSN/social_stream-beta/games/templates/my-rocket.html?session=YOUR_SESSION&clean

使用实际生成的链接的会话、密码和传输选项。删除 demo 用于实时输入；保留 clean 在这些启动器上隐藏操作员工具。会话是SSN连接ID，而不是游戏名称。保持 SSN 和捕获运行。

在OBS中，离开 本地文件 取消选中并将完整文件地址粘贴到浏览器源的 URL 领域.保存设计更改后，刷新源以加载它。

AI设计提示

Customize [game file] to match [reference], at [canvas size].
Include its existing CSS/JS and local artwork/audio. Preserve the game's
rules, controls, gift/coin/USD distinctions, streak handling, duplicate
handling, and demo/clean modes. Change the visual design, not the reward rules,
unless I explicitly specify a rule change. Keep session/password and
transport parsing, relative paths, and Chrome 80-compatible classic scripts.
Read docs/event-reference.html and docs/making-games.html.

Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.

Make the edited game work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files/assets, file URL and OBS setup steps, and tests using
fictional data. Preserve image-only events and a valid donoValue of zero.
Never treat chat text as proof of a payment.

使用启动器按钮在演示模式下进行测试，包括重复的条纹更新和零值覆盖。然后使用您的会话测试实际事件路由，最后测试 OBS 源的预期大小。检查游戏玩法和 安全渲染；单独的工作动画并不能验证游戏规则。

如何选择操作所需的金币数量？

先决定要衡量什么，再选择数值：

确定金额采用 精确匹配 (coins === 10）、 每个事件的最低值 (coins >= 10），或 累计余额。火箭使用累计余额：25 枚金币产生两次推进，并剩余 5 枚。仅匹配“恰好 10”的规则会忽略 25 枚金币。如果每个事件只能从多个档位中触发一个操作，请先检查最高阈值，避免同时触发所有较低档位。

在 TikTok 上，观众购买金币并用来赠送礼物；礼物会显示金币价格。选择自己 LIVE 中可用的礼物，发布规则前检查采集数据。礼物名称、礼物数量、金币和钻石是不同计量方式。不要将 USD 估值反算成“精确金币数”，也不要把钻石数当成金币数。 TikTok 关于金币和礼物的说明.

若采集只提供礼物名称/数量或钻石标签，金币模板会跳过该事件，除非含有明确的金币元数据。可改用礼物身份规则或估算 USD 模板。金币元数据也可能来自 SSN 礼物映射；需要准确价格时，请与当前 LIVE 礼物列表核对。礼物目录和采集方式各异，没有保证每条 TikTok 消息都包含的通用金币字段。

各平台发送什么

type 标识来源； event 在存在时标识操作。是否可用取决于采集模式、设置和平台开放的数据。示例描述的是 SSN 当前代码路径，不保证每个账号都提供所有事件。

平台参考资料： TikTok 钻石; Twitch Bits 与订阅; Meta 的 Stars 概述; YouTube Super Chat 与 Super Stickers; YouTube Jewels、Gifts 与 Rubies。术语核对日期为 2026 年 9 月 29 日；资格和可用性请以平台当前说明为准。

其他来源也可能报告小费、礼物、会员或购买。请检查 事件参考 ，然后才加入模板的 isSupport 过滤器。商品销售或赠送订阅不自动等于小费。例如 YouTube 区分礼物购买与接收者领取通知，同时计入会让同一礼物获得两次奖励。

正确使用 donoValue 和 currency.js

hasDonation 是原始显示标签，例如 €5.00 或 100 bits. donoValue 是来源可选提供的数字 USD 金额。根据标签估算前，应优先采用有效覆盖值，包括零。保留原始标签用于显示。

<script src="../../currency.js"></script>
<script>
// From games/templates/: use the existing helper, including its zero handling.
var usd = getDonationValueUSD(data);
// Use usd for your rule; display data.hasDonation for the original amount/unit.
</script>

现有换算行为： SSN 当前估算一枚 TikTok 金币为 0.01 美元、一颗 TikTok 钻石为 0.005 美元、一个 Twitch Bit 或 Facebook Star 为 0.01 美元、一颗 YouTube Jewel 为 0.005 美元。无价格的 TikTok 礼物默认每份按一枚金币估算；没有 Jewel 数量的 YouTube Gift 使用独立的 0.01 美元占位估值。法币换算也使用内部近似汇率，并非实时汇率服务。

这些只是 SSN 用于比较的数值，并不统一代表观众花费、创作者净收入或可提现余额。不同采集方式可能产生不同估值。尤其是未知 TikTok 礼物回退为一枚金币，并不能证明它实际只需一枚金币。

不要使用 donoValue || convertToUSD(...)：这会丢弃有意设置的零值。请勿从以下字段提取数字来判断付款： chatmessage 来检测付款，也不要强制要求 event === "donation"：Facebook Stars 和部分 Cheers 没有事件标记。支持目标模板先筛选支持类型，再调用共用换算函数。

来源： currency.js 以及 数据格式参考。礼物元数据是可选的；示例不会虚构采集中缺少的字段。

同一连送只计一次

TikTok 可能为同一次连送依次报告累计数量 1、2、3。这是三份礼物，不是六份。累加操作应保存已收到的最大数量或金额，只应用增加部分。总量相同的完成通知不再增加数值。

// All three events refer to the same streak:
// incoming total: 1, 2, 3, 3
// added to game:  1, 1, 1, 0
var newCoins = RewardStarter.increment(data, RewardStarter.coins(data), 'coins');

辅助函数优先采用可用的 TikTok 原生群组/发送者/礼物 ID，其次使用 meta.tiktokGiftStreakId 或消息 ID。普通消息 ID 也能阻止重复投递。它不会等待 repeatEnd ，因为浏览器采集可能从不提供该字段。如果设计要求在连送结束后只触发一次，需要基于实际连接提供的字段另写完成规则。

这些教学模板最多在内存中保存 2,000 个标识。重置或刷新会清除记忆和游戏进度。没有稳定 ID 的消息无法可靠去重；同一频道的第二条采集通道也可能使用不同 ID。请先使用单一采集通道。火箭按平台和用户 ID 区分余额，缺少 ID 时改用显示名称，因此同名用户可能共用余额。需要长期保存的游戏应先加入状态存储和重播处理，再依赖付费奖励在重启后保留。

无需自定义游戏的奖励

在 Event Flow，使用 比较属性 带有 donoValue, 大于或等于以及 USD 阈值，然后连接声音、动画或 OBS 控制等操作。比较时优先采用来源提供的有效值，必要时使用现有的货币换算。

要匹配指定 TikTok 礼物，请比较 meta.giftId 或 meta.giftName，并将流程限定为 TikTok 礼物事件。对以下字段的数值比较： hasDonation 也会转换为 USD，并非直接比较金币。金币专用规则应采用原生元数据或自定义代码。

按每条消息判断阈值，与累计余额或连送计数不同。不要假定 Event Flow 阈值会自动实现模板的累计和去重逻辑。请使用 状态节点 处理需要状态的流程，或将这些逻辑保留在游戏中。

连接付费操作前先测试

1. 使用示例按钮测试。1 → 2 → 3 连送应只增加三份礼物的价值；显式零值示例不应增加 USD；未知价格不应增加精确金币数。
2. 连接真实来源并检查实际采集的数据。确认礼物名称/ID、金额/单位、数量，以及规则需要的事件。示例只能验证规则，不能证明平台直播采集成功。
3. 在 OBS 场景中验证重复事件、重连和刷新。如果需要保留内存中的当前进度，请避免关闭或刷新该浏览器源。

无人值守或 AFK 游戏需要 SSN、来源采集和游戏页面持续运行。电脑休眠、登录过期或断线会中断操作；这些模板不会补发遗漏事件，也不处理退款。自动响应不代表允许通过无人值守直播获利；请核对平台对该直播形式的现行 LIVE 和变现规则。

如果收不到数据，先检查 SSN dock，再检查会话/密码和传输设置。如果聊天能到达但礼物不匹配，请检查数据和打赏/事件过滤器。关注和订阅事件的可用性因来源而异；请参阅 事件参考。更多连接说明请参阅 自定义叠加层.