1. 위젯 이미지
2. 위젯설명 (기능 소개)
VS 대전 게이지 위젯은 엑셀 방송이나 BJ 간 시그니처 배틀, 펀딩 대결 시 실시간 후원금 및 기여도 점수를 합산해 어느 팀이 앞서고 있는지 시각적으로 보여주는 실시간 배틀 오버레이 도구입니다. 좌우로 나눠 대결하는 가로형 스킨과 중앙에서 수직으로 게이지가 차오르는 세로형 스킨의 2종 테마를 제공하며, 팀별 참여 멤버 및 대표 BJ 선택 기능, 원클릭 게이지/점수 리셋 기능을 탑재해 대전 연출을 손쉽게 조작할 수 있습니다.
3. 세팅 방법 (설치부터 주요 체크항목)
### 1. 오버레이 위젯 URL 준비 및 OBS 등록
* **위젯 링크 복사**: 대시보드의 `VS 대전` 카드에서 **복사 아이콘(📋)**을 클릭하여 대전 전용 오버레이 화면 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
2. 복사한 VS 대전 오버레이 URL을 붙여넣습니다.
3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.
---
### 2. 2가지 타입 대전 스킨 선택
배틀 성격과 송출 화면 구도에 맞춰 알맞은 대전 스킨을 제어 콘솔에서 실시간으로 선택합니다.
* **가로 배틀 모드 (좌우 방식 - `horizontal`)**:
* 화면 좌측과 우측에 각 팀(또는 BJ)의 썸네일/게이지가 분할 배치되는 전형적인 1:1 또는 팀 대결 레이아웃입니다.
* **세로 게이지 모드 (중앙 방식 - `vertical`)**:
* 화면 정중앙 또는 측면에 대형 세로형 게이지 막대가 차오르는 스타일로, 방송국 캠 화면 중앙이나 좁은 세로형 여백 배치 시 돋보이는 연출 효과를 줍니다.
---
### 3. 좌(LEFT) / 우(RIGHT) 팀 구성 및 대표 설정
* **팀별 멤버 지정**:
* 대전 제어 콘솔에 접속한 후, 좌측 팀과 우측 팀 스크롤 창에서 현재 배틀에 기여할 BJ 멤버들을 체크박스로 체크해 할당합니다.
* **대표 BJ 선정**:
* 각 팀 내에서 가장 메인으로 화면 전면에 강조 노출될 BJ 이름 옆의 **[대표]** 라디오 버튼을 선택하여 지정합니다.
---
### 4. 핵심 조작 (대전 점수 초기화 및 타이머)
* **[점수 초기화 (대전 재시작)] 버튼**:
* 대전이 끝나 승패가 결정되었거나 다음 라운드를 새롭게 시작해야 할 때, 콘솔에서 **[점수 초기화]** 버튼을 클릭하면 양 팀의 누적 점수와 화면상의 게이지바가 즉시 0:0 상태로 초기화(리셋)됩니다.
* **배틀 타이머 연동**:
* 제한 시간 배틀을 위해 타이머 시작, 정지, 초기화 기능을 지원합니다.
---
### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **후원이 터져도 게이지 점수가 오르지 않을 때**:
* 설정 콘솔 내 **'기여도(후원액) 실시간 합산'** 체크박스가 활성화되어 있는지 확인해 주세요. (가상 회원이 획득한 룰렛 보너스 등도 함께 실시간 집계하기 위해 켜 두시는 것이 좋습니다.)
2. **대표 이름이 잘려 보이거나 너무 작을 때**:
* 콘솔의 `이름 폰트 크기 (px)` 수치(기본: 45px)를 늘리거나 줄여 방송국 해상도 규격에 맞춰 조정 후 저장해 줍니다.
* **위젯 링크 복사**: 대시보드의 `VS 대전` 카드에서 **복사 아이콘(📋)**을 클릭하여 대전 전용 오버레이 화면 주소를 복사합니다.
* **OBS 브라우저 소스 추가**:
1. OBS Studio 소스 목록에서 `+` 버튼을 누르고 **[브라우저 (Browser)]**를 추가합니다.
2. 복사한 VS 대전 오버레이 URL을 붙여넣습니다.
3. 해상도 값을 너비 **1920**, 높이 **1080**으로 고정하여 등록합니다.
---
### 2. 2가지 타입 대전 스킨 선택
배틀 성격과 송출 화면 구도에 맞춰 알맞은 대전 스킨을 제어 콘솔에서 실시간으로 선택합니다.
* **가로 배틀 모드 (좌우 방식 - `horizontal`)**:
* 화면 좌측과 우측에 각 팀(또는 BJ)의 썸네일/게이지가 분할 배치되는 전형적인 1:1 또는 팀 대결 레이아웃입니다.
* **세로 게이지 모드 (중앙 방식 - `vertical`)**:
* 화면 정중앙 또는 측면에 대형 세로형 게이지 막대가 차오르는 스타일로, 방송국 캠 화면 중앙이나 좁은 세로형 여백 배치 시 돋보이는 연출 효과를 줍니다.
---
### 3. 좌(LEFT) / 우(RIGHT) 팀 구성 및 대표 설정
* **팀별 멤버 지정**:
* 대전 제어 콘솔에 접속한 후, 좌측 팀과 우측 팀 스크롤 창에서 현재 배틀에 기여할 BJ 멤버들을 체크박스로 체크해 할당합니다.
* **대표 BJ 선정**:
* 각 팀 내에서 가장 메인으로 화면 전면에 강조 노출될 BJ 이름 옆의 **[대표]** 라디오 버튼을 선택하여 지정합니다.
---
### 4. 핵심 조작 (대전 점수 초기화 및 타이머)
* **[점수 초기화 (대전 재시작)] 버튼**:
* 대전이 끝나 승패가 결정되었거나 다음 라운드를 새롭게 시작해야 할 때, 콘솔에서 **[점수 초기화]** 버튼을 클릭하면 양 팀의 누적 점수와 화면상의 게이지바가 즉시 0:0 상태로 초기화(리셋)됩니다.
* **배틀 타이머 연동**:
* 제한 시간 배틀을 위해 타이머 시작, 정지, 초기화 기능을 지원합니다.
---
### 💡 주요 체크 항목 (동작하지 않을 때 해결법)
1. **후원이 터져도 게이지 점수가 오르지 않을 때**:
* 설정 콘솔 내 **'기여도(후원액) 실시간 합산'** 체크박스가 활성화되어 있는지 확인해 주세요. (가상 회원이 획득한 룰렛 보너스 등도 함께 실시간 집계하기 위해 켜 두시는 것이 좋습니다.)
2. **대표 이름이 잘려 보이거나 너무 작을 때**:
* 콘솔의 `이름 폰트 크기 (px)` 수치(기본: 45px)를 늘리거나 줄여 방송국 해상도 규격에 맞춰 조정 후 저장해 줍니다.