시청자 추첨 - auejin/vzzk-bot GitHub Wiki

추첨 기능은 채팅에 참여한 시청자 중 무작위로 당첨자를 선정하는 기능입니다. 이벤트나 선물 당첨자를 뽑을 때 유용해요!

기능 활성화하기

  1. VZZK에 네이버 로그인을 합니다.
  2. 콘솔 화면에서 추첨 설정으로 이동합니다.
  3. 추첨 기능 활성화 토글을 켭니다.

[!NOTE] 추첨 기능은 기본적으로 활성화되어 있습니다. 사용하지 않으시면 토글을 꺼두시면 됩니다.

추첨 시작하기

추첨은 설정 화면이나 채팅 명령어 두 가지 방법으로 시작할 수 있습니다.

설정 화면에서 시작하기

  1. 콘솔 화면에서 추첨 설정으로 이동합니다.
  2. 🎟️ 추첨 시작 버튼을 클릭합니다.
  3. 추첨이 시작되면 추첨 관리 다이얼로그가 자동으로 열립니다.

[!TIP] 설정 화면에서 추첨을 시작하면 다이얼로그에서 참가자 수를 실시간으로 확인하고, 원하는 타이밍에 추첨할 수 있어 편리합니다.

채팅으로 시작하기

채팅창에 아래 명령어를 입력하면 추첨이 시작됩니다.

!추첨시작
  • 스트리머 또는 매니저만 추첨을 시작할 수 있습니다.
  • 추첨이 시작되면 채팅에 "🎟️ 추첨 시작!" 메시지가 표시됩니다.

추첨 참여 방법

추첨이 시작된 후, 채팅을 입력하는 모든 시청자가 자동으로 참여자로 등록됩니다.

  • 별도의 참가 명령어가 필요 없어요!
  • 그냥 채팅을 치면 자동으로 참여됩니다.
  • 도네이션을 보낸 시청자도 자동으로 참여됩니다.

추첨 관리 다이얼로그

추첨이 진행 중일 때 설정 화면에서 추첨 관리 버튼을 클릭하면 다이얼로그가 열립니다.

참가자 모집 중

  • 현재 참가자 수가 실시간으로 표시됩니다.
  • 충분한 참가자가 모이면 추첨하기 버튼을 클릭하여 당첨자를 선정합니다.

추첨 결과

  • 참가자가 2명 이상이면 추첨 애니메이션이 재생된 후 당첨자가 발표됩니다.
  • 🎉 당첨자 닉네임과 참가자 수가 표시됩니다.
  • 다시 추첨 버튼을 클릭하면 같은 참가자 풀에서 다시 추첨할 수 있습니다.

추첨 종료하기

채팅창에 아래 명령어를 입력하면 추첨이 종료되고 당첨자가 선정됩니다.

!추첨끝

또는 !추첨종료도 사용 가능합니다.

추첨이 종료되면:

  1. 채팅에 "🎟️ 추첨 끝!" 메시지가 표시됩니다.
  2. 참여자 중 무작위로 1명이 당첨자로 선정됩니다.

다시 추첨하기

추첨이 종료된 후, 같은 참가자 풀에서 다시 추첨하고 싶다면 채팅 명령어를 사용할 수 있습니다.

!다시추첨

또는 !재추첨도 사용 가능합니다.

  • 이전과 동일한 참가자 중에서 새로운 당첨자가 선정됩니다.
  • 이전 추첨 기록이 없으면 에러 메시지가 표시됩니다.
  • 참가자 모집 중일 때는 사용할 수 없습니다.

명령어 정리

명령어 사용자 설명
!추첨시작 스트리머/매니저 추첨 참여자 모집 시작
!추첨끝 또는 !추첨종료 스트리머/매니저 추첨 종료 및 당첨자 선정
!다시추첨 또는 !재추첨 스트리머/매니저 같은 참가자로 다시 추첨

방송 오버레이

overlay-raffle

추첨 현황과 결과를 방송 화면에 실시간으로 보여주고 싶다면 방송 오버레이를 사용하세요!

OBS에 오버레이를 추가하면:

  • 현재 참여자 수가 실시간으로 표시돼요
  • 추첨 애니메이션이 방송에 나타나요
  • 당첨자 발표가 자동으로 화면에 표시돼요

OBS에서 방송 오버레이를 추가하는 방법은 방송 오버레이 문서를 참고하세요.