1. 위젯 이미지
2. 위젯설명 (기능 소개)
행운의 룰렛 위젯은 방송 중 즉석 이벤트, 벌칙 정하기, 후원 리액션 추첨 등을 게임처럼 재미있게 진행할 수 있도록 화면에 회전 룰렛판을 송출하는 실시간 게임 오버레이 도구입니다. 상점 상품 목록을 읽어오는 '자동 연동 모드', 직접 벌칙을 적어 넣는 '수동 입력 모드', 그리고 후원금 규칙(% 또는 #)에 따라 대상을 분기 지정하는 신규 '후원인/멤버 연동 모드'를 지원하여 방송의 극적 연출을 돕습니다.
3. 세팅 방법 (설치부터 주요 체크항목)
### 1. 오버레이 위젯 URL 준비 및 OBS 등록
* **위젯 링크 복사**: 대시보드의 `룰렛` 카드에서 **복사 아이콘(📋)**을 클릭하여 룰렛 전용 오버레이 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
2. 복사한 룰렛 위젯 URL을 붙여넣습니다.
3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.
---
### 2. 3가지 대전환 모드 세팅법
스핀 제어 콘솔(`spin_console.php`) 상단의 탭 메뉴를 눌러 용도에 맞게 룰렛 모드를 변경하여 저장합니다.
#### 1) 자동 연동 모드 (`sig`)
* **설명**: 현재 내 상점(아이템 관리)에 올려 둔 실제 후원 아이템/시그니처 상품들의 목록과 이미지를 자동으로 긁어와 룰렛판 슬롯을 생성합니다.
* **특징**: 판매 중인 룰렛권 리액션 상품들과 100% 동기화되어, 시청자가 해당 후원을 진행 시 상품명 또는 후원 금액을 슬라이드 룰렛으로 보여줄 때 유용합니다.
#### 2) 멤버 이름 수동 입력 모드 (`member`)
* **설명**: 방송 흐름상 즉흥적으로 벌칙이나 미션을 진행할 때 사용하는 가장 직관적인 모드입니다.
* **이용방법**: 텍스트 입력창에 **한 줄에 하나씩** 원하는 벌칙이나 당첨 항목(예: `물 한 잔 마시기`, `애교 3종`, `꽝!`, `화장실 1회` 등)을 적어 넣고 저장하면 바로 룰렛판 슬롯에 매핑됩니다. (최대 12명/12칸 권장)
#### 3) 후원인/멤버 연동 모드 (`donator` — 신규 추가) ★★★
* **설명**: 고액 후원이 들어왔을 때, 룰렛을 돌려 보상이나 기여도를 누구에게 분배할 것인지 정교한 접두사 규칙으로 매칭하는 최신 합동/엑셀 방송용 전문 기능입니다.
* **이용방법**: 텍스트 입력창에 `%` 또는 `#` 기호를 금액 앞에 붙여서 목록을 구성합니다.
* **`%금액` 규칙 (후원인 룰렛)**:
* 예: `%50000 → 후원자 룰렛` 형태로 작성 시 ➡️ 50,000 캐시 이상 후원한 **후원자(시청자) 전원**을 룰렛 대상에 올려 보상을 지급하는 이벤트 진행 시 사용.
* **`#금액` 규칙 (멤버 룰렛)**:
* 예: `#50000 → 멤버 룰렛` 형태로 작성 시 ➡️ 50,000 캐시 이상 후원 발생 시 대전이나 엑셀 방송에 참여 중인 **BJ 멤버 전원**을 슬롯에 매칭해 리액션 기여도를 올리거나 미션을 수행할 때 사용.
---
### 3. 디테일한 비주얼 & 당첨 안내 설정
* **룰렛 색상 팔레트 지정**:
* 룰렛판 슬롯의 색상을 톡톡 튀는 레인보우 12색 테마로 자동 지정하거나 사용자 지정 색상 코드로 직접 꾸밀 수 있습니다.
* **당첨 결과 메시지 안내 모드**:
* 룰렛 스핀이 끝난 후 화면 하단이나 중앙에 표시될 텍스트 팝업을 지정합니다.
* `당첨 상품명 표시`, `당첨 금액 표시` 외에 **`당첨자 안내 (누구님 00점/00벌칙 당첨!)`** 옵션을 제공해 방송 연출을 한층 깔끔하게 마감합니다.
---
### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **스핀 버튼이 동작하지 않거나 오류가 날 때**:
* 룰렛의 스핀 지속 시간(기본 5초)이 너무 길거나 짧게 설정되어 있지 않은지 콘솔에서 점검하고, 대시보드 스위치가 **[ON]**으로 되어 있는지 체크해 주세요.
2. **수동 입력 내용을 바꿨는데 화면 룰렛판이 구 버전 항목일 때**:
* 콘솔 하단의 **[스핀 위젯 설정 저장]**을 반드시 클릭하고, OBS 브라우저 소스를 마우스 우클릭해 `새로고침`을 수행해 줍니다.
* **위젯 링크 복사**: 대시보드의 `룰렛` 카드에서 **복사 아이콘(📋)**을 클릭하여 룰렛 전용 오버레이 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
2. 복사한 룰렛 위젯 URL을 붙여넣습니다.
3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.
---
### 2. 3가지 대전환 모드 세팅법
스핀 제어 콘솔(`spin_console.php`) 상단의 탭 메뉴를 눌러 용도에 맞게 룰렛 모드를 변경하여 저장합니다.
#### 1) 자동 연동 모드 (`sig`)
* **설명**: 현재 내 상점(아이템 관리)에 올려 둔 실제 후원 아이템/시그니처 상품들의 목록과 이미지를 자동으로 긁어와 룰렛판 슬롯을 생성합니다.
* **특징**: 판매 중인 룰렛권 리액션 상품들과 100% 동기화되어, 시청자가 해당 후원을 진행 시 상품명 또는 후원 금액을 슬라이드 룰렛으로 보여줄 때 유용합니다.
#### 2) 멤버 이름 수동 입력 모드 (`member`)
* **설명**: 방송 흐름상 즉흥적으로 벌칙이나 미션을 진행할 때 사용하는 가장 직관적인 모드입니다.
* **이용방법**: 텍스트 입력창에 **한 줄에 하나씩** 원하는 벌칙이나 당첨 항목(예: `물 한 잔 마시기`, `애교 3종`, `꽝!`, `화장실 1회` 등)을 적어 넣고 저장하면 바로 룰렛판 슬롯에 매핑됩니다. (최대 12명/12칸 권장)
#### 3) 후원인/멤버 연동 모드 (`donator` — 신규 추가) ★★★
* **설명**: 고액 후원이 들어왔을 때, 룰렛을 돌려 보상이나 기여도를 누구에게 분배할 것인지 정교한 접두사 규칙으로 매칭하는 최신 합동/엑셀 방송용 전문 기능입니다.
* **이용방법**: 텍스트 입력창에 `%` 또는 `#` 기호를 금액 앞에 붙여서 목록을 구성합니다.
* **`%금액` 규칙 (후원인 룰렛)**:
* 예: `%50000 → 후원자 룰렛` 형태로 작성 시 ➡️ 50,000 캐시 이상 후원한 **후원자(시청자) 전원**을 룰렛 대상에 올려 보상을 지급하는 이벤트 진행 시 사용.
* **`#금액` 규칙 (멤버 룰렛)**:
* 예: `#50000 → 멤버 룰렛` 형태로 작성 시 ➡️ 50,000 캐시 이상 후원 발생 시 대전이나 엑셀 방송에 참여 중인 **BJ 멤버 전원**을 슬롯에 매칭해 리액션 기여도를 올리거나 미션을 수행할 때 사용.
---
### 3. 디테일한 비주얼 & 당첨 안내 설정
* **룰렛 색상 팔레트 지정**:
* 룰렛판 슬롯의 색상을 톡톡 튀는 레인보우 12색 테마로 자동 지정하거나 사용자 지정 색상 코드로 직접 꾸밀 수 있습니다.
* **당첨 결과 메시지 안내 모드**:
* 룰렛 스핀이 끝난 후 화면 하단이나 중앙에 표시될 텍스트 팝업을 지정합니다.
* `당첨 상품명 표시`, `당첨 금액 표시` 외에 **`당첨자 안내 (누구님 00점/00벌칙 당첨!)`** 옵션을 제공해 방송 연출을 한층 깔끔하게 마감합니다.
---
### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **스핀 버튼이 동작하지 않거나 오류가 날 때**:
* 룰렛의 스핀 지속 시간(기본 5초)이 너무 길거나 짧게 설정되어 있지 않은지 콘솔에서 점검하고, 대시보드 스위치가 **[ON]**으로 되어 있는지 체크해 주세요.
2. **수동 입력 내용을 바꿨는데 화면 룰렛판이 구 버전 항목일 때**:
* 콘솔 하단의 **[스핀 위젯 설정 저장]**을 반드시 클릭하고, OBS 브라우저 소스를 마우스 우클릭해 `새로고침`을 수행해 줍니다.