게임과 보상 만들기

네, 게임이 TikTok 선물에 반응할 수 있습니다

JavaScript에서 로켓 가속, 정원 성장, 적 생성, 공동 목표 채우기 등을 정합니다. 기준값도 직접 선택합니다. SSN은 플랫폼의 선물 가격을 바꿀 수 없습니다.

템플릿 선택

각 미리 보기에는 샘플 버튼과 '마지막 수신 페이로드' 검사기가 있습니다. 샘플은 가짜 이벤트이며 구매가 아닙니다. 미리 보기는 실제 세션에 접속하지 않습니다.

• HTML에서 다음을 찾으세요: EDIT THIS RULE 또는 EDIT THESE RULES.
• 게임 로직을 다음에 넣으세요: receive(data) 함수.
• 연결 및 집계 도우미 위치: starter.js. 스타일은 다음에 있습니다: starter.css.

3단계로 템플릿 연결

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. 베타 소스 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(...) 은 의도한 0값을 버립니다.
• 다음에서 숫자 추출하기: 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, 크거나 같음과 USD 금액을 지정하세요.
3. 소리, 애니메이션, OBS 제어 같은 동작을 연결하세요.

소스의 값이 유효하면 사용하고, 아니면 SSN 통화 변환을 사용합니다.

• 특정 TikTok 선물: 비교 meta.giftId 또는 meta.giftName을 쓰고 흐름을 TikTok 선물 이벤트로 제한하세요.
• 다음의 숫자 비교: hasDonation 도 USD로 바뀝니다. 원래 코인 값을 비교하는 것이 아닙니다. 코인 규칙에는 원본 메타데이터나 사용자 코드를 쓰세요.
• 각 조건은 메시지마다 검사합니다. 누적 잔액이나 연속 선물 카운터가 아닙니다. 다음을 쓰세요: 상태 노드 이 필요하면 사용하거나 게임 안에 그 로직을 두세요.

유료 동작 연결 전에 테스트

1. 샘플 버튼. 1→2→3 연속 선물은 선물 세 개를 더합니다. 0 덮어쓰기 샘플은 USD를 더하지 않습니다. 가격을 모르면 정확한 코인을 더하지 않습니다.
2. 실제 소스. 실제 캡처 페이로드에서 선물 이름/ID, 금액, 단위, 개수, 이벤트를 확인하세요. 샘플은 규칙을 테스트하며 실제 캡처를 검증하지 않습니다.
3. OBS 장면. 중복 이벤트, 재연결, 새로 고침을 확인하세요. 메모리의 진행 상황을 유지하려면 브라우저 소스를 새로 고침하거나 종료하지 마세요.

연결 세부 정보: 맞춤 오버레이.