TITS ‐ 버튜버를 위한 물건 던지기 리액션 플러그인 - auejin/vzzk-bot GitHub Wiki

TITS(Twitch Integrated Throwing System)는 시청자가 채팅이나 후원으로 버튜버 아바타에 물건을 던질 수 있게 해주는 기능입니다. VTube Studio, Warudo, VSeeFace 모두 지원합니다!

기능 활성화하기

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

[!NOTE] TITS 기능은 기본적으로 비활성화되어 있습니다. 버튜버가 아니시라면 사용하지 않으셔도 됩니다.

TITS 프로그램 준비하기

VZZK과 연동하려면 먼저 TITS 프로그램이 필요합니다.

TITS 다운로드

여기에서 TITS 프로그램을 다운로드하세요.

TITS 사용법 배우기

VZZK과 TITS 연결하기

1단계: TITS API 활성화

  1. TITS 프로그램을 실행합니다.
  2. 우측 하단의 톱니바퀴(설정) 아이콘을 클릭합니다.
  3. 아래로 스크롤하여 T.I.T.S API 영역을 찾습니다.
  4. Enabled를 ON으로 설정합니다.
  5. Port 번호를 확인합니다 (기본값: 42069).

2단계: VZZK에서 포트 번호 설정

  1. VZZK의 TITS 설정 페이지에서 포트 번호를 위에서 확인한 값으로 입력합니다.
  2. 기본값 42069를 변경하지 않았다면 그대로 사용하면 됩니다.

3단계: 트리거 이름 확인

  1. TITS 프로그램에서 상단의 TRIGGER MANAGER 탭을 클릭합니다.
  2. 트리거가 없다면 NEW TRIGGER 버튼으로 새로 만듭니다.
  3. 트리거의 Name을 기억해두세요 (대소문자 구분!).

설정

포트 번호

TITS 프로그램과 통신하기 위한 포트 번호입니다.

  • 기본값: 42069
  • TITS에서 변경했다면 동일하게 맞춰주세요.

[!TIP] 포트 번호를 변경하면 자동으로 재연결을 시도합니다.

던지기 반응 규칙

채팅이나 후원에 반응하여 TITS 트리거를 실행할 규칙을 설정합니다.

채팅 명령어

시청자가 입력할 명령어입니다.

  • $$를 사용하면 임의의 문자열로 대체됩니다.
  • 모든 후원에 반응하게 하려면 $$만 입력하세요.
  • 설$$, $$딘, $$던져$$ 등 다양한 패턴 가능

트리거 이름

TITS에서 설정한 트리거의 Name입니다.

  • 대소문자를 정확히 입력해야 합니다!

최소 금액 (원)

  • 0원: 채팅과 후원 모두에서 명령어 감지
  • 1원 이상: 해당 금액 이상의 후원에서만 명령어 감지

규칙 추가 방법

  1. 채팅 명령어, 트리거 이름, 최소 금액을 입력합니다.
  2. + 버튼을 클릭하여 규칙을 저장합니다.
  3. 규칙을 삭제하려면 해당 규칙 옆의 - 버튼을 클릭합니다.

예시 설정

채팅 명령어 트리거 이름 최소 금액 설명
!던져 ThrowItem 0원 누구나 !던져 입력 시 발동
$$ DonationThrow 1000원 1000원 이상 후원 시 무조건 발동
$$토마토$$ TomatoThrow 500원 500원 이상 후원에 "토마토" 포함 시 발동