User Guide

### 1. 오버레이 위젯 URL 준비 및 OBS 등록
* **위젯 링크 복사**: 대시보드의 `슬롯머신` 카드에서 **복사 아이콘(📋)**을 클릭하여 슬롯머신 전용 오버레이 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
  1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
  2. 복사한 슬롯머신 위젯 URL을 붙여넣습니다.
  3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.

---

### 2. 추첨 대상 (참여자 - Candidate) 설정
슬롯머신의 당첨자가 될 수 있는 후보 대상을 지정합니다.

* **실시간 후원자 (자동 연동 - `donator`)**:
  * 최근 일정 기간 내에 실제로 후원을 보낸 후원자(시청자) 목록을 자동으로 취합하여 추첨 릴에 올립니다.
* **채널 회원 (자동 연동 - `member`)**:
  * 방송국 사이트에 가입되어 활동 중인 BJ 멤버들이나 정회원들을 당첨 후보로 지정합니다.
* **참여자 직접 입력 (수동 - `manual`)**:
  * 텍스트 영역에 추첨 대상을 한 줄에 하나씩 직접 수동으로 타이핑하여 등록합니다.

---

### 3. 스핀 보상 (상품 - Prize) 설정
슬롯 릴이 멈췄을 때 당첨될 보상 아이템을 세팅합니다.

* **상점 카테고리 상품 (자동 연동 - `sig`)**:
  * 내 상점에 실제 등록되어 판매 중인 상품의 타이틀과 이미지를 릴 화면에 자동으로 채워 넣습니다.
* **직접 상품 등록 (수동 - `manual`)**:
  * 각 상품의 텍스트, 당첨 확률 가중치(Weight), 개별 이미지 주소를 상세히 수동으로 정의하여 나만의 커스텀 슬롯 릴을 구성합니다.
* **클래식 슬롯 아이콘 (게임형 - `classic`)**: 유튜브 사용시 주의!!!
  * 카지노 슬롯의 상징인 **잭팟 7, BAR, 다이아몬드, 골든 벨, 체리, 레몬** 등의 기본 아이콘들로 릴을 채웁니다.
  * 각 아이콘별 획득 점수 배당률(`payout_mult`)과 획득 확률(가중치)을 연계하여 룰렛 점수 내기 미니게임으로 활용하기에 최적입니다.

---

### 4. 대시보드 리모컨 조작 및 수동 롤링
* **원격 스핀 제어**:
  * 설정 콘솔(`slot_console.php`) 우측의 제어 창을 통해 실시간으로 [스핀 시작], [스핀 정지] 신호를 브로드캐스팅해 송출 화면의 슬롯을 원격 제어할 수 있습니다.
* **타이머 자동 연동**:
  * 타이머 위젯과 연계하여 0초 도달 시 자동으로 슬롯 릴이 돌도록 설정해 놓으면, BJ가 신경 쓰지 않아도 주기적인 이벤트 추첨이 자동으로 진행됩니다.

---

### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **슬롯 릴의 이미지가 깨져 보이거나 로드되지 않을 때**:
  * 상점 연동 모드(`sig`)인 경우 상품의 대표 이미지가 정상적으로 등록되어 있는지 확인하세요.
  * 수동 모드(`manual`) 사용 시 입력한 이미지 경로(URL)의 철자가 정확한지 점검해 주세요.
2. **특정 상품만 너무 잘 나오거나 아예 나오지 않을 때**:
  * 수동 등록 상품 목록의 **'가중치(Weight)'** 수치를 수정해 당첨 확률을 균등하게 재분배해 주시면 해결됩니다. (가중치가 높을수록 릴 화면에 많이 노출되며 당첨 확률이 올라갑니다.)