로그인하셨네요 — Pro를 통해 스트리머 대시보드를 전부 잠금 해제하세요
무료 계정은 설정 가이드와 테스트 파이프라인을 둘러볼 수 있어요. 구성 가능한 대시보드(룰렛 선택, 도네이션 트리거, 음성, VTube Studio)는 Pro 등급이 필요해요.
시청자가 후원하면 — 룰렛이 돌고 아바타가 반응합니다
Streamlabs, StreamElements, Ko-fi, SociaBuzz, TikTok, YouTube 후원이 들어오면 OBS에서 룰렛이 바로 돌고, 도네이터 이름을 읽어주고, 그 상품에 매핑해 둔 VTube Studio 핫키가 발사됩니다. 브라우저 소스 하나. 봇 없음, 확장 프로그램 없음, Twitch 개발자 계정 불필요.
가입 전에 먼저 보고 싶다면? 이 주소를 OBS 브라우저 소스에 붙여넣기만 하세요 — 실제로 도는 데모 룰렛입니다:
https://streamer.wheelofitem.com/widget.html?id=72bwec
OBS 브라우저 소스 실제 녹화 — 후원 도착, 룰렛 회전, 결과 확정.
도네이션 하나. 세 가지 반응, 동시에.
모든 후원이 같은 이벤트를 발사해요 — 각 구독자가 독립적으로 듣고 반응해요. 어떤 조합이든 가능해요.
룰렛 자동 회전
도네이터와 금액이 OBS 오버레이에 토스트로 표시되고, 룰렛이 돌아가 당첨자에서 멈춰요. 일반 룰렛이나 가챠폰 등급 굴리기에서 작동해요.
이름을 음성으로 호명
Web Speech TTS가 스트림에서 "감사합니다 도네이터님, 5달러!"를 읽어줘요. 음성, 속도, 피치 선택 — 완전히 커스터마이즈 가능한 템플릿. OBS가 오디오 출력에서 캡처해요.
VTuber 모델 트리거
규칙에 따라 VTube Studio 단축키가 발사돼요 — 예: $50 도네이션 → "에픽 댄스", 메시지에 "손 흔들기" 포함 → "손 흔들기 모션". 로컬 WebSocket, 클라우드 중간자 없음.
후원 룰렛만이 아니에요
모든 모드가 똑같은 한 줄짜리 OBS 브라우저 소스 — 방송에 맞는 걸 자유롭게 조합하세요.
룰렛만이 아니에요 — 가챠폰 & 타로
룰렛을 가챠폰 캡슐 머신(등급별 + 뽑기 애니메이션)이나 매일 타로 뽑기로 바꿀 수 있어요 — 같은 설정, 같은 트리거.
채널 포인트 — 후원 없이
시청자가 트위치 채널 포인트로 룰렛·가챠·타로를 실행해요 — 후원 없는 무료 트리거라 팁을 안 줘도 모두 참여할 수 있어요.
직접 실행 — 라이브 컨트롤
대시보드에서 원클릭으로 스핀·가챠·타로 — 후원 필요 없어요. 이벤트나 채팅과 놀 때 딱이에요.
팝업 모드
위젯을 평소엔 숨겨두고 트리거될 때만 나타났다가 자동으로 숨겨요 — 화면을 차지하는 상시 오버레이 없이.
디스코드 가챠 봇
가챠를 디스코드 서버에서도 — 멤버가 /gacha 슬래시 명령어로 뽑고, 캡슐 공개 애니메이션 포함.
전체 설정을 2분 만에
룰렛 선택, 후원 연결, 테스트, OBS 설정 — 실제 화면으로 한 번에 볼 수 있습니다.
4단계 설정
총 소요 시간: 약 5분. 저장된 룰렛 템플릿과 Streamlabs 계정이 필요해요.
스트리머 대시보드 열기
streamer.wheelofitem.com/dashboard로 이동하여 wheelofitem.com에서 사용하는 동일한 Google 계정으로 로그인하세요.
도네이션 플랫폼 연결 (Streamlabs / Gank)
대시보드 섹션 4에서 도네이션 소스를 선택하세요:
- Streamlabs — 실시간으로 실제 후원을 듣기. Streamlabs 소켓 토큰을 붙여 넣으세요 (streamlabs.com/dashboard#/settings/api-settings → "Show socket token" 버튼에서 가져오세요).
0(기본값)으로 설정하거나, Streamlabs의 일반 도네이션 알림(이미지 + 사운드 + 도네이터 이름)이 먼저 재생되고 그 후에 가챠폰이 이어지길 원한다면 10–15로 설정하세요. 최대 60초.
위젯 URL을 OBS에 추가
대시보드 섹션 5에서 브라우저 소스 URL의 복사를 누르세요. 그런 다음 OBS에서:
- 소스 → + → 브라우저 소스
- URL: 대시보드에서 복사한 URL 붙여넣기
- 폭: 520 · 높이: 520 (또는 레이아웃에 맞는 값)
- 확인 클릭 — 룰렛이 씬 위에 투명하게 렌더링돼요
트러블슈팅 & FAQ
가장 자주 묻는 "왜 작동 안 하나요?" 질문에 대한 짧은 답변.
도네이션이 들어왔는데 룰렛이 안 돌아갔어요
- OBS의 URL을 확인하세요 —
?donation=streamlabs&sl_token=…이 포함되어 있어야 해요. 없으면 대시보드 섹션 5에서 다시 생성하세요. - URL에
&status=1을 추가하여 일반 브라우저에서 여세요. 우측 상단의 상태 표시기가streamlabs connected(녹색)이어야 해요. 빨간색이면 토큰이 잘못된 것 — 새 소켓 토큰을 가져오세요. &min_amount=5를 설정했다면 $5 미만 도네이션은 의도적으로 필터링돼요.- 이전 스핀이 아직 애니메이션 중(약 9초)이라면 회전 중 혼란을 피하기 위해 다음 도네이션은 의도적으로 건너뛰어요. 큐 모드는 Phase 4 로드맵에 있어요.
OBS 대신 Streamlabs Desktop에서도 작동하나요?
Ko-fi나 StreamElements도 작동하나요?
도네이션 말고 트위치 채팅에서 룰렛을 트리거할 수 있나요?
!spin 명령을 듣는 "시청자 트리거 스핀" 섹션이 있어요 (기본적으로 모드 제어). 둘을 함께 운영할 수 있어요.
마음이 바뀌면 — Pro를 해지할 수 있나요?
프리미엄 음성을 무료로 체험해 보세요
다국어 Google Chirp 3 HD 음성 중에서 선택 (모든 음성이 한국어를 말해요). 한 번 로그인하면 → 무제한 무료 미리듣기 (시간당 200회 제한).
마음에 드시나요? Pro로 업그레이드 (월 ₩4,500)해서 실제 도네이션에 사용하고 월 200회 음성 호명을 받으세요.
준비됐나요? 시청자가 룰렛을 돌리게 하세요.
한 번 로그인, Streamlabs 소켓 토큰 붙여넣기, URL을 OBS에 드롭. 완료.
또는 먼저 가챠폰 만들기 → 무료 방송 스케줄 메이커로 주간 커버 만들기 →스트리머 모드는 Pro가 필요합니다
Discord 팩으로는 Discord 봇과 웹 기능을 사용할 수 있어요. 스트리머 대시보드(후원 트리거, Live Control, TTS, VTube Studio)는 Pro 기능이라 이 팩으로는 이용할 수 없어요.
스트리머 대시보드
사용 가이드룰렛을 선택하고, 위젯 URL을 설정하고, 트위치 채팅을 연결하세요. 변경 사항이 몇 초 안에 스트림에 반영돼요.
시청자가 트위치 채널 포인트로 룰렛을 돌려요. 후원 없이 — 설정하기 →Discord 가챠
Discord 서버 멤버가 /gacha 로 가챠폰을 뽑을 수 있어요. 아이템과 연속 기록은 사람별로 기록되고, 뽑은 기록은 뽑기 히스토리에도 나타납니다.
- 아래 버튼으로 봇을 서버에 추가하세요 — 해당 서버의 서버 관리 권한이 필요합니다
- 어떤 가챠를 쓸지, 멤버당 쿨다운, 누가 뽑을 수 있는지 설정하세요
- 멤버가 Discord에서 /gacha 를 입력하기만 하면 됩니다
Discord로 이동해 서버를 고릅니다. 그 서버의 '서버 관리' 권한이 필요합니다.
켜면 멤버는 보유한 플레이 횟수만큼만 뽑을 수 있습니다 · 모두 매일 이 횟수만큼 무료로 뽑고, 추가는 Discord에서 /give play @user N · 플레이 횟수와 아이템은 사고팔거나 현금으로 교환할 수 없습니다
Discord 역할 ID를 쉼표로 구분해 입력하세요 (개발자 모드를 켜고 서버 설정 → 역할 → 역할 우클릭 → ID 복사). '지정한 역할만'을 고른 채 비워 두면 아무도 뽑을 수 없습니다.
채널을 우클릭 → 'ID 복사' (개발자 모드 필요). 비우면 /gacha 가 모든 채널에서 동작합니다.
공동 관리자
여기에 추가한 사람은 자신의 Wheel of Item 계정으로 이 서버를 관리(설정 변경·가챠 선택·연결 해제)할 수 있어요. 설정을 마지막에 저장한 사람의 가챠가 활성화됩니다. 소유자는 삭제할 수 없어요.
플레이어
멤버를 클릭하면 그 사람이 모은 것을 볼 수 있어요.
| 멤버 | 횟수 | 최장 연속 | 마지막 뽑기 |
|---|
Discord 크레인 게임
Discord 서버 멤버가 /claw로 크레인을 잡을 수 있습니다. 아래에서 연결한 모든 서버에서 작동합니다.
불러오는 중…
누가 뽑을 수 있는지·채널 제한·켜기/끄기는 서버 공통입니다. Gacha 탭에서 설정하세요.
불러오는 중…
/claw는 이 계정에 연결된 모든 서버에서 작동합니다. Live 토글은 OBS 오버레이에만 영향을 줍니다.
Discord 타로
멤버가 /tarot 로 매일 타로를 뽑습니다. 봇이 서버에 있으면 바로 작동하며 설정이 필요 없습니다.
자동이면 각자의 언어로, 하나로 고정하면 서버 전체가 그 언어로 표시됩니다.

선택한 시간(내 현지 시간)에 이 채널에 서버의 오늘의 카드를 게시하고, 멤버가 자기 카드를 뽑을 수 있는 버튼도 붙여요. 채널 우클릭 → 채널 ID 복사.
🛠️ 서버 타로 도구(모든 카드에 서버 색상과 이름, 카드 디자인 3종, 서버 전체 언어 고정)는 Discord 팩 또는 Pro에 포함돼요. 모든 서버는 처음 30일 동안 무료로 쓸 수 있어요. 타로 풀이는 모든 서버에서 똑같이 전체 버전이에요.
룰렛 선택 또는 가챠폰 저장됨
wheelofitem.com에 저장된 룰렛. 클릭하여 스트림 위젯으로 사용하세요.
후원 음성(TTS)이나 VTube Studio 모델 반응만 원하면 선택하세요 — 돌아가는 휠 없음. OBS 오버레이는 완전히 투명한 상태로 음성 재생 + 모델 발동만 합니다. (TTS와 VTube Studio는 Pro 기능입니다.)
라이브 토글 사용법: 카드의 라이브를 누르면 그 템플릿이 실제 도네이션에 반응합니다 — ⚪ 꺼짐으로 두면 무시합니다. 지금 OBS 씬에 없는 템플릿은 꺼짐으로 해두세요. 백그라운드에서 몰래 돌면서 뽑기 기록을 망치지 않습니다. 새 저장은 기본 꺼짐 — 라이브 전에 켜주세요.
도네이션 트리거 PRO
누군가 도네이션을 보내면 룰렛이 자동으로 돌아가요. Streamlabs, Gank, Ko-fi, StreamElements, YouTube 슈퍼챗, TikFinity, SociaBuzz를 지원해요. 사용하는 소스를 체크하세요.
사용하는 소스를 모두 체크하세요 — 모두 체크 해제하면 도네이션 트리거가 꺼집니다. 체크한 각 소스의 자격 증명을 아래 칸에 입력하세요.
Google로 한 번만 로그인하면 Streamlabs를 자동으로 설정해 드려요. 찾아야 할 API 키가 없어요. (대시보드에서 마무리한 뒤 여기로 돌아오세요.)
Streamlabs 소켓 토큰
streamlabs.com → 설정 → API 설정 → API 토큰 → "Show Socket Token"( 예시 보기)에서 찾을 수 있어요.
YouTube 슈퍼챗은 YouTube 채널을 Streamlabs 또는 StreamElements에 연결해 두면 그 연결을 통해 자동으로 휠을 돌립니다 — 별도의 YouTube 토큰을 입력할 필요가 없어요.
Ko-fi → More → API / Webhooks에서 이 URL을 Webhook URL로 붙여넣으세요. Ko-fi에서 후원이 들어오면 휠이 돌아갑니다. 그런 다음 아래 6번 섹션의 Browser Source URL을 OBS에 복사하세요 (이건 비밀이 없어 방송에 노출돼도 안전합니다).
TikFinity에서 Trigger WebHook 액션을 추가하고 이 URL만 붙여넣으면 끝입니다 — 본문 칸은 없어요. 선물 정보(코인·시청자 이름·선물 이름)는 TikFinity가 자동으로 보냅니다. 이 액션을 선물(Gift) 이벤트에 연결하고, TikFinity 이벤트 시뮬레이터에서 선물을 보내 테스트하세요(액션을 직접 실행하면 코인이 없어 도착은 해도 돌지 않습니다). JSON 본문 칸이 남아 있는 예전 버전만 {"coins":%coins%,"count":%repeatCount%,"nickname":"%nickname%","gift":"%giftName%","msgId":"%msgId%"}를 쓰세요. 최소 코인 기준은 TikFinity 자체 트리거에서 설정하세요 — 그 기준을 넘는 선물만 휠을 돌립니다. (비밀 — 이 URL을 방송에 노출하지 마세요.)
TikFinity 액션은 반드시 Trigger WebHook(POST 전송)이어야 해요. 웹사이트나 브라우저 창을 여는 액션으로는 선물이 도착하지 않아요.
10코인일 때: 장미(1코인)×10 = 1회 · 도넛(30코인) = 3회 · 1회에 못 미치는 나머지는 세지 않음 · 비워 두면 선물 1개당 1회 (기존과 같음)
⏱️ 같은 시청자가 10초 안에 선물을 여러 번 보내면 코인을 먼저 합친 뒤 설정대로 돌립니다 · 진행 중에 온 선물은 건너뛰지 않고 대기열에 들어갑니다
- SociaBuzz에서 TRIBE → Edit & Settings → Integrations → Webhook을 엽니다.
- 이 링크를 Webhook URL에 붙여넣고 저장합니다.
- 그 페이지에서 Test Notification을 누르세요. 테스트가 도착하면 여기에 초록색 안내가 나타나요. 테스트로는 룰렛이 돌지 않고, 실제 후원만 돌아요.
같은 SociaBuzz 페이지의 Webhook Token을 복사해 여기에 저장하면, 내 토큰이 담긴 호출만 받아요. 비워 두면 비밀 링크만으로 확인해요.
Gank의 Stream URL(Gank → Stream Settings → Stream Alert)을 붙여넣으세요. Gank 후원을 읽어 후원이 들어오면 휠이 돌아가거나 카드가 펼쳐집니다.
참고: Gank에 대한 비공식 직접 연결입니다. Gank가 시스템을 변경하면 업데이트가 필요할 수 있습니다.
StreamElements → 계정 → 비밀 표시 에서 둘 다 확인 (계정 ID + JWT 토큰). 팁이 오면 룰렛이 돌아가거나 카드가 뽑힙니다. JWT 토큰은 비밀번호처럼 취급하고 방송에 표시하지 마세요.
이 금액 미만 후원은 무시돼요 (스핀·드로우 없음). 모든 템플릿(휠·가챠폰·타로)에 적용. 0 = 모든 후원이 트리거 (기본값)
💱 들어온 후원은 어떤 통화든 매일 환율로 이 통화로 환산한 뒤 최소 금액과 비교해요 — 다른 통화로 온 후원도 정확하게 반영돼요
도네이션이 도착한 후 가챠폰이 뜨고 스핀하기 전까지 N초 기다려요. Streamlabs의 일반 도네이션 알림(이미지 + 사운드 + 도네이터 이름)이 먼저 끝나길 원하고 그 후에 가챠폰이 이어지길 원할 때 유용해요.
0 = 즉시 스핀 (기본값). 일반적인 Streamlabs 알림은 약 7~15초.
최대 60초.
입력하시면 설정이 자동 저장돼요. 위의 버튼은 즉시 저장을 강제해요.
음성 (TTS) PRO
도네이터의 이름 + 금액 + 메시지를 스트림에서 음성으로 읽어줘요. OBS가 브라우저 소스의 오디오를 통해 캡처해요.
—
자리표시자: {donor} {amount} {currency} {message} {source}
프리미엄 음성 — Google Chirp 3 HD (자연스러운 다국어)
먼저 언어를 고르고, 그다음 음성을 선택하세요. 모든 Google Chirp 3 HD 음성은 다국어예요 — ไทย / English / 日本語 / 한국어 / Español / Français / 中文을 읽어요. 프리미엄 음성 읽기는 Pro 기능이에요 (월 200회 도네이션). 월간 한도에 도달하면 자동으로 무료 Google 음성으로 대체되므로 읽기가 끊기지 않아요.
매월 초에 리셋
위의 템플릿 텍스트를 사용해요 (자리표시자는 샘플 도네이터 이름 + 금액으로 채워져요). 월간 쿼터에 카운트되지 않아요.
프리미엄 음성은 자동으로 설정돼요 — 따로 설정할 필요가 없습니다. 위젯 토큰은 데이터베이스에 저장되며, 공개 위젯 URL에는 노출되지 않아요.
VTube Studio PRO — 선택 설정 영상 보기 (1:43)
시청자가 후원하면 VTuber 모델이 자동으로 애니메이션(“핫키”)을 재생합니다. OBS와 같은 PC에서 무료 앱 VTube Studio 를 실행해 두어야 합니다.
- VTube Studio에서 API 켜기
설정(톱니바퀴)을 열고 “Plugins / Start API” 를 ON 으로 (포트 8001 사용). VTube Studio는 켜둔 채로 두세요. - 연결 — 처음 한 번만
아래 버튼을 누르면 VTube Studio 안에 “Wheel of Item” 허용 여부를 묻는 팝업이 뜹니다 — Allow(허용) 를 누르세요. - 후원 시 재생할 애니메이션 선택
알림이나 음성을 먼저 내보내기 위한 대기. 0 = 즉시 반응.
Toggle Expression 핫키에 적합 — 같은 핫키를 다시 실행해 표정/포즈를 끕니다. 애니메이션은 스스로 끝나므로 0으로 두세요. ✨ 가장 깔끔한 방법: VTube Studio에서 표정 핫키에 “N초 후 자동 해제”를 설정하고 여기는 0으로 두기.
계정에 저장 — VTube Studio가 매번 자동으로 재연결, 어느 컴퓨터에서나 사용 가능
- 테스트
-
상품별 VTuber 리액션 — 룰렛 결과로 의상/포즈 설정 (+타이밍)상품 → 의상 변경상품마다 VTuber 의상/포즈를 전환. 아래에서 설정하세요 ↓
상품별 표 설정
상품마다 핫키를 지정 — 룰렛이 그 상품에 멈추면 해당 애니메이션이 재생됩니다 (지정한 상품만 반응). 먼저 위의 핫키 불러오기를 누르세요
각 열의 기능지연 s — 룰렛이 멈춘 뒤 몇 초 후에 포즈를 재생할지 (알림/음성을 먼저 낼 수 있음). 0 = 즉시 재생.끄기 s — 포즈를 몇 초 유지한 뒤 자동으로 끌지. 0 = 켜둠 (같은 그룹의 새 상품이 나올 때까지).그룹 A/B/C — 동시에 착용할 수 없는 포즈를 같은 그룹으로 (예: 의상 전부 = A). 그룹당 하나만 켜짐 — 새로 당첨되면 그 그룹의 이전 것은 자동으로 꺼짐. (Expression에서 작동)룰렛 템플릿 전용 — 2단계에서 룰렛을 선택하세요상품핫키지연 s끄기 s그룹
URL 복사 + 라이브 미리보기
OBS / Streamlabs 브라우저 소스에 붙여 넣으세요. 위젯 엔드포인트는 대역폭 격리를 위해 streamer.wheelofitem.com에 머물러요.
⏳ Wheel of Item 트위치 확장이 트위치 승인 받은 후 제공 예정.
라이브 미리보기
시청자가 보게 될 모습 — URL이 바뀔 때마다 새로고침돼요.
후원 알림 테스트
Streamlabs의 전체 파이프라인(알림음 + 실제 이벤트 형식)을 테스트하시겠어요? Streamlabs를 새 탭에서 열고 테스트 버튼을 누르면 → 이미 연결한 소켓을 통해 이벤트가 여기 위젯에 도달합니다. 탭을 열어두면 다음번에 다시 로그인할 필요가 없습니다.
라이브 컨트롤 Pro
도네이션 없이 지금 바로 OBS 위젯을 실행하세요. 추첨 이벤트나 채팅과 놀기에 딱 좋아요. 결과는 약 1초 만에 방송 화면에 나타납니다 (아래 미리보기도 소리 없이 함께 돌아가요).
섹션 에서 룰렛 또는 가챠폰을 선택하세요
선택하면 여기에 라이브 미리보기가 표시돼요. 그 다음 아래에서 플랫폼으로 테스트해 동작을 확인하세요.