룰렛 - auejin/vzzk-bot GitHub Wiki

룰렛 기능은 시청자가 채팅 명령어 또는 후원(도네이션)을 통해 룰렛을 돌릴 수 있는 기능입니다. 스트리머는 여러 개의 룰렛을 만들고, 각 룰렛에 다양한 선택지와 확률을 직접 설정하여 방송에 재미를 더할 수 있습니다.

기능 활성화하기

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

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

룰렛 설정 방법

룰렛 설정은 룰렛 목록 탭에서 진행합니다.

1단계: 새 룰렛 만들기

  1. + 새 룰렛 만들기 버튼을 클릭합니다.
  2. 룰렛의 이름을 입력합니다. (예: 벌칙 룰렛, 미션 룰렛)
  3. 생성된 룰렛을 클릭하면 상세 설정이 나타납니다.

2단계: 룰렛 상세 설정

  • 명령어: 시청자가 룰렛을 돌릴 때 사용할 채팅 명령어입니다.
  • 최소 금액 (원):
    • 0으로 설정하면 채팅으로 누구나 돌릴 수 있습니다.
    • 1원 이상으로 설정하면 해당 금액 이상의 후원에만 반응합니다.

[!TIP] 명령어에 $$ 활용하기

명령어에 $$를 사용하면 임의의 문자열로 대체되어 인식됩니다.

  • !룰렛 → 정확히 !룰렛만 입력해야 함
  • $$룰렛$$브이찍룰렛VZZK처럼 앞뒤에 어떤 내용이든 추가 가능

3단계: 선택지 추가하기

  1. 룰렛을 선택한 상태에서 + 선택지 추가 버튼을 클릭합니다.
  2. 선택지 이름을 입력합니다. (예: 물 마시기, 스트레칭, 꽝)
  3. 당첨 확률 배수를 설정합니다.
    • 기본값은 1입니다.
    • 숫자가 클수록 당첨 확률이 높아집니다.
    • 예: 배수가 2인 선택지는 배수가 1인 선택지보다 2배 확률로 당첨됩니다.

시청자 참여 방법

룰렛 설정이 완료되면 시청자는 아래 방법으로 참여할 수 있습니다:

  • 채팅으로 참여: 스트리머가 설정한 명령어를 채팅창에 입력합니다.
  • 후원으로 참여: 최소 금액이 설정된 룰렛의 경우, 해당 금액 이상을 후원하며 명령어를 포함합니다.

룰렛이 돌아가면 채팅에 🎰 [닉네임]님께서 "[룰렛이름]" 룰렛을 신청했습니다. 메시지가 표시됩니다.

당첨 기록 확인하기

당첨 목록 탭에서 지금까지의 룰렛 당첨 기록을 확인할 수 있습니다.

필터 및 검색 기능

당첨 기록을 다양한 방식으로 조회할 수 있습니다:

  • 플레이어별: 각 시청자가 어떤 결과를 받았는지 확인
  • 룰렛별: 특정 룰렛의 모든 당첨 기록 확인
  • 선택지별: 특정 선택지가 몇 번 당첨되었는지 확인

검색창에 키워드를 입력하면 플레이어 이름, 룰렛 이름, 선택지 이름을 한 번에 검색할 수 있습니다.

당첨 횟수 수정

각 기록의 당첨 횟수를 직접 수정하거나 기록을 삭제할 수 있습니다.

방송 오버레이

overlay-roulette

룰렛이 돌아가는 과정을 시청자들에게 실시간으로 보여주고 싶다면 방송 오버레이를 사용하세요!

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

  • 룰렛이 돌아가는 애니메이션이 표시돼요
  • 결과가 자동으로 방송 화면에 나타나요
  • 시청자들의 참여율이 높아져요

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