룰렛 - auejin/vzzk-bot GitHub Wiki

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

플러그인 활성화하기

룰렛 기능은 VZZK에 연결되어 있지 않을 때만 활성화할 수 있습니다.

VZZK 프로그램과의 연결을 먼저 해제해주세요.
플러그인 설정 메뉴로 이동하여 룰렛 플러그인을 활성화합니다.
설정을 저장하고 다시 VZZK에 연결하면 사용할 준비가 완료됩니다.

[!IMPORTANT] 플러그인 활성화는 반드시 VZZK 연결이 해제된 상태에서 진행해야 합니다. 연결된 상태에서는 설정을 바꿀 수 없습니다.

룰렛 설정 방법

룰렛 설정은 크게 룰렛 만들기와 선택지 추가하기 두 단계로 나뉩니다.

1. 룰렛 만들기 (룰렛 목록)

룰렛 목록 메뉴에서 방송에 사용할 룰렛의 기본 정보를 만듭니다.

룰렛 이름: 룰렛을 구분하기 위한 고유한 이름입니다. (예: 벌칙 룰렛, 미션 룰렛)
명령어: 시청자가 룰렛을 돌릴 때 사용할 채팅 명령어입니다.
최소 금액 (원): 1원 이상으로 설정하면, 해당 금액 이상의 후원에 명령어가 포함될 경우 룰렛이 실행됩니다. (0원으로 설정 시 채팅으로만 가능)

[!TIP] 명령어에 $$를 사용해 보세요! 명령어의 $$는 임의의 문자열로 대체되어 인식됩니다.

명령어를 !룰렛으로 설정하면 시청자가 정확히 !룰렛이라고 입력해야 하지만, $$룰렛$$으로 설정하면 브이찍룰렛VZZK처럼 명령어 앞뒤에 어떤 내용이든 추가로 입력할 수 있어 편리합니다.

2. 선택지 추가하기 (룰렛 선택지)

룰렛 선택지 메뉴에서 위에서 만든 각 룰렛에 들어갈 항목과 당첨 확률을 설정합니다.

룰렛 이름: 선택지를 추가하고 싶은 룰렛의 이름을 선택합니다.
선택지: 룰렛을 돌렸을 때 나오는 항목의 이름입니다. (예: 물 마시기, 스트레칭 하기, 꽝)
당첨 확률 배수: 각 선택지의 당첨 확률 가중치입니다. 모든 선택지의 기본 확률은 동일하며, 이 배수 값에 비례하여 당첨 확률이 결정됩니다. 숫자가 클수록 당첨될 확률이 높아집니다. (0 이하는 기본값 1로 적용)

시청자 참여 방법

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

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

방송 오버레이

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

OBS 같은 방송 프로그램에 오버레이를 추가하면, 룰렛이 실행될 때마다 자동으로 방송 화면에 결과가 표시되어 시청자들의 몰입도를 높일 수 있습니다.

룰렛 전용 오버레이 기능은 현재 개발 중이며, 완성되는 대로 본문에 자세한 사용법을 업데이트할 예정입니다.