한국어
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

경품 추첨, 참가권, 포인트 경품

경품 추첨 도구가 처음인가요? 다음부터 시작하세요: 첫 경품 추첨: 스크린샷과 함께하는 안내.

호스트 하나로 추첨을 진행하세요. 팝업, Stream Deck, Event Flow가 해당 호스트를 제어하며 시청자 화면은 확정된 결과를 표시합니다.

첫 무료 경품 추첨 진행

  1. 팝업에서 다음을 여세요: 경품 추첨 옵션. ID는 다음으로 유지하세요: default, 키워드: !enter, 참가권 가격과 포인트 경품은 0으로 설정하세요.
  2. 당첨자 카드, 이름 릴, 커뮤니티 룰렛 중에서 선택하세요. 표시를 미리 본 다음 링크를 OBS 브라우저 소스에 복사하세요.
  3. 선택: 참가 접수 시작. 시청자는 캡처된 채팅에 키워드를 보내 참가합니다.
  4. 선택: 참가 마감, 그다음은 당첨자 추첨. 미리 마감하지 않았더라도 추첨 시 참가가 닫힙니다.
  5. 선택: 새 라운드 로 다른 추첨을 시작하세요. 이전 당첨자는 호스트 기록에 남습니다.

SSN 호스트를 계속 실행하세요. OBS 브라우저 소스와 상호작용할 필요는 없습니다. 커뮤니티 독립형 룰렛은 다음 없이도 계속 사용할 수 있습니다: &managed; 포인트와 원격 제어는 관리형 모드를 사용합니다.

SSN 포인트로 결제하는 참가권

  1. 기존의 다음을 활성화하세요: 참여 포인트 시스템 를 팝업에서 활성화하세요. 이 포인트는 Twitch 채널 포인트 및 개별 게임 점수와 별개인 SSN 포인트입니다.
  2. 다음 항목 아래에서: 참가권 및 포인트 경품, 참가권당 포인트와 시청자당 최대 참가권 수를 설정하세요. 가격 1은 1포인트당 참가권 한 장을 뜻합니다.
  3. 참가를 여세요. 추첨 이름이 다음이면: friday, 시청자는 다음으로 참가권 다섯 장을 구매합니다: !ticket friday 5.
  4. 다음에서 참가자를 확인하세요: 경품 추첨 및 기록 관리. 구매가 성공하면 포인트 차감과 참가가 함께 처리됩니다. 잔액이 부족하면 참가권이 생성되지 않습니다.

참가권 구매는 포인트를 즉시 예약하므로 같은 포인트로 스티커를 구매하거나 다른 유료 추첨에 참가할 수 없습니다. 추첨하면 해당 포인트가 소비됩니다. 취소 및 환불 는 예약 포인트를 돌려줍니다. 추첨 전에 참가자 한 명을 제거하면 그 참가자의 예약을 반환합니다. 유료 라운드를 새 라운드로 조용히 버릴 수는 없습니다.

첫 참가 후 규칙이 잠깁니다. 닫기/열기로 기존 규칙을 유지한 채 라운드를 잠시 중지할 수 있습니다. 가격이나 자격을 바꾸려면 취소하고 다른 라운드를 만드세요. 시청자는 참가한 뒤 지갑이나 판돈 방향을 바꿀 수 없습니다.

포인트 경품 지급

설정: 당첨자당 포인트 경품 그리고 경품 수 를 참가 접수 전에 설정하세요. 각 경품은 선택된 시청자의 기존 계정에 해당 SSN 포인트를 더합니다. 포인트를 새로 생성하며 참가권 수입이나 운영자 지갑에서 가져오지 않습니다. 총 발행량은 설정된 경품 금액과 당첨자 수로 제한됩니다.

여러 경품은 한 번에 하나씩 추첨하세요. 확정된 당첨자는 표시 애니메이션 전에 기록됩니다. 이미 알려진 결과를 되돌리려고 완료된 추첨을 취소할 수는 없습니다. 실수는 호스트가 의도적으로 포인트를 조정해 수정하세요. 표시 변경이나 재연결로 다시 지급되지는 않습니다.

포인트 보상이 있는 게임

관리형 Number Hunt

선택: Number Hunt(진행자 제어), 참가권 비용 0, 경품 하나, 선택적 포인트 경품으로 설정하세요. 진행자는 1~100 중 숫자를 선택합니다. 참가자는 다음을 사용합니다: !guess friday 50에서 경품 추첨 ID를 바꾸세요. 정답은 첫 유효 정답자에게 한 번 지급하며 오답은 모두의 범위를 좁혀 줍니다. 시청자마다 5초에 한 번 추측할 수 있습니다.

관리형 추첨 표시 화면 또는 다음을 사용하세요: games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. 일반 Number Hunt와 다른 기존 게임은 원래의 로컬 동작을 유지합니다. 로컬 점수와 당첨자 라벨이 자동으로 SSN 포인트를 지급하지는 않습니다.

Coin Flip Pot

운에 따라 결과가 정해지는 게임입니다. 선택: Coin Flip Pot, 가격 1, 결과 하나, 추가 경품 0으로 설정하세요. 시청자는 다음으로 포인트를 겁니다: !ticket friday 3 heads 또는 !ticket friday 3 tails. 양쪽 모두 참가자가 있어야 합니다. 참가를 마감하고 추첨하면 호스트는 판돈 합계와 무관하게 앞면 또는 뒷면을 같은 확률로 고릅니다.

승리한 시청자는 자기 판돈을 돌려받고 패배한 판돈을 자기 판돈 비율에 따라 나눠 받습니다. 정수 포인트 나머지는 소수 몫이 큰 순서로 배분하며 동률이면 참가 순서로 정합니다. 수수료는 없고 추가 포인트를 생성하지 않습니다. 승리 판돈이 2와 1이고 패배 포인트가 5이면 총 8포인트에서 각각 5와 3을 받습니다. 모두 환불하려면 추첨 전에 취소하세요. 한쪽이 비어 있으면 추첨이 거부되며 취소/환불할 수 있습니다.

여러 경품 추첨

각 추첨에 영문자, 숫자, 하이픈 또는 밑줄로 짧은 ID를 지정하세요. 시청자는 모든 ID에서 구매할 때 같은 사용 가능 지갑 잔액을 공유합니다. 각 OBS URL에는 다음이 포함됩니다: &giveaway=ID. 참가권 및 추측 명령은 추첨 이름을 명시합니다. 동시에 진행하는 무료 추첨에는 서로 다른 키워드를 사용하세요. 모호한 무료 키워드로 여러 추첨에 실수로 참가하지 않습니다.

팝업 필드는 설정값입니다. 호스트에 확정된 규칙을 보려면 새로고침하거나 관리자를 여세요. 시청자 링크를 바꾸면 표시 설정만 바뀌며 진행 중인 라운드의 참가권 규칙은 다시 쓰지 않습니다.

OBS 및 표시 방식

관리형 기본 배경은 투명합니다. 원하면 테마 패널을 선택하세요. 카드, 릴, 커뮤니티 룰렛은 같은 결과와 여섯 색상 스타일을 공유합니다. 동작 줄이기 설정을 사용하면 공개 애니메이션을 건너뜁니다. 룰렛은 최대 120개 이름을 미리 보여주며 모든 참가권 확률을 완전히 표현하는 것이 아니라 결과 공개 애니메이션입니다. 선택에는 전체 유효 참가권 풀을 사용합니다.

재연결하면 표시 화면은 저장된 결과를 보여줍니다. 화면이 연결되어 있어도 SSN은 해당 OBS 장면이 현재 보이는지 알 수 없습니다. 컨트롤러 URL, 세션 ID, 백업 파일은 비공개로 유지하세요.

Event Flow

추가: 경품 추첨 / 참가권 를 포인트 동작에서 선택하세요. Enter free giveaway, Buy tickets, Grant free tickets, Close entries, Draw winner, Cancel and refund 또는 Query state를 선택하세요. ID와 참가권 수를 선택하고 판돈 구매에는 앞면/뒷면을 선택하세요. 동작은 캡처된 시청자 식별 정보를 사용합니다. 무료 지급이나 운영자 제어 앞에는 신뢰할 수 있는 트리거/필터를 사용하세요.

참가권 구매는 이미 포인트를 사용합니다. 앞에 Spend Points를 넣지 마세요. 실패하면 원래 채팅을 숨기지 않고 의존하는 동작을 중지합니다. 결과는 다음에서 확인할 수 있습니다: meta.giveawayControlResult. Event Flow 테스트 패널은 실제 참가권을 구매하지 않고 이 동작을 시뮬레이션합니다. 실제 라운드 변경을 포함한 전체 경로 테스트에는 격리된 호스트/프로필을 사용하세요.

구매 자격은 동작 실행 시 확정된 잔액을 사용합니다. 참가 메시지 자체로 마지막 필요한 포인트를 얻을 것이라고 가정하지 마세요. 플랫폼 고유 소스 메시지 ID는 지속적인 재생 방지를 제공합니다. ID가 없는 소스는 재시작 간 식별 보장이 더 약합니다. 캡처된 시청자/메시지 ID가 없는 일반 예약 이벤트는 누군가를 대신해 구매할 수 없습니다.

Stream Deck 및 API

기본 플러그인에는 Open Giveaway, Close Giveaway, Draw Giveaway, Cancel & Refund, New Giveaway Round, Giveaway State가 있습니다. 기본 ID: default. 입력: {"giveawayId":"friday"} 를 value 필드에 넣으면 다른 라운드를 선택합니다. Open은 다음 객체도 받을 수 있습니다: config 객체를 받을 수 있습니다. 그렇지 않으면 기존 라운드는 확정된 규칙을 유지하고 새 ID는 팝업 기본값을 사용합니다.

기존 P2P 연결 또는 설정된 WebSocket 전송을 사용하세요. 키는 SSN 응답을 보고하며 OBS가 라이브라고 주장하지 않습니다. 응답 시간이 초과되면 새 추첨을 시도하기 전에 상태를 조회하세요.

{"protocol":2,"action":"buygiveawaytickets","get":"callback-1","value":{"giveawayId":"friday","roundId":"ROUND_ID","operationId":"purchase-123","count":5,"actor":{"chatname":"Avery","type":"youtube","userid":"SOURCE_USER_ID"}}}

작업 ID는 업무 작업을 식별하고 콜백 ID는 응답을 식별합니다. 재시도할 때 작업 ID를 유지하세요. 다른 매개변수로 재사용하면 실패합니다. 의도적으로 새 구매를 할 때는 새 작업 ID를 사용하세요. 운영자 API 접근은 제공된 행위자의 포인트를 사용할 수 있으므로 인증 없는 공개 구매 폼으로 노출하지 마세요.

기록, 백업, 복구

관리자는 라운드, 참가자, 당첨 기록을 나열합니다. 당첨 기록을 JSON으로 내보내거나 전체 버전 2 포인트/추첨 백업을 저장하세요. 전체 백업에는 잔액, 예약, 라운드, 작업 영수증이 함께 들어 있습니다. 서버로 업로드하지 않습니다.

호스트가 재시작되면 저장된 진행 중 라운드는 검토를 위해 닫힙니다. 참가권은 예약 상태로 남습니다. 같은 규칙으로 다시 열거나 추첨하거나 취소/환불하세요. 중단된 데이터베이스 거래는 완전히 확정되거나 부분 구매/지급을 남기지 않습니다. 확정된 전달 확인이 없는 스티커 예약은 시간 제한 후 복구됩니다.

전체 복구는 다음에서 가능합니다: 기존 잔액이나 추첨 기록이 없는 새 호스트. 전체 스냅샷을 복원하고 복원된 라운드는 닫힌 상태로 유지합니다. 데이터가 있는 호스트를 덮어쓰는 것은 거부합니다. 라운드를 재개하기 전에 팝업에서 원래 스트림/세션 ID를 복원하세요. 복구 결과에 백업 세션이 나열됩니다. 이 백업은 일반 팝업 설정을 대신하지 않습니다. 같은 경제 시스템에서 이전 호스트와 복구된 호스트를 독립적인 관리 주체로 동시에 실행하지 마세요. 백업은 스냅샷이므로 저장한 뒤 발생한 거래를 포함할 수 없습니다.

잔액만 가져오면 미결 예약을 복원할 수 없습니다. 해당 자금이 예약되어 있으면 포인트 초기화와 수동 덮어쓰기는 거부됩니다. 포인트 초기화는 추첨 영수증/기록을 지우지 않습니다. 잔액은 해당 브라우저/앱 프로필에 속하며 라운드는 세션별입니다. 별도 프로필/장치는 자동 동기화되지 않습니다. 브라우저 데이터를 지우면 로컬 기록이 사라질 수 있으므로 백업은 프로필 밖에 보관하세요.

선택적 서버 백업/동기화는 향후 기능이며 이번 릴리스에 포함되지 않습니다. 이 구현은 업로드, 서버 자격 증명, 구매 화폐 또는 현금 인출을 추가하지 않습니다.

작동하지 않을 때

API 참고 문서 · 이벤트 계약 · 투표 및 참가 대기열

백업 단계별 복구

  1. 이전 호스트는 중지해 두세요. 새 브라우저 프로필에서 SSN을 열고 추첨 관리자를 여세요.
  2. 다음 항목 아래에서: 새 호스트에서 복구, 전체 백업을 선택하세요. 복구 메시지를 기다리고 표시된 원래 세션 ID를 기록하세요.
  3. 팝업의 세션 옵션, 원래 세션 ID를 입력하세요.
  4. 관리자로 돌아가 추첨 ID를 선택하고 다음을 선택하세요: 새로고침. 규칙, 참가자, 당첨 기록을 확인하세요. 복구된 진행 중 라운드는 검토를 위해 닫힙니다.
  5. 같은 규칙으로 다시 열거나 추첨하거나 다음을 선택하세요: 취소 및 환불 로 예약된 참가권을 반환하세요. 결과를 검토한 뒤 새 백업을 저장하세요.

OBS에서는 1280 × 720 브라우저 소스로 시작하세요. 관리형 룰렛은 남은 소스 높이에 맞춰집니다. 기본 배경은 사용자 지정 CSS 없이 투명하며 일반적인 제어는 모두 팝업, 관리자 또는 Stream Deck에 있습니다.