앱 아키텍처
BakoshApp의 구조: 설정이 어디에 저장되는지, TikTok 이벤트가 어떻게 게임으로 흘러가는지, 활성 모드를 전환할 때 어떤 일이 일어나는지, 자동 업데이트가 어떻게 작동하는지.
BakoshApp이란
BakoshApp은 TikTok LIVE 스트림의 이벤트를 게임 내 모드와 연결해주는 Windows 데스크톱 애플리케이션입니다. 시청자가 선물을 보내고, 좋아요를 누르고, 채팅을 작성하면 스트리머의 게임 내에서 효과가 자동으로 발생해요.
현재 앱에는 다섯 개의 모드가 포함되어 있어요:
- GTA V KOTH (King of the Hill) — 시청자가 "언덕의 왕" 모드에서 자동차와 장애물을 스폰합니다. 상호작용형, PRO.
- GTA V Chaos — 시청자가 350개 이상의 카오스 효과(시간, 날씨, NPC 스폰, 화면 효과)를 발동시킵니다. 상호작용형, PRO.
- GTA V Train — 자동 기차 시뮬레이터(출발/정지, 선로 전환, 속도 및 체력 관리). 자동형, MAX.
- Rust Survival — 시청자가 스트리머에게 아이템을 주고, 동물을 스폰하고, 함정을 활성화할 수 있는 완전한 로컬 Rust 서버입니다. 상호작용형, PRO.
- RDR2 Chaos — Red Dead Redemption 2를 위한 185개 이상의 카오스 효과. 상호작용형, PRO.
KOTH, Chaos, Train은 동일한 GTA V 모드 아카이브(gta.zip)의 세 가지 변형이에요. 다운로드는 공유되지만 각 변형은 자체 설치 폴더(gta_koth_folderPath, gta_chaos_folderPath, gta_train_folderPath)를 가집니다. 하나의 GTA V 설치를 가리키게 하거나 별도로 유지할 수 있어요. 한 번에 하나의 모드만 활성화할 수 있으며, 사이드바의 각 모드 카드에 있는 토글로 제어합니다.
TikTok 이벤트가 앱에 도달하는 방법
TikTok LIVE 이벤트가 BakoshApp에 도달하려면 두 가지 연결 방법 중 하나가 필요해요.
| 방법 | 이용 가능 대상 | 설치해야 할 것 |
|---|---|---|
| TikFinity | Free 및 PRO | TikFinity + TikTok Live Studio |
| Native Connector (BakoshApp 내장) | PRO 전용 | 없음 — 연결이 자동으로 이루어집니다 |
TikFinity는 TikTok 이벤트를 받아 BakoshApp으로 전달하는 별도 프로그램이에요. Native Connector는 TikFinity 없이 TikTok에 직접 연결하며 PRO 전용 기능입니다. TikTok Live Studio는 두 설정 모두에서 여전히 필요해요 — PC에서 TikTok LIVE를 실행하기 위함이며, 커넥터는 TikTok에서 BakoshApp으로 이벤트를 가져오는 방식만 다릅니다. 자세한 비교는 TikFinity vs Native를 참고하세요.
시청자가 선물을 보냈을 때 일어나는 일
- TikTok에서 이벤트가 도착합니다(TikFinity 또는 Native Connector 경유).
- BakoshApp이 Events & Actions 페이지에서 설정한 트리거와 매칭합니다.
- 이벤트가 매칭되면 앱이 게임 내에서 액션을 실행합니다.
- 동시에 해당 액션에 첨부된 오디오가 재생됩니다.
이는 모든 모드에서 동일한 파이프라인이며, 액션과 트리거 카탈로그만 다릅니다.
설정 저장 위치
BakoshApp 설정은 숨겨진 Windows 폴더 %LOCALAPPDATA%\BakoshApp에 저장됩니다. 해당 경로를 Windows 탐색기 주소 표시줄에 붙여넣어 열 수 있어요. 이전 버전에서는 파일이 다른 폴더에 있었지만, 업데이트 후 첫 실행 시 앱이 자동으로 마이그레이션합니다.
로컬에 저장되는 설정에는 GTA V 폴더 경로, Rust 서버 폴더 경로, Rust 서버 실행 파라미터, 현재 활성화된 모드, 개인 사용자 식별자가 포함됩니다.
액션 자체(각 선물이 무엇을 하는지, 어떤 트리거가 할당되었는지, 어떤 사운드가 재생되는지)는 서버에 저장되며 계정과 연결되어 있습니다. 즉, Windows 재설치나 PC 교체 후에도 로그인만 하면 액션 설정이 다시 나타나요. 각 모드의 Events & Actions 페이지에서 Export 버튼을 통해 .bka 파일로 내보낼 수도 있어요 — Import / Export 참조.
액션이 서버에 저장되기 때문에 Windows 재설치 전에 수동으로 백업할 필요가 없어요. 그냥 다시 로그인하면 됩니다.
활성 모드를 전환할 때 일어나는 일
사이드바의 각 모드 카드에는 토글이 있어요. 활성 모드를 전환하면 BakoshApp은:
- 이전에 활성화된 게임과의 연결을 종료하고,
- 누적된 좋아요 및 선물 카운터를 초기화하고,
- 새로 활성화된 게임에 대한 연결을 엽니다.
이로 인해 전환 직후 몇 초 동안 상호작용이 끊겨요. 정상적인 현상이니 다시 연결될 때까지 잠시 기다려주세요.
자동 업데이트
BakoshApp은 자체적으로 업데이트됩니다. 새 버전이 제공되면 앱을 재시작하여 적용하세요. 현재 버전은 사이드바의 "Bakosh.app" 로고 바로 아래에 표시됩니다.
BakoshApp은 설치 시 작은 백그라운드 서비스와 함께 제공됩니다. 백신이 해당 파일을 제거하면 앱이 작동을 멈춰요. 증상: 실행 시 "The system cannot find the file specified" 또는 Failed to spawn sidecar (os error 2).
해결: bakosh.app/bakoshapp에서 BakoshApp을 재설치한 다음 설치 폴더를 백신의 예외 목록에 추가하세요. SmartScreen이 설치 프로그램을 차단하면 "More info" → "Run anyway"를 클릭하세요.