외부 명령어
게임 밖에 닿는 액션이에요: 키를 누르고, HTTP 요청을 보내고, 프로그램을 실행하고, OBS 장면을 전환하고, Streamer.bot 액션을 실행하거나 여러분의 도구를 직접 호출하세요.
외부 명령어는 시청자가 선물을 보내거나 채팅을 남겼을 때 게임 밖에서 무언가를 하는 액션이에요 — 키를 누르거나, 스마트 조명을 켜거나, OBS 장면을 전환하는 식이죠. 모든 Mod와 모든 커스텀 통합에, 모든 플랜에 있어요: Free에서는 TikFinity 트리거로, PRO와 MAX에서는 네이티브 TikTok 및 Kick 트리거로 사용할 수 있어요.
외부 명령어 추가하기
- 액션 탭에서 새로 추가를 클릭하고 트리거를 선택하세요.
- 모든 액션에서 외부 탭을 여세요.
- 명령어 옆의 Configure를 클릭하고 설정을 입력한 다음 저장하세요.
명령어는 다른 액션과 마찬가지로 횟수만큼 실행되며, 실행 사이에는 행의 간격만큼 시간이 있어요. 게임이 필요하지 않아요: Mod나 통합이 켜져 있기만 하면 돼요.
명령어 목록
| 명령어 | 무엇을 하는지 |
|---|---|
| Keystroke | 포커스가 있는 창에서 키나 마우스 버튼을 누릅니다. |
| Webhook | URL로 HTTP 요청을 보냅니다. |
| Execute program | 프로그램이나 스크립트를 실행합니다. |
| Streamer.bot | Streamer.bot에서 액션을 실행합니다. |
| OBS | OBS Studio에서 장면을 전환하거나 소스를 표시/숨깁니다. |
| Third-Party Action | 여러분의 앱에서 액션을 실행합니다 — Third-Party 인터페이스를 참고하세요. |
Keystroke
키 시퀀스를 설정하고, 선택적으로 수정자 키, 특수 키 또는 마우스 버튼, 누름 시간 (ms)(기본값 100)을 설정하세요. 게임에서는 게임 모드를 켜두고, 일반 앱이나 채팅에 입력하려면 꺼두세요.
Webhook
URL(http 또는 https)과 메서드를 입력하세요 — 기본값은 JSON 본문이 포함된 POST이고, GET, PUT, PATCH, DELETE도 사용할 수 있어요. {username}이나 {giftName} 같은 변수는 URL, 헤더, 본문에 채워지며, GET을 제외한 모든 메서드는 본문에 모든 이벤트 정보도 함께 보내요. BakoshApp은 최대 10초까지 응답을 기다려요.
Execute program
찾아보기로 .exe, .bat, .cmd 또는 .ps1 파일을 선택하고, 필요하면 인수를 추가하세요(여기서도 변수를 사용할 수 있어요). 프로세스 종료 대기를 켜면 프로그램이 종료될 때까지 다음 실행을 기다려요.
Streamer.bot
먼저 설정 → Streamer.bot에서 Streamer.bot을 연결하세요(기본값은 127.0.0.1, 포트 8080이며, Streamer.bot에서 WebSocket 서버가 인증 없이 켜져 있어야 해요). 그런 다음 실행할 Streamer.bot 액션을 선택하세요. 이벤트 정보는 인수로 전달되며, Streamer.bot에서 %username%, %giftName% 등으로 사용할 수 있어요.
OBS
먼저 설정 → OBS에서 OBS를 연결하세요(기본값은 127.0.0.1, 포트 4455이며, OBS WebSocket 서버의 비밀번호가 필요해요). 그런 다음 장면 전환 또는 소스 전환을 선택하세요:
- 영구 / 상태 설정 — 변경 사항이 유지돼요.
- 시간 기반 — 지속 시간(기본값 5초)이 지나면 변경이 취소돼요: OBS가 이전 장면으로 돌아가거나 소스를 다시 숨겨요.
변수
Webhook, Execute program, Streamer.bot은 액션을 실행한 이벤트의 정보를 사용할 수 있어요: username, nickname, eventType, giftName, giftId, repeatCount, diamondCount, likeCount, profilePictureUrl, subMonth. TikFinity에서는 username만 사용할 수 있어요.
다른 사람에게서 받은 프리셋의 명령어
다른 계정이 프리셋을 보내면 그 안의 Execute program 및 Keystroke 액션은 꺼진 상태로 도착해요. 내 PC에서 프로그램을 실행하거나 키를 누를 수 있기 때문이에요. 설정을 확인한 뒤 액션에서 직접 켜거나, 프리셋을 수락할 때 켜 둔 채로 받기 — 보낸 사람을 신뢰합니다를 체크하세요. OBS, Streamer.bot, Third-Party 연결은 설정에서 정한 그대로 유지돼요. 프리셋에 포함되지 않기 때문이에요.
아이디어
- 누군가 선물을 보내면 어떤 게임에서든 키를 누르게 하기 — 경적, 점프, 발사 등.
- 새 팔로워가 생기면 HTTP 요청으로 스마트 조명 켜기.
- 구독이 발생하면 스크립트 실행하기.
- 큰 선물이 도착하면 10초 동안 OBS 장면 전환하기.