가이드
가이드 › 운영 도구 › Mix It Up 연동

🔌 Mix It Up 연동

후원·구독·포인트샵·룰렛/뽑기 결과로 Mix It Up 명령을 실행하는 마이봇 연동.

Mix It Up 연동은 빵떡이에 들어온 후원·구독·구독선물·포인트샵 구매·룰렛/뽑기 결과 같은 일을 내 PC에서 돌고 있는 Mix It Up(믹스잇업 — 명령·자동화 도구)의 명령(Command) 으로 실행해 주는 기능입니다. 예를 들어 5,000원 후원 → 사운드 재생 명령, 룰렛 ‘꽝’ → 오버레이 연출 명령 처럼 이어 붙일 수 있습니다.

마이봇 안에 들어 있는 기능입니다 (1.4.0)

이건 별도 프로그램이 아니라 마이봇에 들어 있는 모듈입니다(마이봇 1.4.0 이상). 그래서 마이봇을 먼저 설치·연결해 두어야 하고(마이봇 가이드 참고), 명령을 받을 Mix It Up 앱도 같은 PC에 켜져 있어야 합니다. 셋(마이봇·Mix It Up·방송)이 같은 컴퓨터에서 돌아야 합니다. T.I.T.S. 던지기와 같은 자리에서 고르며, 규칙마다 둘 중 어느 쪽으로 보낼지 정합니다.

1. Mix It Up 에서 개발자 API 를 켭니다

  1. Services › Developer API 를 연결합니다

    Mix It Up 앱에서 Services → Developer API 로 들어가 Connect 를 눌러 켜 주세요. 마이봇은 이 API(http://localhost:8911)를 통해 명령을 실행합니다. 포트는 기본값 8911 그대로 두면 됩니다.

    같은 PC(로컬)에서만 접속하므로 별도 인증 키는 필요 없습니다. 설정 위치·모양은 Mix It Up 버전에 따라 다를 수 있습니다.

  2. 실행할 명령(Command) 을 미리 만들어 둡니다

    Mix It Up 안에서 실행하고 싶은 명령(사운드·오버레이·채팅·OBS 제어 등)을 먼저 만들어 두세요. 마이봇은 그 명령 이름(또는 ID)으로 골라 실행합니다.

2. 마이봇에서 Mix It Up 연동을 켭니다

  1. 마이봇 “T.I.T.S. · Mix It Up 연동” 에서 Mix It Up 사용 을 켭니다

    마이봇 앱의 T.I.T.S. · Mix It Up 연동 카드에서 Mix It Up 사용 체크를 켜면, 같은 PC의 Mix It Up 을 찾아 연결합니다. 정상 연결되면 ‘연결됨’ 으로 바뀝니다.

  2. “목록 불러오기” 로 명령을 가져옵니다

    목록 불러오기 를 누르면 Mix It Up 에 만들어 둔 명령 이름이 자동으로 채워집니다. 규칙을 만들 때 이 목록에서 고르면 됩니다.

3. 규칙을 만듭니다 (어떤 일 → 어떤 명령)

  1. “+ 규칙 추가” 로 이벤트와 명령을 잇습니다

    이벤트(무슨 일이 일어났을 때)를 고르고, 동작을 Mix It Up 명령 으로 바꾼 뒤 실행할 명령을 지정합니다. 필요하면 조건(예: 후원 금액 1,000원 이상)을 더합니다.

    마이봇 규칙 — 포인트샵 구매 → Mix It Up 명령 실행, 인자·추가값·조건 무시
    동작을 Mix It Up 명령 으로 바꾸고 명령·인자를 지정합니다. Mix It Up 조건 무시를 켜면 그 명령의 사용 조건(쿨다운·권한 등)을 건너뜁니다.
  2. 인자·추가 값으로 사람·금액을 넘깁니다

    인자(Arguments) 칸과 추가 값(키=값, 한 줄에 하나)에 아래 자리표시자를 넣으면, 이벤트의 실제 값으로 바뀌어 Mix It Up 명령에 전달됩니다.

    자리표시자뜻
    {nickname}이벤트를 일으킨 사람 닉네임
    {label}항목 이름(상품·아이템·룰렛 항목 등)
    {outcome}결과(룰렛·뽑기 당첨 등)
    {amount} · {unit}수치와 단위(후원 금액·포인트 등)
    {tier} · {giftCount}구독 티어 · 선물 개수
    {keyword} · {gameKind} · {type}명령어 키워드 · 게임 종류 · 이벤트 종류

    Mix It Up 명령 안에서는 $bbevent_nick · $bbevent_label · $bbevent_outcome · $bbevent_amount · $bbevent_unit · $bbevent_giftcount · $bbevent_type 를 항상 쓸 수 있습니다.

  3. 쓸 수 있는 이벤트

    이벤트설명
    후원치즈 후원(금액 조건을 걸 수 있음)
    구독 · 구독 선물구독, 구독권 선물(선물은 개수만큼)
    포인트샵 구매시청자가 포인트샵에서 아이템을 샀을 때
    게임 결과룰렛·뽑기의 당첨 결과(항목 이름으로 매칭)
    채팅채팅 메시지에 지정한 단어가 포함됐을 때(키워드 매칭) (1.4.1)
    채팅 명령어인식된 명령어가 실행됐을 때(! 로 시작하는 명령 — ‘채팅’ 과 달리 등록된 명령만)
    티켓 사용!티켓 으로 티켓을 썼을 때(아이템 이름으로 매칭)

    여러 규칙이 겹치면 맨 위에서 처음 맞는 규칙 하나만 실행됩니다(순서가 우선순위). SOOP 별풍선은 아직 범위 밖입니다.

연결 방식 — 마이봇 겸용 / T.I.T.S. · Mix It Up 전용

이미 마이봇으로 부계정 채팅까지 쓰고 있다면 그대로 켜면 됩니다(겸용). 채팅은 안 쓰고 명령·던지기만 쓰고 싶다면 앱 위쪽 사용 방식에서 T.I.T.S. · Mix It Up 전용 으로 연결하세요 — 이 경우 빵떡이 채팅은 서버가 직접 치고(치지직 개발자 앱·로그인 불필요), 마이봇은 명령·던지기만 담당합니다.

연결 키

연동에 쓰는 연결 키는 마이봇과 같은 값입니다 (운영 도구 › 마이봇 페이지의 연결 키). 마이봇을 이미 연결해 뒀다면 추가로 할 일은 없고, 앱의 브라우저로 연결 을 쓰면 키를 복사하지 않고 한 번에 이어집니다. 연결 키는 외부에 공개하지 마세요.

잘 안 될 때

증상해결
‘연결 안 됨’ 에서 안 바뀐다① Mix It Up 이 켜져 있는지 ② Services › Developer API 가 Connect 됐는지 ③ 포트가 8911 인지 확인하세요.
규칙 목록에 명령이 안 뜬다목록 불러오기 를 다시 누르세요. 그래도 비어 있으면 Mix It Up 에 명령이 만들어져 있는지 확인합니다.
이벤트가 와도 명령이 안 돈다규칙의 명령 이름이 Mix It Up 명령 이름과 정확히 같은지, 그 명령이 켜져(Enabled) 있는지, 명령의 사용 조건(쿨다운·권한)에 막히지 않았는지 확인하세요(필요하면 Mix It Up 조건 무시).
채팅이 부계정으로 나가 버린다명령만 쓰려면 T.I.T.S. · Mix It Up 전용 으로 연결하세요(겸용은 부계정 채팅을 함께 씁니다).
세 가지가 같은 PC에 켜져 있어야 합니다

마이봇 · Mix It Up · 방송 프로그램이 모두 같은 컴퓨터에서 돌고 있어야 명령이 실행됩니다. 컴퓨터를 끄거나 어느 하나를 닫으면 멈추지만, 빵떡 본체 기능은 그대로입니다.