빠른 시작 가이드
내가 원하는 명령어를 만들 수 있어요. 채팅창에서 바로 추가하거나 대시보드에서 관리하세요.
명령어 추가하기
새로운 명령어를 만들어보세요.
!추가 · !수정 · !제거 는 매니저 이상만 쓸 수 있어요.
권한이 없으면 봇이 오류 없이 그냥 무시해요. 권한 부여 방법 →
!추가 [명령어] [응답 메시지]#1초새로운 커스텀 명령어를 추가해요.
!추가 !인사 안녕하세요! 반갑습니다 :>'!인사' 명령어가 추가되었습니다.이제 누군가 !인사를 입력하면 "안녕하세요! 반갑습니다 :>" 가 그대로 출력돼요!
!추가 대신 !등록을 써도 똑같이 동작해요!
기존 명령어에 다른 이름 붙이기
이미 있는 명령어를 다른 이름으로도 부를 수 있어요.
!추가 [새 명령어] &[기존 명령어]#1초기존 명령어를 가리키는 별칭을 만들어요.
!추가 !하이 &!인사'!하이' 명령어가 추가되었습니다.복사본이 아니라 바로가기예요
!하이 는 내용을 베껴 가는 게 아니라 호출될 때마다 !인사 를 찾아서 그 응답을 써요.
!인사를 수정하면!하이도 같이 바뀌어요.!인사를 제거하면!하이는 대상을 못 찾아&!인사라는 글자를 그대로 채팅에 뱉어요.!인사를 비활성화만 하면!하이는 여전히!인사의 응답을 내요. 별칭까지 막으려면!하이도 따로 비활성화하세요.- 권한은 둘 다 통과해야 해요 — 별칭
!하이자신의 권한과 대상!인사의 권한. !추가·!수정·!제거·!설정처럼 명령어·봇 관리용 기본 제공 명령어는 가리킬 수 없어요.!팔로우알림·!도배·!재입장·!퇴장·!연결도 안 돼요. (!업타임·!타이머처럼 그 밖의 기본 제공 명령어는 가리킬 수 있어요)
명령어 수정하기
만든 명령어의 내용을 바꿀 수 있어요.
!수정 [명령어] [새 응답 메시지]#1초기존 명령어의 응답을 수정해요.
!수정 !인사 $nick님 안녕하세요!'!인사' 명령어가 수정되었습니다.!수정 대신 !편집, !변경을 써도 똑같이 동작해요!
명령어 삭제하기
더 이상 필요 없는 명령어를 삭제할 수 있어요.
!제거 [명령어]#1초커스텀 명령어를 삭제해요.
!제거 !인사'!인사' 명령어가 제거되었습니다.!제거 대신 !삭제를 써도 똑같이 동작해요!
랜덤 출력 만들기
여러 응답 중 하나를 무작위로 선택해서 보낼 수 있어요.
!추가 [명령어] [응답1]||[응답2]||[응답3]#1초여러 응답 중 하나를 랜덤으로 출력해요.
!추가 !운세 대길||중길||소길||흉'!운세' 명령어가 추가되었습니다.이제 !운세를 입력하면 대길, 중길, 소길, 흉 중 하나가 랜덤으로 나와요!
랜덤 출력 활용 예시
인사 명령어
!추가 !인사 안녕하세요!||반갑습니다!||어서오세요!||환영합니다!
음식 추천
!추가 !뭐먹지 치킨 어때요?||피자 추천!||햄버거 고고!||한식으로 가시죠!
확률 게임
!추가 !복권 $nick님이 당첨!||$nick님 꽝이에요...
조건부 출력 (삼항 연산자)
특정 조건에 따라 다른 메시지를 보낼 수 있어요.
삼항 연산자란?
"만약 ~이면 A, 아니면 B"처럼 조건에 따라 결과가 달라지는 방식이에요.
예를 들어, "비가 오면 우산을 챙기고, 안 오면 안 챙긴다"를
비가 오나요? → 네(우산 챙김) / 아니오(안 챙김) 처럼 표현해요.
사용 방법
#ternary:[조건]?[조건이 맞을 때]:[조건이 틀릴 때]
조건은 A==B 형태의 문자열 일치 비교만 돼요. != · > 같은 다른 기호를 쓰면 조건식이 그대로 채팅에 나가요.
응답 맨 앞에 와야 해요
#ternary: 는 응답의 첫 글자부터 시작해야 동작해요.
안녕하세요 #ternary:... 처럼 앞에 다른 글자가 있으면 그냥 글자로 출력돼요.
예시 1: 팔로우 확인
!추가 !팔체 #ternary:$follow_check==True?$nick님은 팔로우 O:$nick님은 팔로우 X
팔로우를 했으면 "팔로우 O", 안 했으면 "팔로우 X"가 출력돼요!
예시 2: 출석 중복 방지
!추가 !출석 #ternary:$att_check==True?$nick님 $att_add번 출석!:$nick님 오늘은 이미 출석했어요!
$att_check가 True면 출석 가능(아직 안 함) 상태예요. 그래서 출석 처리가 되고, False면 이미 출석했기 때문에 안내 메시지가 나와요!
콜론(:) 사용 주의
#ternary:는 콜론(:)을 기준으로 조건, 참일 때 메시지, 거짓일 때 메시지를 구분해요.
참일 때 메시지 부분에 콜론이 들어가면 문법이 깨져요!
❌ #ternary:$follow_check==True?$nick님: 환영합니다!:팔로우 해주세요 (콜론 때문에 오류)
✅ #ternary:$follow_check==True?$nick님 환영합니다!:팔로우 해주세요 (콜론 제거)
대시보드에서 세밀하게 설정하기
채팅으로 만든 명령어는 기본값으로 설정돼요.
| 항목 | 기본값 |
|---|---|
| 필요 권한 | 시청자 (누구나) |
| 전체 쿨타임 | 3초 |
| 유저 쿨타임 | 3초 |
| 명령어 목록에 포함 여부 | 표시함 |
더 세밀하게 조정하려면 대시보드 → 유저 명령어에서 설정하세요.
등록된 명령어가 한눈에 보이고, 오른쪽 스위치로 지우지 않고 잠시 끌 수 있어요.
추가 또는 수정 을 누르면 아래 설정 창이 열려요.
대시보드에서 조정하는 설정
| 설정 | 설명 |
|---|---|
| 필요 권한 | 시청자 / 구독자 / 매니저 / 스트리머 중 선택 |
| 전체 쿨타임 | 모두가 함께 쓰는 쿨타임 (초) |
| 유저 쿨타임 | 한 사람이 다시 쓸 수 있기까지의 시간 |
| 일부 포함시 작동 | 명령어가 채팅 맨 앞에 와야 하는 기본 동작과 달리, 채팅 아무 위치에 들어가도 반응. 변수를 쓰는 명령어에는 켜지 마세요(화면에도 같은 경고가 떠요) |
| 치즈 감지시에만 작동 | 특정 금액대의 후원일 때만 반응 (= 후원 금액 조건). 최소·최대를 둘 다 0 으로 두면 조건이 꺼져요 |
| N번 사용한 이후에 비활성화 | 지정한 횟수만큼 쓰이면 자동으로 꺼짐 |
| 명령어 목록에 포함 여부 | !명령어 목록과 시청자 페이지에 보일지 여부 |
| 설명 | 시청자 페이지·대시보드 목록에 보여줄 설명 (채팅 !명령어 응답에는 안 나와요) |
| 활성 / 비활성 | 지우지 않고 잠시 꺼두기. 채팅 !명령어 끄기 <명령어> 로도 돼요 |
이렇게 쓰면 좋아요
- 부분 포함 매칭 —
ㅋㅋ로 설정해두면 시청자가ㅋㅋㅋㅋ라고만 쳐도 반응해요 - 후원 금액 조건 — 특정 금액 후원에만 반응하는 특별 메시지
- 자동 비활성화 — 선착순 이벤트 ("10명까지만!")
- 유저별 쿨타임 — 한 사람이 도배하는 것만 막고 다른 사람은 바로 쓸 수 있게
- 목록에 표시 끄기 — 숨겨진 이스터에그 명령어
부분 포함 매칭은 신중하게
너무 짧은 단어(ㅇ, 아 등)로 설정하면 봇이 채팅마다 반응해서 도배가 돼요. 쿨타임을 함께 넉넉히 잡아주세요.
변수와 함께 사용하기
변수를 넣으면 더 다양한 기능을 만들 수 있어요.
예시: 채널 소개
!추가 !채널소개 $channelName님의 방송에 오신 것을 환영합니다! 현재 $viewers명이 시청 중이에요.
예시: 팔로우 기간
!추가 !팔로우 $nick님은 팔로우한 지 $followDate 되셨어요!
자주 겪는 문제
"이미 존재하는 명령어입니다"
같은 이름의 명령어가 이미 있어요. !수정 으로 내용을 변경하거나 다른 이름으로 만들어보세요.
"수정, 삭제할 수 없는 명령어입니다"
봇 운영자가 잠가둔 명령어예요. 스트리머·매니저는 잠금을 걸거나 풀 수 없어요.
문구는 어디서 건드렸느냐에 따라 달라요 — 대시보드는 수정, 삭제할 수 없는 명령어입니다.,
채팅은 수정할 수 없는 명령어입니다. / 삭제할 수 없는 명령어입니다. 입니다.
!업타임 같은 기본 제공 명령어를 수정·삭제하려 하면 이 메시지가 아니라 "존재하지 않는 명령어입니다" 가 나와요.
!수정 · !제거 는 직접 만든 명령어 목록만 뒤지기 때문에, 기본 제공 명령어는 아예 찾지 못해요.
"명령어에 공백이 포함되어 있습니다"
대시보드에서 만들 때 나오는 문구예요. 채팅 !추가 는 첫 띄어쓰기까지만 명령어 이름으로 잡아서, !추가 !내 정보 안녕 은 오류 없이 !내 라는 명령어로 등록돼요.
명령어 이름에는 띄어쓰기를 넣을 수 없어요. !내 정보 ❌ → !내정보 ✅
명령어를 만들었는데 반응이 없어요
| 확인할 것 | 해결 |
|---|---|
| 쿨타임 중인가요? | 기본 3초예요. 잠시 기다렸다 다시 쳐보세요 |
| 권한이 맞나요? | 대시보드에서 필요 권한을 확인해보세요 |
| 비활성 상태인가요? | 대시보드에서 활성 스위치를 확인해보세요 |
| 자동 비활성화에 걸렸나요? | 사용 횟수 제한이 걸려 있을 수 있어요 |
다음 단계
커스텀 명령어에서 사용할 수 있는 변수들을 알아보세요!