도네이션 목표 ‐ 후원 목표 진행률 오버레이 - auejin/vzzk-bot GitHub Wiki
도네이션 목표 기능은 방송 중 후원 목표를 설정하고, 실시간으로 진행률을 시청자에게 보여주는 기능입니다. 🎯
주요 기능
- 다중 목표 관리: 여러 개의 목표를 동시에 운영
- 조건부 집계: 특정 키워드가 포함된 후원만 집계
- 자동 리셋: 목표 달성 시 자동으로 다음 목표로 전환
- 실시간 오버레이: 진행률 바를 방송 화면에 표시
시작하기
1단계: 목표 만들기
- 도네이션 목표 설정 페이지로 이동합니다.
- + 새 목표 만들기 버튼을 클릭합니다.
- 목표 이름과 목표 금액을 입력합니다.
2단계: 오버레이 추가 (선택)
목표 진행률을 방송 화면에 표시하려면 OBS에 오버레이를 추가하세요.
- 도네이션 목표 설정 페이지에서 오버레이 URL을 복사합니다.
- OBS에서 브라우저 소스를 추가합니다.
- 복사한 URL을 붙여넣습니다.
- 권장 크기: 너비 400px, 높이 100px (목표 개수에 따라 조절)
3단계: 목표 활성화
- 만든 목표를 선택합니다.
- 활성화 토글을 켭니다.
- 이제 후원이 들어오면 자동으로 집계됩니다!
목표 설정 옵션
기본 설정
| 설정 | 설명 |
|---|---|
| 목표 이름 | 오버레이와 달성 메시지에 표시될 이름 |
| 현재 모금액 | 현재까지 모인 금액 (수동 조절 가능) |
| 목표 금액 | 달성해야 할 목표 금액 |
조건 설정
| 설정 | 설명 |
|---|---|
| 최소 후원 금액 | 이 금액 이상의 후원만 집계 |
| 조건 키워드 | 후원 메시지에 이 키워드가 있을 때만 집계 |
[!TIP] 조건 키워드 활용 예시
- 키워드:
목표→ "목표 달성 응원해요!" 후원만 집계- 키워드:
노래→ "노래 들려주세요!" 후원만 집계- 키워드 없음 → 모든 후원 집계
리셋 모드
목표 달성 후 어떻게 처리할지 선택할 수 있습니다.
| 모드 | 설명 |
|---|---|
| 수동 리셋 | 목표 달성 후 직접 초기화할 때까지 유지 |
| 자동 리셋 | 목표 달성 후 자동으로 0원으로 초기화 |
| 반복 | 목표 달성 후 초과 금액을 이월하며 반복 |
| 누적 | 목표 달성 후에도 계속 누적 (100% 초과 가능) |
[!NOTE] 반복 모드 예시
- 목표: 10,000원
- 현재: 8,000원
- 후원: 5,000원 들어옴
- 결과: 13,000원 → 목표 달성! → 3,000원으로 자동 리셋
오버레이
오버레이 상태
도네이션 목표 오버레이는 세 가지 상태를 표시합니다:
- 진행 중: 목표를 향해 진행 중인 상태
- 달성: 목표 달성 시 축하 애니메이션 (5초간)
- 비활성: 목표가 비활성화된 상태
여러 목표 동시 표시
활성화된 목표들은 모두 오버레이에 표시됩니다. 목표마다 고유 ID가 있어 개별적으로 관리됩니다.
목표 달성 시
목표가 달성되면:
- 🎉 축하 메시지가 채팅에 자동 전송됩니다
- 오버레이에 달성 애니메이션이 재생됩니다 (5초)
- 설정된 리셋 모드에 따라 처리됩니다
활용 아이디어
- 게임 도전: "이 보스 클리어하면 10만원 목표!"
- 노래 신청: "노래 신청 목표 달성하면 노래 틀어드려요"
- 특별 이벤트: "100만원 달성하면 얼굴 공개!"
- 후원 감사: "오늘 방송 후원 목표: 5만원"