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

TITS(Twitch Integrated Throwing System) 연동 기능은 시청자가 채팅을 치거나 후원(치즈)을 보냈을 때, 버튜버 아바타를 향해 뿅망치나 과일 같은 가상 아이템이 날아가 타격감을 주는 3D 물리 리액션 도구입니다.

이렇게 활용해 보세요

  • 버튜버 방송의 역동성 강화: 2D/3D 아바타 방송의 다소 정적인 화면에 물리 엔진 기반의 아이템 던지기를 추가하여 시청자들의 눈을 즐겁게 만듭니다.
  • 후원(치즈) 기반 프리미엄 리액션: 특정 금액 이상의 후원에만 특별한 아이템(예: 커다란 금괴)이 던져지게 설정하여, 고액 후원을 이끌어내는 강력한 동기를 제공합니다.
  • 게임 벌칙 연계: "죽을 때마다 뿅망치 1대" 등의 룰을 만들어 시청자들이 직접 벌칙에 개입하는 재미를 선사합니다.

시작하기 전에

VZZK은 치지직 채팅과 TITS 프로그램을 연결하는 '다리' 역할만 수행합니다. 따라서 아바타 화면에 실제로 물건을 던지려면 TITS 프로그램 본체가 먼저 설치되어 있어야 합니다. (VTube Studio, Warudo, VSeeFace 모두 호환)

1. TITS 프로그램 API 열기

VZZK이 TITS를 조종할 수 있도록 권한을 열어주어야 합니다.

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

2. VZZK과 TITS 연결

  1. VZZK 앱의 TITS 설정 메뉴로 이동합니다.
  2. TITS 프로그램에서 확인한 포트 번호(42069)를 입력합니다. 포트 번호가 맞으면 자동으로 연결됩니다.
  3. TITS 프로그램 상단의 TRIGGER MANAGER 탭에서 생성해둔 트리거의 **Name (대소문자 구분)**을 확인합니다.

3. 던지기 반응 규칙 (Trigger) 설정

채팅이나 치즈 후원이 발생했을 때 TITS의 어떤 트리거를 발동시킬지 규칙을 등록합니다. 여러 개의 규칙을 동시에 추가할 수 있습니다.

  • 채팅 명령어: 이 명령어가 채팅에 포함되면 아이템이 던져집니다.
    • $$를 활용하면 문장 속에 단어가 포함되기만 해도 인식합니다. (예: $$토마토$$ → "토마토 먹어라" 채팅에 반응)
    • 내용에 상관없이 무조건 반응하게 하려면 $$만 입력하세요.
  • 트리거 이름: TITS 프로그램에서 설정한 정확한 트리거 Name을 입력합니다.
  • 최소 금액(원) (VZZK Pro 전용):
    • 특정 금액(1원 이상) 이상을 후원했을 때만 물건이 던져지게 하려면 VZZK Pro 자격이 필요합니다.
    • 0원으로 설정하면 무료 채팅으로도 누구나 물건을 던질 수 있습니다.

규칙 활용 예시

채팅 명령어 트리거 이름 최소 금액 결과
!던져 ThrowItem 0원 누구나 !던져라고 무료 채팅을 치면 발동
$$ BigCoin 5000원 명령어 내용에 상관없이 5,000원 이상 후원 시 무조건 발동
$$토마토$$ Tomato 1000원 1,000원 이상 후원 메시지에 "토마토"가 포함되어 있으면 발동