본문으로 이동

채팅 아바타

설정하러 가기

시청자 채팅을 방송 화면 속 아바타로 띄워요. 봇 없이 로그인만 하면 돼요.

목차

시청자가 채팅을 치면 방송 화면 아래쪽에 그 사람의 아바타가 나타나 돌아다니면서 말풍선으로 채팅을 보여줘요. 채팅 아바타 페이지에서 치지직 로그인만 하면 바로 써요.

참고
잼쿠봇을 채널에 들이지 않아도 돼요

봇과 따로 돌아가는 방송 도구예요. 치지직과 숲 채팅을 한 화면에 같이 띄우고, 시청자는 !점프 같은 채팅으로 자기 아바타를 움직여요. 아바타 그림도 내 그림으로 바꿔요.

시작하기

  1. 채팅 아바타에서 치지직으로 로그인을 눌러 방송하는 계정으로 로그인해요. 로그인이 끝나면 같은 페이지로 돌아와요.
  2. 연결 · 오버레이 카드에서 치지직 채팅 아바타가 켜져 있는지 봐요. 처음부터 켜져 있어요.
  3. 숲에서도 방송한다면 숲 채팅 아바타를 켜고 숲 방송국 아이디를 넣어요.
  4. 화면 아래에 붙어 있는 설정 저장을 눌러요.
  5. OBS 브라우저 소스 URL 옆 복사를 누르고 방송 화면에 띄우기대로 OBS에 넣어요.
  6. 내 채널 채팅에 아무 말이나 쳐서 아바타가 나오는지 확인해요.

바꾼 설정은 설정 저장을 눌러야 반영돼요. 저장하면 OBS를 새로 고치지 않아도 방송 화면에 바로 적용돼요. 저장되면 설정 저장됨 알림이 떠요.

치지직은 로그인한 계정의 채널만 연결돼요. 다른 채널 채팅을 띄우려면 그 채널 계정으로 로그인하세요.

숲 방송국 아이디 찾기

숲 방송국 주소가 https://www.sooplive.co.kr/station/example이면 example이 아이디예요. 오버레이가 숲 채팅에 직접 붙어서 채팅과 별풍선을 아바타로 보여줘요.

숲은 방송이 켜져 있을 때만 연결돼요. 꺼져 있는 동안엔 10초마다 다시 시도하니까, 숲 방송을 켜면 따로 누를 것 없이 붙어요.

방송 화면에 띄우기

  1. 연결 · 오버레이 카드의 OBS 브라우저 소스 URL 옆 복사를 눌러요.
  2. OBS 소스 목록 + → 브라우저를 고르고 URL 칸에 붙여 넣어요.
  3. 너비·높이는 방송 화면 크기(예: 1920×1080)로 맞추고 화면 전체에 깔아요. 아바타는 소스의 맨 아래를 바닥 삼아 걸어 다녀요.

복사한 주소에는 채널 공통 토큰이 들어 있어요. 방송 화면이나 채팅, 캡처에 주소가 보이지 않게 하세요. 새어 나갔다면 대시보드의 오버레이 주소 · 접근 관리에서 재발급하고 사용하는 주소를 다시 복사하세요.

아바타를 마우스로 옮기기

OBS에서 브라우저 소스를 오른쪽 클릭하고 상호작용 창을 열면 아바타를 마우스로 다룰 수 있어요.

  • 아바타를 끌어서 옮겨요. 끌던 방향으로 휙 놓으면 그 속도로 날아가요.
  • 끄는 중에 스페이스바를 누르면 그 자리 공중에 멈춰요. 다시 끌었다 놓으면 풀려요.
  • 벽 충돌 시 튕김이 켜져 있으면 던진 아바타가 벽에 맞고 튕겨 나와요. 끄면 벽에서 멈춰요.

표시 설정

표시 설정 아래 카드 네 개에서 정해요. 괄호 안은 처음 값과 넣을 수 있는 범위예요.

크기 · 표시

항목 설명
최대 아바타 수 화면에 동시에 있을 수 있는 아바타 수 (15, 1~200). 꽉 차면 가장 오래 조용했던 아바타가 새로 채팅한 시청자 이름으로 바뀌어요
아바타 크기(px) 아바타 그림 크기 (80, 10~500)
닉네임 폰트(px) 닉네임 글자 크기 (12, 1~200)
말풍선 폰트(px) 말풍선 글자 크기 (12, 1~200)
벽 충돌 시 튕김 던진 아바타가 벽에서 튕겨요 (켜짐)
닉네임 숨기기 아바타 위 닉네임을 숨겨요 (꺼짐)
닉네임 배경 표시 닉네임 뒤에 배경색을 깔아요 (켜짐)
명령어 메시지 숨기기 (!로 시작) !로 시작하는 채팅과 움직임·변신 명령어를 말풍선에 띄우지 않아요. 아바타는 그대로 나오고 명령어도 돼요 (켜짐)

말풍선은 5초 동안 떠요. 후원은 금액과 후원 메시지가 후원 말풍선 색으로 10초 동안 떠요. 글이 길면 4줄까지만 보여요.

숲의 기본·구독·스트리머 시그니처 이모티콘과 OGQ 스티커도 말풍선에 보여요. 움직이는 OGQ도 지원해요. 이미지를 불러오지 못하면 이모티콘 이름이 남고, Gem은 [Gem 이모티콘]으로 표시돼요.

색상 · 폰트

항목 설명
말풍선 배경 / 말풍선 글자 채팅 말풍선의 바탕색 (흰색) / 글자색 (검정)
후원 말풍선 후원했을 때 말풍선 바탕색 (#FFDFBA)
닉네임 배경 / 닉네임 글자 닉네임 바탕색 (검정) / 글자색 (흰색). 바탕색은 닉네임 배경 표시가 켜져 있을 때만 보여요
닉네임 폰트 / 말풍선 폰트 글꼴 33종 중에서 골라요. 처음엔 배달의민족 주아체, 기본 (프리텐다드)를 고르면 프리텐다드
닉네임 Y 오프셋(px) / 말풍선 Y 오프셋(px) 숫자가 클수록 닉네임·말풍선이 위로 올라가요 (0, -100~500)

표시 시간

채팅 말풍선(초) / 후원 말풍선(초)은 아바타 위 말풍선이 떠 있는 시간이에요. 처음엔 채팅 5초, 후원 10초이고 0.5초부터 600초까지 0.5초 단위로 넣을 수 있어요. 말풍선이 떠 있는 동안 같은 시청자가 또 채팅을 치면 새 내용으로 바뀌고 시간이 처음부터 다시 흘러요.

일정 시간 후 사라짐이 켜져 있으면 아바타 타임아웃(초) 동안 채팅이 없던 아바타가 화면에서 사라져요. 처음엔 켜져 있고 300초(5분)예요. 1초부터 86400초(24시간)까지 넣을 수 있어요.

끄면 아바타가 계속 남아 있다가, 최대 아바타 수가 차면 오래 조용했던 순서로 새 시청자에게 넘어가요. 후원 말풍선이 떠 있는 동안엔 사라지지도, 넘어가지도 않아요.

제외 시청자

아바타를 띄우지 않을 닉네임 (쉼표 구분) 칸에 넣은 닉네임은 채팅을 쳐도 아바타가 안 나와요. 봇 계정처럼 화면에 띄우기 싫은 닉네임을 넣으세요. 영문 대소문자는 가리지 않아요. 저장하면 이미 떠 있던 그 시청자의 아바타도 바로 사라져요.

시청자는 이렇게 움직여요

시청자가 아래 채팅을 치면 자기 아바타가 움직여요. 아직 아바타가 없던 시청자면 그 채팅으로 나타나면서 바로 움직여요.

!점프
동작 처음 명령어 하는 일 설정 (처음 값)
점프 !점프, !jump 바닥에 있을 때 한 번 뛰어올라요. 높이는 최소~최대 높이 사이에서 무작위 최소 높이 200, 최대 높이 300 (0~5000)
달리기 !달리기, !run 무작위 방향으로 빠르게 달려요. 벽에 닿으면 방향을 꺾어요 속도 배수 5 (걷는 속도의 5배, 0.1~50), 지속(초) 5 (1~600)
날기 !비행, !fly 위로 날아올랐다가 시간이 끝나면 떨어져요 지속(초) 5 (0.1~600), 상승 속도 2 (0.1~50)
숨기 !숨기, !hide 아바타를 숨겨요. !숨기를 한 번 더 치거나 일반 채팅을 치면 다시 나와요 없음

카드마다 점프 활성화처럼 끄는 스위치가 있어요. 명령어 (쉼표 구분) 칸에서 명령어 이름을 바꾸거나 !점프, !jump, !뛰어처럼 더 넣을 수 있어요.

채팅 전체가 명령어와 똑같아야 움직여요. !점프 ㅋㅋ처럼 뒤에 글이 붙으면 안 돼요. 영문 대소문자는 가리지 않아서 !JUMP도 돼요.

주의
숨기는 '명령어 메시지 숨기기'가 켜져 있어야 돼요

이 설정을 끄면 !숨기 채팅이 말풍선으로 뜨면서 아바타가 바로 다시 나타나요. 숨기를 쓸 거면 명령어 메시지 숨기기 (!로 시작)를 켜 두세요. 처음엔 켜져 있어요.

잼쿠봇 명령어와는 따로 움직여요. 오버레이가 채팅을 직접 읽어서 동작하니까 봇이 없어도 돼요. 같은 이름의 잼쿠봇 명령어가 있으면 봇은 봇대로 대답해요.

내 그림으로 아바타 만들기

커스텀 아바타 › 아바타 목록 칸에 아바타를 JSON으로 적어요. 최대 8종이에요. 비워 두거나 켜진 아바타가 없으면 기본 아바타 4종 중 하나가 나와요. 목록이 그대로면 같은 시청자는 늘 같은 아바타로 나와요.

[
  {
    "id": "cat",
    "name": "고양이",
    "isActive": true,
    "images": {
      "stand": "가만히 있을 때 그림 주소",
      "walk": "걸을 때 그림 주소",
      "fall": "공중에 있을 때 그림 주소",
      "drag": "끌려갈 때 그림 주소",
      "dance": "변신용 그림 주소"
    }
  }
]
키 설명
id 아바타를 구분하는 이름. 겹치지 않게 지어요. 지정 아바타에서 이 값으로 골라요
name (빼도 돼요) 지정 아바타 목록에 보일 이름
isActive false면 무작위 배정에서 빠져요. 지정 아바타로는 줄 수 있어서 특정 시청자 전용으로 둘 때 써요
images.stand 가만히 서 있을 때. 꼭 넣으세요. 다른 그림이 비어 있으면 이 그림을 써요
images.walk 걷거나 달릴 때
images.fall 공중에 있을 때 (점프·날기·던져졌을 때)
images.drag 마우스로 끌고 있을 때
images.상태 이름 변신 명령어가 보여줄 그림
flip (빼도 돼요) 그 상태의 그림을 좌우로 뒤집어요. 예: "flip": {"walk": true}

그림은 오른쪽을 보게 그리세요. 아바타가 왼쪽으로 움직일 때는 저절로 뒤집혀요. 왼쪽을 보는 그림이면 flip으로 그 상태를 뒤집으세요.

쉼표·따옴표가 하나라도 틀리면 저장이 안 돼요. 목록 아래에 아바타 목록 JSON 오류가 뜨면 그 부분을 고치세요.

그림 올리기

  1. JSON에서 주소가 들어갈 따옴표 사이를 클릭해 커서를 놓아요.
  2. 이미지 업로드를 눌러 파일을 골라요. png·jpg·jpeg·gif·webp를 올릴 수 있어요.
  3. 올린 그림 주소가 옆 칸에 나오고, JSON의 커서 자리에도 들어가요.
  4. 설정 저장을 눌러요.

인터넷에 공개된 그림이면 그 주소를 그대로 적어도 돼요. 3MB를 넘는 그림은 서버가 크기를 줄여서 올려요. GIF는 움직임을 살린 채 줄이고, 나머지는 JPG로 바꿔요.

주의
3MB 넘는 PNG는 투명한 부분이 흰색이 돼요

JPG로 바뀌면서 투명 배경이 흰색으로 채워져요. 배경이 비쳐야 하는 그림은 3MB 아래로 줄여서 올리세요.

올린 그림을 지우려면 그 주소(/chat_avatars/custom_imgs/로 시작)를 이미지 업로드 옆 칸에 넣고 삭제를 눌러요. 내가 올린 그림만 지워져요. JSON에 남은 주소는 직접 지우세요. 지운 그림을 쓰던 아바타는 기본 아바타로 나와요.

변신 명령어

시청자가 정해 둔 채팅을 치면 그 아바타를 몇 초 동안 다른 그림으로 바꿔요. 변신 명령어 카드에서 명령어 추가를 눌러 5개까지 만들어요.

항목 설명
상태 이름 보여줄 그림의 이름. 아바타 JSON images에 같은 이름의 키가 있어야 해요. 예: dance
지속(초) 변신이 유지되는 시간 (5, 1~999)
활성 끄면 이 변신만 멈춰요
트리거 (쉼표 구분) 시청자가 칠 채팅. 예: !춤, !dance
이동속도 배율 변신 중 걷는 속도 배율. 0이면 그대로예요 (0, 0~99)
점프 켜면 변신하자마자 옆 칸 힘으로 한 번 뛰어요. 처음 값은 점프 카드의 최소 높이. 점프 카드를 꺼 둬도 돼요
비행 켜면 변신하는 동안 옆 칸 속도로 날아올라요. 처음 값은 날기 카드의 상승 속도

트리거도 위 움직임 명령어처럼 채팅 전체가 똑같아야 해요. 필요 없는 줄은 삭제로 빼요. 다 고쳤으면 설정 저장을 눌러요.

그 상태 그림이 없는 아바타는 모양이 안 바뀌어요. 점프·비행·속도만 적용돼요. 상태 이름은 영문 대소문자까지 images의 키와 같아야 해요.

특정 시청자에게 아바타 고정하기

지정 아바타 카드에서 시청자 닉네임을 적고 아바타를 고른 뒤 추가를 눌러요. 그리고 설정 저장을 눌러요. 그 시청자는 늘 고른 아바타로 나와요.

  • 아바타 목록에는 JSON에 id가 있는 아바타만 나와요. JSON을 고치면 목록도 바로 바뀌어요.
  • isActive가 false인 아바타도 줄 수 있어요. 그 시청자 전용 아바타가 돼요.
  • 닉네임은 띄어쓰기·대소문자까지 똑같이 적어야 해요. 시청자가 닉네임을 바꾸면 다시 지정하세요.
  • JSON에서 지운 아바타를 가리키면 목록에 (없는 아바타 id: …)로 보이고, 그 시청자는 무작위 아바타로 나와요.

안 될 때

이럴 때 확인할 것
아바타가 하나도 안 나와요 치지직 채팅 아바타가 켜져 있는지, OBS 소스가 켜져 있는지, 주소를 끝까지 복사했는지 봐요
방송 화면에 "대시보드에서 OBS 주소를 다시 복사해주세요."가 떠요 주소의 토큰 부분이 빠졌어요. 복사로 다시 받아 넣으세요
방송 화면에 "오버레이 설정을 불러오지 못했습니다. 대시보드에서 주소를 확인해주세요."가 떠요 주소가 잘렸거나 틀렸어요. 다시 복사해 넣으세요
숲 채팅만 안 나와요 숲 채팅 아바타를 켜고 저장했는지, 아이디가 방송국 주소의 그 값인지, 숲 방송이 켜져 있는지 봐요
특정 시청자만 안 나와요 제외 시청자에 그 닉네임이 있는지 봐요
내 그림 대신 기본 아바타가 나와요 그림 주소를 브라우저 새 탭에서 열어 봐요. 안 열리면 주소가 틀렸거나 지운 그림이에요. stand가 비었거나 모든 아바타가 "isActive": false여도 그래요
변신해도 그림이 안 바뀌어요 상태 이름과 images 키가 글자 하나까지 같은지 봐요
!숨기가 안 먹혀요 명령어 메시지 숨기기 (!로 시작)를 켜요
명령어를 쳐도 안 움직여요 그 동작의 활성화가 켜져 있는지, 채팅에 다른 글자가 붙지 않았는지 봐요. 점프는 바닥에 있을 때만 돼요
저장했는데 안 바뀌어요 설정 저장됨 알림이 떴는지, 아바타 목록 아래에 JSON 오류가 떠 있지 않은지 봐요

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

디스코드로 문의하기

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