🌌 Milkyway Bot 사용 설명서

방송에 밀키웨이 봇 초대 및 권한 부여하기 대시보드 바로가기

소개

Milkyway Bot은 치지직 스트리머를 위한 다기능 챗봇입니다. 출석 체크, 커스텀 명령어, 자동 인사말, 디스코드 방송 알림 등 다양한 기능을 제공하여 방송을 더 편리하고 재미있게 만들어줍니다.

기본 명령어 접두사는 ! 입니다. (스트리머가 변경할 수 있습니다)

제작자 : 별아레

피드백 환영!

💡 처음 봇을 설정하신다면?

방송에 봇을 초대한 뒤 아래 순서대로 설정하시면 바로 활용할 수 있습니다.

  1. 인사말 등록을 먼저 해주세요. 시청자가 채팅창에 인사를 입력하면 봇이 자동으로 반응하며 출석 체크도 함께 처리됩니다.
    !인사등록 안녕하세요 어서오세요!
  2. 필요에 따라 커스텀 명령어를 추가해 방송 규칙, 일정 등을 안내하세요.
    !명령어등록 규칙 채널 규칙입니다.
  3. 디스코드 알림을 원하신다면 !알림설정으로 연동하세요.

기본 명령어 (모든 사용자)

!출석
현재 진행 중인 방송에 출석 체크를 합니다. 연속 출석과 총 출석 횟수가 기록됩니다.
!명령어
봇에 등록된 모든 기본 명령어 목록을 보여줍니다.
!채널명령어
현재 채널에 스트리머가 직접 등록한 명령어 목록을 보여줍니다.
!인사목록
현재 채널에 등록된 모든 인사말 키워드를 보여줍니다.

관리자 명령어 (스트리머/매니저)

공통 규칙

|, [닉네임]
입력 별칭: 명령어 또는 인사말 키워드에 |를 넣으면 여러 입력을 하나로 묶을 수 있습니다.
  !명령어등록 규칙|룰 채널 규칙입니다.!규칙, !룰 모두 동일하게 응답
  !인사등록 안녕|하이|ㅎㅇ 어서오세요! → '안녕', '하이', 'ㅎㅇ' 중 하나라도 포함되면 반응
랜덤 응답: 명령어 또는 인사말 응답에 |를 넣으면 그 중 하나를 랜덤으로 출력합니다.
  !인사등록 안녕 어서오세요!|반갑습니다!|환영합니다!
닉네임 치환: 응답에 [닉네임]을 넣으면 채팅을 입력한 시청자 닉네임으로 바뀝니다.
  !인사등록 안녕 어서오세요 [닉네임]님!
추가 치환자: 일부 대시보드 입력란에서는 출석 관련 치환자 등 더 많은 치환자를 사용할 수 있습니다. 사용할 수 있는 치환자는 대시보드의 각 설명란에서 확인해주세요.

명령어 관리

!명령어등록 [명령어] [응답] 관리자용
새로운 채널 명령어를 등록합니다. 이미 등록된 명령어를 다시 등록하면 응답이 수정됩니다.
!명령어삭제 [명령어] 관리자용
등록된 채널 명령어를 삭제합니다.

인사말관리

!인사등록 [키워드] [응답] 관리자용
채팅에 특정 키워드가 포함되면 봇이 자동으로 응답합니다. 이미 등록된 키워드를 다시 등록하면 응답이 수정됩니다.
치지직 이모티콘은 인사말 키워드에 등록할 수 있지만, 응답 내용에는 포함할 수 없습니다.
※ 동일 키워드는 10초 쿨타임이 적용됩니다. 채널당 최대 30개까지 등록할 수 있습니다.
!인사삭제 [키워드] 관리자용
등록된 인사말 키워드를 삭제합니다.

봇 설정

!접두사수정 [새 접두사] 관리자용
명령어 접두사를 변경합니다. 허용되는 접두사는 !, @, #, $, %, ^, &, * 입니다.

채팅 공지

!공지 [내용] 관리자용
채팅창에 공지사항을 등록합니다. 내용에 해당하는 메시지가 치지직 채팅 공지로 설정됩니다.

디스코드 알림

!알림설정 [디스코드채널ID] 관리자용
방송 시작 알림을 받을 디스코드 채널을 설정합니다.
설정 방법:
1. [디스코드 봇 초대 링크 바로가기]를 클릭하여 봇을 디스코드 서버에 초대해주세요.
2. 알림을 받을 채널에 마우스 우클릭 후 'ID 복사하기'를 눌러 채널 ID를 확인합니다.
3. 치지직 채팅창에 !알림설정 [복사한 ID]를 입력합니다.
!알림삭제 관리자용
설정된 디스코드 방송 알림을 해제합니다.

채팅 오버레이

대시보드에서 OBS 브라우저 소스용 채팅 오버레이 링크를 만들고, 방송 화면에 표시될 채팅창 디자인을 직접 조정할 수 있습니다.

대시보드 > 채팅 오버레이
글자 크기, 채팅창 폭, 여백, 말풍선 모양, 색상, 애니메이션, 메시지 유지시간을 옵션으로 설정할 수 있습니다. CSS를 몰라도 기본 옵션만으로 바로 사용할 수 있으며, 설정 후 적용을 누르면 미리보기와 실제 오버레이에 반영됩니다.
미리보기와 OBS 링크
샘플 모드에서는 닉네임과 채팅 내용을 직접 입력해 디자인을 확인할 수 있습니다. 현재 채팅 모드에서는 실제 채팅 표시 상태를 확인할 수 있으며, 복사한 오버레이 링크를 OBS의 브라우저 소스 URL에 넣으면 방송 화면에 채팅이 표시됩니다.
프리셋과 고급 CSS
마음에 드는 설정은 프리셋으로 저장하고 다시 불러올 수 있습니다. 이미지 스킨이나 세부 디자인을 직접 다듬고 싶다면 고급 CSS 모드를 사용할 수 있습니다. 스킨이 없어도 기본 CSS로 정상 동작합니다.
스킨용 주요 클래스:
.chat-frame: 채팅창 프레임/배경 이미지
.chat-list: 메시지 영역 여백/클리핑
.chat-message: 말풍선 이미지와 개별 메시지
.chat-name, .chat-text: 닉네임과 채팅 본문
필터와 링크 관리
특정 닉네임을 오버레이에서 숨기거나, 스트리머/관리자 역할의 채팅을 필터링할 수 있습니다. 오버레이 링크는 채널 기준 고정 주소이므로 OBS에 한 번 등록하면 계속 사용할 수 있습니다.