OBS와 TikTok LIVE Studio용 오버레이

모든 모드와 커스텀 통합의 오버레이 탭은 방송 화면 위에 나타나는 위젯을 편집하는 곳이에요. 시청자가 발동할 수 있는 항목을 보여 주는 보드, 선물과 팔로우 알림, 방송 목표, 카운터, 순위표, 승리 카운터, 팀 점수, 게임에서 곧바로 가져오는 체력·사망 수·결승점까지의 거리, 그리고 직접 만든 텍스트, 사진, 동영상까지 넣을 수 있어요. OBS나 TikTok LIVE Studio에 링크 하나만 추가하면, 오버레이는 항상 BakoshApp에서 활성화된 모드의 레이아웃을 보여 줘요.

레이아웃은 모드의 활성 프리셋에 속해요. 프리셋을 바꾸면 오버레이도 함께 바뀌어요.

위젯

위젯 추가를 클릭하면 위젯 카탈로그가 열려요. 카탈로그는 여러 섹션으로 나뉘어 있고, 일부 위젯은 미리 만들어진 카드 여러 개로 제공돼요(예: Like Goal과 Gift Mission은 둘 다 Stream Goal이에요).

• Action Board — 모드의 액션으로 만든 타일 보드예요. "이 선물 → 게임에서 이 일이 일어남"처럼요. 별도 문서가 있어요: Action Board.
• Avatar — 방송에 나오는 3D 아바타예요. Bakosh Avatar 문서를 참고하세요.
• Health Bar, Finish Distance, Death Counter는 게임이 보고하는 값을 보여 줘요. 자세한 내용은 게임에서 가져오는 체력, 사망 수, 거리를 참고하세요.

알림, 목표, 카운터, 순위표는 네이티브 커넥터와 Kick 커넥터에서 데이터를 받아요. TikFinity를 통해 들어오는 이벤트는 알림을 표시하지 않고 통계에도 집계되지 않아요.

레이아웃 만들기

1. 모드를 열고 → 오버레이로 이동하세요.
2. 위젯 추가를 클릭하고 카드를 선택한 다음, … 스타일 선택에서 모양을 고르세요.
3. 캔버스에서 위젯을 드래그하고 크기와 회전을 조절하세요. 텍스트, 색상, 동작은 오른쪽 패널에서 설정해요.
4. 레이어를 사용해 위젯을 잠그거나 숨기거나 복제하거나 삭제하세요. 복제 대상…은 위젯을 다른 모드나 통합으로 복사해요.

크기는 대부분의 위젯 패널에서 첫 번째 필드로, 위젯 전체의 크기를 조절해요 — 텍스트, 아이콘, 막대, 간격이 함께 바뀌어요. 캔버스에서 드래그하는 프레임은 위젯에 공간을 주는 역할만 해요. 프레임을 작게 만들면 간격이 먼저 줄어들어요. Text 위젯에는 대신 글꼴 크기가 있어요.

변경 사항은 자동으로 저장돼요. 자석 버튼(가이드에 맞춤)을 켜면 위젯이 캔버스의 중앙과 가장자리, 그리고 다른 위젯에 달라붙어요.

레이아웃에는 두 가지 화면 모드가 있어요 — 가로형(1920×1080)과 세로형(1080×1920) — 캔버스 위의 버튼으로 전환해요. 각 위젯은 모드마다 자신의 위치, 크기, 자르기를 따로 유지하므로, 하나의 레이아웃으로 두 방향 모두에서 쓸 수 있어요.

키보드 단축키

확대/축소 컨트롤 옆의 키보드 버튼(키보드 단축키)을 누르면 전체 목록이 나와요.

Shift를 누르지 않으면 모서리 핸들로 크기가 자유롭게 바뀌어요. 텍스트와 보드는 늘어나는 대신 스스로 다시 배치돼요. 실행 취소는 실시간 점수, 복제 대상…, 업로드, 액션의 방송용 모습을 되돌리지 않아요.

자르기는 Image와 Video 위젯에서 쓸 수 있어요. Alt를 누른 채 핸들을 드래그하면 크기가 바뀌는 대신 가장자리가 그림을 잘라 내요. 패널의 자르기 초기화를 누르면 그림 전체가 돌아와요.

데모

이벤트에 반응하거나 숫자가 바뀌는 위젯에는 패널에 데모 버튼이 있어요. 이 버튼은 해당 위젯만 재생해요. 캔버스와 동시에 OBS나 TikTok LIVE Studio에서도 재생되므로 방송에서 어떻게 보이는지 확인할 수 있어요.

• 알림은 샘플 이벤트를 소리와 함께 보여 줘요.
• 목표, 카운터, 순위표, Win Counter, Team Score, Death Counter, Health Bar, Finish Distance, Action Board는 샘플 값을 재생하거나 깜빡인 다음 실제 값으로 돌아와요.

이벤트가 일어나는 순간에만 보이는 설정(애니메이션, 파티클, 보드의 깜빡임)은 설정을 바꾸는 동안 캔버스에서 데모가 저절로 다시 재생돼요. 방송 중일 수 있으니 이때는 OBS로 아무것도 전송되지 않아요.

스트림에 오버레이 추가하기

캔버스 위의 URL 복사를 클릭하세요. 링크는 현재 화면 모드에 속해요. 세로 방송용으로 한 번은 세로형에서, 가로 방송용으로 한 번은 가로형에서 복사하세요. ? 버튼(가이드)을 누르면 스크린샷과 함께 단계를 보여 줘요.

TikTok LIVE Studio:

1. Add source를 클릭하고 Link를 선택하세요.
2. 링크를 붙여 넣고, Custom resolution을 켠 다음 1080×1920(가로 방송이면 1920×1080)으로 설정하세요.
3. 크기 조정 메뉴에서 Fill을 선택하고, 이 소스를 다른 소스보다 위에 두세요.

OBS Studio: Browser Source를 추가하고 URL을 붙여넣은 다음, 가로는 1920×1080, 세로는 1080×1920으로 크기를 설정하세요.

BakoshApp은 OBS나 LIVE Studio와 같은 PC에서 실행되고 있어야 해요 — 오버레이는 앱에서 이벤트를 받아오거든요. 링크는 모드에 좌우되지 않아요: 활성 모드를 전환하면 오버레이도 그 모드의 레이아웃으로 바뀌어요.

Chrome 또는 Edge에서 링크 열기

OBS와 TikTok LIVE Studio는 오버레이를 그대로 보여 줘요. Chrome과 Edge는 먼저 bakosh.app이 컴퓨터의 앱에 접근해도 되는지 물어봐요. Allow를 클릭하세요. 차단했다면 페이지에 "Browser is blocking the overlay"가 표시돼요. 주소창 왼쪽의 아이콘을 클릭하고 Apps on device를 허용하면 오버레이가 저절로 다시 연결돼요.

알림

알림 위젯마다 필터가 있어요: 플랫폼(TikTok, Kick 또는 둘 다), 반응할 선물, 최소 다이아 수(TikTok) / 최소 Kicks 수(Kick), 발동에 필요한 좋아요 수, 반복 합치기, 시청자당 한 번, 대기 시간 (ms). 알림은 대기열에서 기다리며, 기본적으로 각각 4초 동안 표시돼요.

각 알림은 텍스트 필드 아래에 사용할 수 있는 변수를 나열해요. 예를 들어 선물에는 {nickname}, {username}, {giftName}, {repeatCount}, {diamondCount}를, 좋아요에는 {likesAmount}를 쓸 수 있어요. 효과 섹션에서는 숫자 카운트 업, 움직이는 이미지, 글로우, 빛 스윕, 파티클을 추가할 수 있어요.

목표, 카운터, 순위표

이 위젯들은 연결된 플랫폼이 보고한 시청자 통계를 보여 줘요. 집계 항목, 기간(이번 방송, 최근 7일, 최근 30일, 전체 기간), 플랫폼을 선택하세요.

• Stream Goal — 목표를 향한 진행 상황이에요. 달성 시: 100%에서 유지 또는 정한 만큼 목표 올리기.
• Stream Counter — 아이콘과 라벨이 붙은 숫자 하나로, 좋아요, 신규 팔로워, 접속 중인 시청자, 코인, 특정 선물 등을 보여 줘요.
• Leaderboard — 상위 시청자를 목록 또는 시상대(상위 3명)으로 보여 줘요. 값 위치는 숫자를 이름 옆이나 아래에 두고, 좌우 반전(오른쪽에서 왼쪽)은 화면 오른쪽에 맞게 행을 뒤집고, 제목 크기(%)는 제목 크기를 조절해요. 빈 자리는 대시로 표시되고, 순위표가 비어 있으면 설정해 둔 비어 있을 때 텍스트가 표시돼요.

데이터가 없는 동안 에디터에는 샘플 행이 표시되고, OBS에는 실제 시청자만 표시돼요. 테스트 이벤트는 집계되지 않아요. 애니메이션을 보려면 데모를 사용하세요.

Win Counter, Team Score, Death Counter

카운터는 액션으로 바뀌어요. 액션 탭에서 새로 추가를 눌러 모든 액션의 오버레이 탭을 열고 다음을 추가하세요:

• Win Counter — Wins Up, Wins Down, Wins Set 또는 Wins Set To Goal;
• Team Score — 팀 1 (왼쪽) 또는 팀 2 (오른쪽)에 점수 추가, 점수 차감, 점수 설정 중 하나, 또는 양 팀 점수 초기화;
• Death Counter — 사망 추가, 사망 빼기, 카운트 설정 또는 카운트 초기화.

각 액션은 대상 위젯 하나를 가리키고, 그 위젯의 토글이 무엇이 바뀔지 결정해요:

• 게임 승리 수/목표 사용(Win Counter), 게임 점수 사용(Team Score) 또는 게임 카운트 사용(Death Counter) 켜짐 — 액션이 모드의 공유 카운터를 바꾸고, 토글이 켜진 모든 위젯이 그 값을 보여 줘요. GTA V와 RDR2에서 공유 승리 카운터는 게임 자체의 승리 횟수예요.
• 토글 꺼짐 — 액션은 해당 위젯 자체의 카운터만 바꿔요.

오버레이에 해당 유형의 위젯이 아직 없으면 액션은 공유 카운터를 바꿔요. 대상 위젯이 삭제되었다면 액션은 아무것도 하지 않으니 다른 위젯을 선택하세요. 에디터에서 위젯의 필드에 숫자를 직접 입력할 수도 있어요. TABS Battle에서는 각 진영의 승리가 공유 Team Score에 자동으로 반영돼요.

게임에서 가져오는 체력, 사망 수, 거리

게임 섹션의 위젯 세 개는 숫자를 게임에서 직접 가져와요:

위젯 추가에는 게임이 해당 숫자를 보고하는 경우에만 각 위젯이 나타나요.

• 모양. Health Bar는 바, 세그먼트, 하트, 링, 숫자, 심박 모니터 중에서 고를 수 있어요. Finish Distance는 텍스트("Distance: 100 m"), 진행 바, 도로, 링, 내비게이션 중에서 고를 수 있어요. Death Counter는 숫자, 해골 줄, 바를 정 표시, 목숨, 회전식 카운터, WASTED 배너, 묘비 중에서 고를 수 있어요. 바와 도로는 방향 설정으로 세로로 바꿀 수 있어요. … 스타일 선택에서는 각각에 맞게 미리 만들어진 모양을 제공해요.
• 원하는 문구. 모든 라벨을 직접 정할 수 있어요. 숫자 주변의 텍스트, START와 FINISH, 배너, 묘비, 게임 오버 텍스트가 모두 해당돼요. Finish Distance에서는 {remaining}, {traveled}, {total}, {percent} 변수를 쓸 수 있어요. 거리는 미터와 킬로미터 또는 피트와 마일로 표시되고, 원하면 단위 라벨도 직접 정할 수 있어요. Death Counter에서는 {deaths}, {lives} 변수를 쓸 수 있어요.
• 결승. 결승점에 도달할 때마다 바가 잠시 가득 찬 채로 유지되고, 위젯이 튀어 오르며, 결승 깃발에서 색종이, 결승 깃발 또는 반짝이가 터져 나와요. 효과는 결승 효과에서 고를 수 있고, 결승 축하로 이 연출을 끌 수도 있어요. 결승 사운드도 재생할 수 있어요.
• 사망 수. 캐릭터가 죽을 때마다 게임이 사망 수를 하나씩 더해요 — Train Auto에서는 기차가 부서질 때마다요. 카운트는 위젯 패널에서 카운트 초기화를 누르거나 Death Counter 액션을 실행할 때까지 유지돼요. 게임 카운트 사용을 끄면 위젯은 자체 액션이 더한 값만 집계해요.
• 사망. 죽을 때마다 중앙에서 붉은 섬광이 퍼져 나가고, 위젯이 흔들리며, 숫자에서 아이콘, 반짝이 또는 하트가 터져 나와요. 무엇이 나올지는 사망 효과에서 고를 수 있어요. 나머지 연출은 사망 시 붉은 섬광과 사망 시 흔들림으로 끌 수 있고, 사망 사운드도 재생할 수 있어요.
• 게임이 없을 때. 게임이 연결되기 전까지 에디터에는 샘플 값이 표시돼요. OBS에서는 데이터가 없는 위젯이 자동으로 숨겨져요. 빈 게이지를 화면에 유지하려면 게임 데이터가 없을 때(Finish Distance에서는 경로가 없을 때)를 빈 게이지 표시로 설정하세요.

KOTH와 KOTH Auto에서는 God Mode가 기본적으로 켜져 있어서 Health Bar가 항상 가득 차 있어요. 체력이 실제로 영향을 주길 원하면 F11에서 끄세요. 숫자는 게임 안에서 실행되는 모드가 보내 줘요. 플레이 중에 이 위젯들이 계속 비어 있다면 Mod 관리에서 모드를 업데이트하세요.

이미지와 동영상

Image 위젯에 쓸 사진은 내 이미지(직접 업로드한 파일), TikTok 선물 또는 Kick 선물에서 가져와요.

• 업로드: PNG, JPEG, WebP, GIF 또는 APNG, BakoshApp이 압축하기 전 기준으로 파일당 최대 30MB예요. 애니메이션 파일은 원본 그대로 업로드되며 10MB 이내여야 해요.
• 동영상: WebM(VP9) 또는 MP4(H.264), 최대 10 MB, 기본적으로 음소거돼요. 에디터에서는 동영상이 항상 음소거로 재생되고, OBS에서는 소리가 나와요.
• 이미지와 동영상은 각각 별도의 저장 공간을 가져요: Free는 25MB, PRO와 MAX는 250MB예요.

자주 묻는 질문

오버레이에 "Overlay unavailable"이 표시돼요. 오버레이가 BakoshApp에 연결하지 못해요: 앱이 실행 중이 아니거나 로그인되어 있지 않은 거예요. 앱을 시작하고 로그인하세요 — 오버레이가 알아서 다시 연결돼요.

오버레이에 "No mode selected"가 표시돼요. BakoshApp에서 켜진 모드가 없는 거예요. 모드를 하나 켜면 오버레이가 그 레이아웃을 보여 줘요.

오버레이에 "Browser is blocking the overlay"가 표시돼요. Chrome이나 Edge에서 링크를 열었는데 브라우저가 앱에 접근하도록 허용하지 않은 거예요. 주소창 왼쪽의 아이콘을 클릭하고 Apps on device를 허용하세요.

알림이 나타나지 않아요. 알림에는 PRO나 MAX, 그리고 네이티브 커넥터나 Kick에서 오는 이벤트가 필요해요. 알림의 필터를 확인한 다음 데모를 눌러 보세요.

OBS에서 순위표가 비어 있어요. 시청자가 네이티브 커넥터나 Kick을 통해 선물, 좋아요, 메시지를 보내면 채워져요. 그때까지는 자리에 대시가 표시돼요.

OBS에서 Health Bar나 Finish Distance가 표시되지 않아요. 게임이 숫자를 보내면 나타나요. 게임을 시작해 로딩을 마친 다음 BakoshApp에서 모드를 켜세요. Finish Distance는 도달해야 할 결승점이 있을 때만 나타나요. 그래도 표시되지 않으면 Mod 관리에서 모드를 업데이트하세요.

Health Bar, Finish Distance 또는 Death Counter가 "위젯 추가"에 없어요. 이 모드의 게임이 해당 숫자를 보고하지 않기 때문이에요. 예를 들어 TABS Battle이 그렇고, Train Auto, Rust, Minecraft에서는 거리가 그래요. 커스텀 통합에서는 Death Counter만 추가할 수 있어요.

실수로 위젯을 삭제했어요. Ctrl+Z를 누르세요.

관련 문서

• Action Board
• Bakosh Avatar
• 프리셋
• 시청자
• 커스텀 통합
• 네이티브 커넥터