본문으로 이동

이미지 오버레이

설정하러 가기

명령어나 후원 메시지에 맞춰 내 이미지와 기본 효과를 방송 화면에 띄워요.

목차

특정 명령어를 쓰거나 정해 둔 말이 포함된 후원이 오면 내 이미지를 방송 화면에 띄워요. 위젯 · 미니게임 › 이미지 오버레이에서 만들어요.

참고
잼쿠봇 등록 채널 전용

대시보드에서 봇 입장을 켜야 주소를 만들고 사용할 수 있어요. 봇 입장을 끄거나 등록이 만료되면 오버레이도 중단돼요.

이미지와 반응 조건 만들기

  1. 처음에는 규칙이 없는 상태로 시작해요. 쓰다듬기, 물음표, 내 이미지 중 원하는 버튼을 눌러 첫 규칙을 만들어요.
  2. 언제 반응하나요?를 고르고 반응할 텍스트를 적어요. 여러 개는 한 줄에 하나씩 넣어요. 내 이미지는 텍스트도 직접 입력해요.
  3. 표시 시간과 크기를 정해요. 위치, 반복 대기 시간(쿨타임), 음량은 세부 설정을 펼쳐 조절해요.
  4. 이 규칙 미리 재생으로 확인하고 설정 저장을 눌러 이 브라우저에 보관해요.
  5. 주소 복사로 OBS에 연결해요. 파일로 연결하려면 파일로 연결하기를 펼쳐 OBS용 HTML 다운로드를 눌러요.

한 주소에 규칙을 최대 8개 넣을 수 있어요. 필요 없는 규칙은 삭제로 지워요. 여러 규칙이 동시에 맞으면 화면에 하나씩 도착한 순서대로 표시돼요. 대기열이 가득 차면 새 반응을 건너뛰어요.

이미지만 바꾸려면 해당 규칙을 펼쳐 이 규칙의 이미지에서 바꿔요. 기존 반응 조건은 유지돼요. 반응 규칙 하나 더 추가의 버튼은 별도 규칙을 만들며, 목록에 있는 모든 규칙이 OBS에서 동작해요.

기본 이미지

선택 기본 반응 효과
쓰다듬기 채팅이 !쓰담과 정확히 일치 v2의 쓰다듬기 GIF, 기본 크기 100%
물음표 채팅이 ?와 정확히 일치 v2의 투명 물음표 영상(화면 전체), 기본 크기 100%, 음량 35%, 쿨타임 7초

기본 이미지도 다른 명령어나 후원 메시지에 연결할 수 있어요. 기본 이미지는 잼쿠봇 서버의 파일을 그대로 쓰므로 오버레이 주소에 이미지가 담기지 않아 주소가 짧아요. 물음표는 v2처럼 1920 × 1080 영상 전체를 화면에 띄워요. 영상은 끝나거나 표시 시간이 지나면 사라져요. GIF는 표시 시간 동안 움직여요.

내 이미지

내 이미지 파일을 고르고 컴퓨터에 있는 파일을 선택해요. PNG·JPG·GIF·WebP·AVIF·APNG·WebM을 지원하고 파일당 1MB까지 쓸 수 있어요. GIF 애니메이션과 투명 배경도 그대로 사용해요.

이미지 파일은 브라우저에서만 읽어서 오버레이 주소에 넣어요. 서버에 업로드하거나 저장하지 않아요. OBS는 주소에 담긴 이미지로 표시하므로 원본 파일을 옮기거나 지워도 저장된 주소는 동작해요.

주소에는 이미지 전체가 들어 있어서 길어질 수 있어요. 긴 주소는 OBS용 HTML 다운로드로 연결해요. 전체 주소도 담을 수 없는 용량이면 더 작은 파일로 바꾸거나 규칙을 줄여요. 같은 이미지를 여러 규칙에서 쓰면 주소에 한 번만 담겨요.

반응 종류

종류 언제 반응하나요?
채팅을 보냈을 때 치지직 채팅 내용과 비교해요. 잼쿠봇 명령어로 등록하지 않은 텍스트도 사용할 수 있어요
봇 명령어가 실행됐을 때 봇이 실제 처리한 명령어의 등록 이름과 비교해요. 성공했을 때만 반응을 켜면 포인트 부족이나 쿨타임 실패에는 이미지가 뜨지 않아요
후원 메시지가 왔을 때 치지직 치즈 후원 메시지와 비교해요. 최소·최대 금액을 같이 정할 수 있어요

입력한 말과 정확히 일치는 앞뒤 공백을 제외한 내용이 같은 경우예요. 입력한 말이 포함되면은 글 안에 해당 텍스트가 있으면 반응해요. 봇 명령어 실행은 등록한 명령어 이름과 정확히 비교해요.

예를 들어 후원 규칙에 쓰담을 적고 입력한 말이 포함되면으로 설정하면 오늘도 쓰담쓰담!이 포함된 후원에 이미지가 떠요. 최소 금액을 1,000으로 정하면 1,000치즈 이상일 때만 반응해요. 금액 0은 해당 금액 제한을 사용하지 않는다는 뜻이에요.

크기와 표시 시간

설정 범위 동작
표시 시간 0.2~60초 이미지가 머무르는 시간. 영상은 재생이 끝나면 먼저 사라져요
반복 대기 시간 (쿨타임) 0~3,600초 반응한 시점부터 같은 규칙의 새 반응을 무시해요. 0이면 들어온 반응을 순서대로 표시해요
크기 화면 너비의 1~100% OBS 브라우저 소스 너비를 기준으로 이미지 크기를 정해요. 기본값은 100%예요
가로·세로 위치 0~100% 이미지 중심 위치. 둘 다 50이면 화면 중앙이에요
영상 음량 0~100% 영상 소리. 0은 음소거예요

규칙 제목을 누르면 해당 설정을 펼치고 미리보기도 바뀌어요. 체크 배경은 투명 영역이에요. 이 규칙 미리 재생은 이 화면에서만 재생하며, OBS에는 영향을 주지 않아요.

OBS에 추가하고 다시 수정하기

  1. 주소 복사를 눌러요.
  2. OBS에서 브라우저 소스를 추가하고 로컬 파일을 끈 상태로 URL에 붙여 넣어요.
  3. 해당 채팅이나 후원을 보내 반응을 확인해요.

주소가 잘리거나 파일로 연결하고 싶다면 파일로 연결하기를 펼쳐 OBS용 HTML 다운로드를 눌러요. OBS 소스 목록의 + → 브라우저를 추가하고, '브라우저' 속성 창에서 로컬 파일에 체크한 뒤 찾아보기로 다운로드한 HTML 파일을 선택하고 확인을 눌러요. HTML 파일에는 이미지가 담긴 전체 주소가 들어 있어요. OBS에서 파일을 열면 해당 주소로 이동해요. HTML 파일도 브라우저에서 만들어 다운로드하므로 서버에 이미지나 설정이 저장되지 않아요. 다운로드한 파일은 OBS가 계속 읽을 수 있는 곳에 보관해요.

설정 저장을 누르면 이미지와 반응 조건을 이 브라우저에 채널별로 보관해요. 같은 브라우저에서 다시 열면 저장한 설정을 불러와요. 저장하지 않은 변경사항은 다음 방문에 유지되지 않아요. 브라우저 데이터를 지우거나 다른 기기를 사용하면 화면 위쪽의 기존 OBS 주소·HTML 파일 불러오기에서 주소를 붙여 넣거나 HTML 파일을 선택해요. 불러온 설정은 현재 규칙 목록을 대체해요.

설정 저장만으로 OBS가 바뀌지는 않아요. OBS는 연결 파일·주소에 담긴 설정을 사용하므로, 수정한 뒤 HTML을 다시 다운로드해 OBS에서 선택하거나 새 주소로 교체해요. 같은 경로의 HTML을 덮어썼다면 OBS 브라우저 소스를 새로고침해요. 브라우저 저장 공간이 부족하면 HTML 파일을 보관해 두었다가 불러올 수 있어요.

주소에는 채널 구독 토큰도 포함돼요. 다른 사람에게 공유하지 마세요.

잘 안 될 때

상황 확인할 것
잼쿠봇 등록 안내가 나와요 대시보드에서 봇 입장을 켠 뒤 등록 상태 다시 확인을 눌러요
채팅에 반응하지 않아요 텍스트 비교 방식과 글자를 확인해요. ?의 정확히 일치는 ??나 왜?에 반응하지 않아요
봇 명령어에만 반응이 없어요 봇에 등록한 이름을 적었는지, 명령어 실행이 성공했는지 확인해요
후원에 반응하지 않아요 메시지에 조건 텍스트가 있는지, 금액 범위에 맞는지 확인해요
OBS에 주소를 넣었는데 잘리거나 이미지가 안 보여요 OBS용 HTML 다운로드를 눌러 브라우저 소스의 로컬 파일로 연결해요
전체 이미지를 담기엔 용량이 너무 크다고 해요 파일 용량이나 규칙 수를 줄여요
효과가 너무 자주 나와요 세부 설정에서 반복 대기 시간을 늘려요
물음표 소리를 끄고 싶어요 해당 규칙의 영상 음량을 0으로 정해요
봇을 끈 뒤 멈췄어요 등록 상태를 주기적으로 확인해 중단해요. 봇 입장을 다시 켜고 OBS 브라우저 소스를 새로고침해요

이 가이드로 해결이 안 됐나요?

디스코드로 문의하기

명령어, 룰렛, OBS처럼 궁금한 걸 검색해 보세요.