Wheel of Item

로그인하셨네요 — Pro를 통해 스트리머 대시보드를 전부 잠금 해제하세요

무료 계정은 설정 가이드와 테스트 파이프라인을 둘러볼 수 있어요. 구성 가능한 대시보드(룰렛 선택, 도네이션 트리거, 음성, VTube Studio)는 Pro 등급이 필요해요.

Pro Supporter 되기 — 월 $1
스트리머 & Vtuber용

시청자가 도네이션으로 룰렛을 돌리게 하세요

Streamlabs 도네이션 도착 → OBS에서 룰렛이 자동으로 회전, 도네이터 이름이 음성으로 호명되며, VTube Studio 모델이 단축키로 반응해요. 브라우저 소스 하나. 봇 없음, 확장 프로그램 없음, Twitch 개발자 계정 불필요.

스트리머 대시보드 열기 → 4단계 설정 보기
약 5분 안에 라이브 토큰은 브라우저에만 머물러요 🆓 무료 체험, Pro로 라이브 송출

도네이션 하나. 세 가지 반응, 동시에.

모든 후원이 같은 이벤트를 발사해요 — 각 구독자가 독립적으로 듣고 반응해요. 어떤 조합이든 가능해요.

무료 테스트 · PRO 라이브

룰렛 자동 회전

도네이터와 금액이 OBS 오버레이에 토스트로 표시되고, 룰렛이 돌아가 당첨자에서 멈춰요. 일반 룰렛이나 가챠폰 등급 굴리기에서 작동해요.

진행 중

이름을 음성으로 호명

Web Speech TTS가 스트림에서 "감사합니다 도네이터님, 5달러!"를 읽어줘요. 음성, 속도, 피치 선택 — 완전히 커스터마이즈 가능한 템플릿. OBS가 오디오 출력에서 캡처해요.

진행 중

VTuber 모델 트리거

규칙에 따라 VTube Studio 단축키가 발사돼요 — 예: $50 도네이션 → "에픽 댄스", 메시지에 "손 흔들기" 포함 → "손 흔들기 모션". 로컬 WebSocket, 클라우드 중간자 없음.

4단계 설정

총 소요 시간: 약 5분. 저장된 룰렛 템플릿과 Streamlabs 계정이 필요해요.

1

스트리머 대시보드 열기

streamer.wheelofitem.com/dashboard로 이동하여 wheelofitem.com에서 사용하는 동일한 Google 계정으로 로그인하세요.

실제로 라이브 송출하려면 Pro 등급이 필요해요. 무료 계정은 수동 모드에서 모든 것을 테스트할 수 있지만, Pro Supporter가 되기 전까지 Streamlabs 어댑터는 발사되지 않아요. 월 $1에 업그레이드 →
2

저장된 룰렛 또는 가챠폰 선택

아직 없으신가요? 메인 페이지에서 룰렛을 만들거나 가챠폰을 설정한 다음 새로 저장을 클릭하세요. 대시보드 섹션 2에 표시될 거예요.

여러 템플릿을 저장할 수 있어요 — 스트림마다 다른 상품, 언어별 다른 룰렛 등 — 그리고 대시보드에서 어떤 것이 "라이브"인지 전환할 수 있어요.

3

Streamlabs 연결 (또는 수동 모드로 먼저 테스트)

대시보드 섹션 4에서 도네이션 소스를 선택하세요:

  • 수동 (테스트 전용) — 대시보드에서 가짜 도네이션을 발사. 모든 것이 올바르게 연결됐는지 확인하려면 먼저 이것을 사용하세요.
  • Streamlabs — 실시간으로 실제 후원을 듣기. Streamlabs 소켓 토큰을 붙여 넣으세요 (streamlabs.com/dashboard#/settings/api-settings → "Show socket token" 버튼에서 가져오세요).
Streamlabs가 구성된 스트리머 대시보드 도네이션 패널
토큰 보안: Streamlabs 토큰은 브라우저의 localStorage에만 머물러요. wheelofitem.com 서버에 업로드되지 않으며, 위젯이 여러분의 기기에서 Streamlabs로 직접 연결돼요.
Access Token / OAuth 클라이언트 ID가 아니라 Socket Token(읽기 전용, 이벤트 리스닝)을 사용하세요. 서로 다른 것이에요.
⏱ 스핀 전 딜레이 (선택): 소스 선택기 바로 아래에 "스핀 전 딜레이 (초)" 필드가 있어요. 즉시 회전하려면 0(기본값)으로 설정하거나, Streamlabs의 일반 도네이션 알림(이미지 + 사운드 + 도네이터 이름)이 먼저 재생되고 그 후에 가챠폰이 이어지길 원한다면 10–15로 설정하세요. 최대 60초.
4

위젯 URL을 OBS에 추가

대시보드 섹션 5에서 브라우저 소스 URL의 복사를 누르세요. 그런 다음 OBS에서:

  • 소스 → + → 브라우저 소스
  • URL: 대시보드에서 복사한 URL 붙여넣기
  • 폭: 520 · 높이: 520 (또는 레이아웃에 맞는 값)
  • 확인 클릭 — 룰렛이 씬 위에 투명하게 렌더링돼요
OBS 오버레이에 표시되는 도네이션 토스트와 회전하는 룰렛
스모크 테스트: 부계정으로 자신에게 $1 후원하세요. 1-2초 안에 토스트가 뜨고 룰렛이 돌아가야 해요. 아무 일도 일어나지 않으면 아래 트러블슈팅을 참고하세요.

Pro Supporter가 라이브 도네이션 트리거를 잠금 해제해요

도네이션 파이프라인은 Pro 혜택이에요. 무료 계정은 모든 것을 연결하고 테스트할 수 있어요 — Pro가 "테스트 전용"에서 "스트림 라이브"로 스위치를 전환해요.

실시간 Streamlabs 트리거
Text-to-Speech 도네이터 호명
VTube Studio 단축키 규칙
무제한 저장 템플릿
클라우드 동기화 뽑기 히스토리
광고 없음 전 사이트
Pro Supporter 되기 — 월 $1

트러블슈팅 & FAQ

가장 자주 묻는 "왜 작동 안 하나요?" 질문에 대한 짧은 답변.

도네이션이 들어왔는데 룰렛이 안 돌아갔어요
다음 리스트를 따라가 보세요:
  1. OBS의 URL을 확인하세요 — ?donation=streamlabs&sl_token=…이 포함되어 있어야 해요. 없으면 대시보드 섹션 5에서 다시 생성하세요.
  2. URL에 &status=1을 추가하여 일반 브라우저에서 여세요. 우측 상단의 상태 표시기가 streamlabs connected (녹색)이어야 해요. 빨간색이면 토큰이 잘못된 것 — 새 소켓 토큰을 가져오세요.
  3. &min_amount=5를 설정했다면 $5 미만 도네이션은 의도적으로 필터링돼요.
  4. 이전 스핀이 아직 애니메이션 중(약 9초)이라면 회전 중 혼란을 피하기 위해 다음 도네이션은 의도적으로 건너뛰어요. 큐 모드는 Phase 4 로드맵에 있어요.
OBS 대신 Streamlabs Desktop에서도 작동하나요?
네. Streamlabs Desktop은 OBS 기반이므로 위젯 URL을 동일한 방식으로 브라우저 소스에 붙여 넣으면 돼요.
Streamlabs 토큰이 서버에 업로드되나요?
아니요. 토큰은 브라우저의 localStorage에만 보관돼요. wheelofitem.com 서버로 기기를 떠나지 않으며, 위젯은 OBS 브라우저 소스에서 Streamlabs 소켓으로 직접 연결돼요. 트레이드오프: 토큰은 OBS에 붙여 넣은 위젯 URL에 보여요, 그러니 그 URL을 공유하거나 스크린샷 찍지 마세요.
Ko-fi나 StreamElements도 작동하나요?
아직은 안 돼요. Streamlabs는 현재 지원돼요 (Phase 1). Ko-fi는 웹훅 리시버(Cloudflare Worker)가 필요해서 Phase 4 로드맵에 있어요. StreamElements RTM 어댑터도 Phase 4예요. 어떤 것이 필요하신지 알려주세요 우선순위를 매길게요.
도네이션 말고 트위치 채팅에서 룰렛을 트리거할 수 있나요?
네 — 그건 이미 출시된 별도 기능이에요. 스트리머 대시보드에 트위치 채팅의 !spin 명령을 듣는 "시청자 트리거 스핀" 섹션이 있어요 (기본적으로 모드 제어). 둘을 함께 운영할 수 있어요.
마음이 바뀌면 — Pro를 해지할 수 있나요?
언제든지요. Pro는 Patreon "Coffee Supporter" 등급이에요 — Patreon 계정에서 해지하면 현재 청구 월 종료 시까지 혜택이 유지돼요. 그 후 스트리머 대시보드는 테스트 전용 모드로 돌아가고, 저장된 템플릿은 안전하게 유지돼요.

프리미엄 음성을 무료로 체험해 보세요

총 41개 뉴럴 음성 중에서 선택 (한국어를 말하는 다국어 6종 포함). 한 번 로그인하면 → 무제한 무료 미리듣기 (시간당 30회 제한).

마음에 드시나요? Pro로 업그레이드 (월 $1)해서 실제 도네이션에 사용하고 월 1,000회 음성 호명을 받으세요.

준비됐나요? 시청자가 룰렛을 돌리게 하세요.

한 번 로그인, Streamlabs 소켓 토큰 붙여넣기, URL을 OBS에 드롭. 완료.

스트리머 대시보드 열기 →
또는 먼저 가챠폰 만들기 →

스트리머 대시보드

룰렛을 선택하고, 위젯 URL을 설정하고, 트위치 채팅을 연결하세요. 변경 사항이 몇 초 안에 스트림에 반영돼요.

룰렛 선택 또는 가챠폰 저장됨

wheelofitem.com에 저장된 룰렛. 클릭하여 스트림 위젯으로 사용하세요.

로딩 중…

💡 라이브 토글 사용법: 카드의 🟢 라이브를 누르면 그 템플릿이 실제 도네이션에 반응합니다 — ⚪ 꺼짐으로 두면 무시합니다. 지금 OBS 씬에 없는 템플릿은 꺼짐으로 해두세요. 백그라운드에서 몰래 돌면서 뽑기 기록을 망치지 않습니다. 새 저장은 기본 꺼짐 — 라이브 전에 켜주세요. (아래 "테스트 도네이션 발사"는 라이브/꺼짐 상태와 무관하게 항상 동작합니다.)

도네이션 트리거 PRO

누군가 도네이션을 보내면 룰렛이 자동으로 돌아가요. 지금은 Streamlabs만 — Ko-fi와 StreamElements는 나중에 지원 예정.

입력하시면 설정이 자동 저장돼요. 위의 버튼은 즉시 저장을 강제해요.

테스트 도네이션 발사

아래 미리보기 프레임에 가짜 도네이션을 발사해요 — 룰렛이 돌아가야 해요 (아래에서 활성화하면 음성도 호명돼요).

🔗 Streamlabs 테스트 페이지 열기 →

Streamlabs의 전체 파이프라인(알림음 + 실제 이벤트 형식)을 테스트하시겠어요? Streamlabs를 새 탭에서 열고 테스트 버튼을 누르면 → 이미 연결한 소켓을 통해 이벤트가 여기 위젯에 도달합니다. 탭을 열어두면 다음번에 다시 로그인할 필요가 없습니다.

음성 (TTS) 베타 테스트

도네이터의 이름 + 금액 + 메시지를 스트림에서 음성으로 읽어줘요. OBS가 브라우저 소스의 오디오를 통해 캡처해요.

자리표시자: {donor} {amount} {currency} {message} {source}

프리미엄 음성 (41개 · 모든 언어에 다국어 6종 )

다국어 음성 (Ava / Andrew / Emma / Brian / Masaru / Hyunsu)은 모든 언어 그룹에 표시돼요 — 한국어·태국어·영어·스페인어·일본어·중국어를 표현력 있는 운율로 자연스럽게 말해요. 언어별 네이티브 액센트 음성도 있어요. 무료: 월 20회 도네이션. Pro: 월 1,000회.

이번 달 사용량 —

매월 초에 리셋

위의 템플릿 텍스트를 사용해요 (섹션 의 테스트 도네이터 / 금액 / 메시지로 자리표시자가 채워져요). 월간 쿼터에 카운트되지 않아요.

위젯 토큰은 데이터베이스에 저장되며, 공개 페이지의 URL에는 절대 노출되지 않아요. 위젯 URL을 공개적으로 공유하셨다면 을 클릭하여 토큰을 교체하고 기존 토큰을 무효화하세요.

VTube Studio PRO 진행 중

VTuber 모델이 도네이션에 반응하도록 — 금액이나 키워드별로 단축키 발사. 작업 진행 중 — WebSocket 연동 테스트를 마무리하는 동안 UI 숨김. 곧 다시 나옵니다.


        

      

    


    
    

      
 트위치 — 채팅 명령어 + 채널 포인트 — 선택 사항

      
트위치에서 스트리밍하시고 시청자가 채팅에서 !spin을 사용하거나 채널 포인트 / 비트를 쓰게 하고 싶을 때만 입력하세요. 도네이션 전용 설정이라면 건너뛰세요.

      
      
      
소문자 사용자명 (# 없이, URL 없이). 채팅 명령어를 읽는 데 사용돼요.


      
      

        
        
      


      

        누가 채팅 명령어를 쓸 수 있나요?
        

          

          
          
!spin과 !remove는 항상 모드 전용이에요. 방송자 + 모드는 항상 모든 것을 사용할 수 있어요.

        

      


      

        디스플레이 옵션
        

          

          

          

          
          
        

      


      
      

         채널 포인트 + 비트 (트위치) PRO
        
시청자가 채널 포인트를 소비해서 !spin — 위젯이 트위치 custom-reward-id를 감지하고 모드가 아닌 사람도 스핀을 승인해줘요.

        

          

             이 트리거는 Pro 등급(월 $1)의 일부예요.
            Pro로 업그레이드 →
            

아래에서 설정을 미리 볼 수 있어요. 계정이 Pro가 되면 채널 포인트 / 비트에서의 스핀이 활성화돼요.
          

          

            채널 포인트 — 트위치 채널 포인트 리워드가 !spin을 채팅에 보내도록 설정되어 있으면
            모든 시청자가 !spin을 사용할 수 있어요. 위젯이 custom-reward-id 태그를 감지하고
            그들을 승인해줘요. 설정 가이드 →
          

          
          
          
시청자가 Cheer100 !spin 형태로 이 수치 이상 비트를 환호로 보내면 룰렛이 돌아가요. 비트는 채널에 남으니 그대로 받으실 수 있어요.

        

      


      
    


    
    

      
 URL 복사 + 라이브 미리보기

      
OBS / Streamlabs 브라우저 소스에 붙여 넣으세요. 위젯 엔드포인트는 대역폭 격리를 위해 streamer.wheelofitem.com에 머물러요.


      
      
      

        

          
          

            새로고침 후에도 모든 구성 유지
            저장: 룰렛 선택, 도네이션 소스 + 딜레이, 음성(무료 + 프리미엄), 트위치 설정, 팝업 모드 등 — 클라우드 계정과 이 브라우저 모두에.
          

        

      


      

        
        
      


      
      
⏳ Wheel of Item 트위치 확장이 트위치 승인 받은 후 제공 예정.


      

        
        시작하려면 위에서 룰렛을 선택하세요
      


      
라이브 미리보기

      
시청자가 보게 될 모습 — URL이 바뀔 때마다 새로고침돼요.

      
      

        💡 미리보기가 비어있나요?
        팝업 모드 + 도네이션 소스 = Streamlabs 설정에서는 정상입니다 — 실제 도네이션이 들어오기 전까지 위젯이 숨어 있어요.
        Streamlabs → 알림 박스 → 테스트 → Streamlabs → 후원 에서 테스트 발사 가능
        (📷 예시 보기).
        위젯이 듣고 있는 같은 소켓으로 도달합니다.
      


      

        

        
섹션 에서 룰렛 또는 가챠폰을 선택하세요

        
선택하면 여기에 라이브 미리보기가 표시돼요. 그 다음 섹션 에서 테스트 도네이션을 발사해서 동작을 확인하세요.