製作遊戲與獎勵

可以，你的遊戲能夠響應 TikTok 禮物

JavaScript 決定操作：加速火箭、種植花園、產生敵人或推進共同目標。門檻也由你選擇。SSN 無法修改平台禮物價格。

選擇範本

每個預覽都有範例按鈕和「最後收到的資料」檢查器。範例是模擬事件，不是購買；預覽模式不會加入真實工作階段。

• 在 HTML 中搜尋 EDIT THIS RULE 或 EDIT THESE RULES.
• 將遊戲邏輯寫入 receive(data) 函式。
• 連線和計數輔助程式位於 starter.js。樣式位於 starter.css.

三步連接範本

1. 啟動 SSN 並連線聊天，確認 Dock 顯示聊天和禮物。TikTok 請參見 連線模式.
2. 開啟範本 不帶 ?demo，使用工作階段 ID（設定了密碼時也需包含）。
3. 先在瀏覽器檢查，再將同一連結作為瀏覽器來源加入 OBS，例如設為 1000×800。

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

• &clean 隱藏檢查器、連線狀態和實況主按鈕。
• 沒有密碼？省略 &password=….
• 在測試版網站上，保留 /beta/ 在以下路徑之前： games/.

建立自己的副本並從磁碟執行

不需要安裝伺服器。編輯電腦中的檔案，再讓 OBS 指向它。

1. 下載 beta 原始碼 ZIP 並解壓縮。
2. 在原檔旁複製所需範本，例如： games/templates/my-rocket.html.
3. 保留資料夾結構。範本會載入 js/local-server-url.js，支援目標還會載入 currency.js ，從頂層資料夾載入。圖片和音訊也需保留原位。
4. 將 HTML 檔案拖進 Chrome 或 Edge，複製 file:/// 位址。
5. 加入從以下位置開始的全部內容： ? 起的所有內容，從可用的遊戲連結複製（工作階段、密碼、傳輸選項）。
6. 在OBS中，離開 本機檔案 取消勾選，把完整位址貼到瀏覽器來源的 URL 領域。
7. 每次編輯後重新整理瀏覽器來源。

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

使用真實路徑，不要移動解壓縮資料夾。工作階段是 SSN 連線 ID，不是遊戲名稱。移除 demo 以接收即時輸入。保持 SSN 和擷取執行。更多範例： 文件設定指南.

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.

如何選擇操作所需的金幣數量？

先決定衡量什麼，再選擇數字。

精確值、最低值還是累計餘額？

• 精確值： coins === 10。25 金幣的禮物不會觸發任何操作。
• 每次事件最低值： coins >= 10.
• 累計餘額： 是火箭使用的方式。25 金幣觸發兩次加速，剩餘 5 金幣。

有多個級距？先檢查最高級，避免一份禮物觸發所有較低級距。

各平臺傳送什麼

type 說明來自哪裡。 event 存在時說明發生了什麼。收到什麼取決於擷取模式、設定和平台。這裡反映 SSN 目前程式碼，不保證所有帳戶都收到所有事件。

其他來源可能回報小費、禮物、會員或購買。檢查 事件參考 ，然後才加入模板的 isSupport 篩選條件。銷售或贈送訂閱不自動算作小費。YouTube 同時傳送購買禮物和每位接收人的通知，兩者都計數會重複獎勵同一禮物。

正確使用 donoValue 和 currency.js

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

不要這樣做

• donoValue || convertToUSD(...) ——它會丟棄本應保留的零值。
• 從以下內容擷取數字： chatmessage 來識別付款。
• 要求必須存在 event === "donation" —— Facebook Stars 和部分 Cheer 沒有事件欄位。

支持目標範本先篩選支持類型，再呼叫共用轉換器。

同一連送只計一次

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，因為瀏覽器擷取可能從不傳送它。如果只想在連送結束時執行一次，請按連線實際傳送的欄位另寫規則。
• 只用一條擷取路徑。同一頻道的第二路擷取可能使用不同 ID，導致重複計數。

不需要自訂遊戲的獎勵

在 Event Flow:

1. 新增 比較屬性.
2. 設為 donoValue, 大於或等於，以及美元金額。
3. 連接聲音、動畫或 OBS 控制等操作。

來源自帶數值有效時優先使用，否則使用 SSN 匯率轉換。

• 某個特定 TikTok 禮物： 比較 meta.giftId 或 meta.giftName，並將流程限定為 TikTok 禮物事件。
• 對以下值進行數字檢查： hasDonation 也會轉換為美元，不是原始金幣檢查。金幣規則請使用原生中繼資料或自訂程式碼。
• 每則訊息分別檢查。 這不是累計餘額或連送計數器。請使用 狀態節點 來實現，或將該邏輯保留在遊戲中。

連接付費操作前先測試

1. 範例按鈕。 1→2→3 的連送共增加三份禮物。零值覆寫範例不增加美元金額。價格未知時不增加精確金幣數。
2. 真實來源。 查看真實擷取資料，確認禮物名稱/ID、數額、單位、數量和事件。範例測試的是規則，不是真實擷取。
3. OBS 場景。 測試重複事件、重新連線和重新整理。需要保留記憶體中的進度時，不要重新整理或關閉瀏覽器來源。

更多連線細節： 自定義疊加層.