신청 리스트 | 잼쿠봇 사용 가이드

신청 › 신청 리스트 한 화면에서 접수 조건, 목록 처리, 방송 화면 디자인을 모두 다뤄요.

참고

신청 리스트가 뭔가요?

시청자가 채팅 !신청 내용이나 후원 메시지로 요청을 올리면 목록에 한 줄씩 쌓여요. 시참 순번, 그림 주제처럼 노래가 아닌 신청에 써요. 노래는 노래 (SR)이 따로 받아요.

접수 조건 정하기

화면 맨 위 신청 설정 카드에서 정해요. 값을 바꾸면 취소와 저장이 켜지고, 저장을 눌러야 반영돼요.

항목	설명
제목	오버레이 맨 위 큰 글자. 시청자 페이지에도 나와요
설명	제목 아래 작은 안내
유저당 최대 신청	한 시청자가 동시에 올려 둘 수 있는 항목 수. `0`은 무제한
포인트 신청 받기	켜면 채팅 `!신청`을 받아요
1회 신청 가격 (P)	채팅 신청 한 번에 깎는 포인트. `0`이면 무료
후원 신청 받기	켜면 `!신청`으로 시작하는 후원 메시지를 받아요
1회 신청 가격 (치즈)	후원 신청의 최소 금액. 이 금액 이상 후원해야 접수돼요

참고

처음에는 두 가지 접수가 다 꺼져 있어요

처음 상태는 포인트 신청 받기 꺼짐(0P, 무료), 후원 신청 받기 꺼짐(1,000치즈), 유저당 최대 신청 0(무제한)이에요. 받을 쪽을 켜고 저장해야 시청자가 !신청으로 항목을 올릴 수 있어요.

목록에는 1,000개까지 쌓여요. 다 차면 새 신청에 신청 목록이 가득 찼어요 (최대 1,000개). 완료된 항목을 정리해 주세요.가 돌아가요. 채팅 신청이면 포인트는 돌려주고, 후원 신청이면 봇이 채팅으로 등록하지 못했다고 알려요. 완료된 항목을 지우면 다시 받아요.

유저당 최대 신청은 끝나지 않은 항목만 세요. 완료로 바꾸거나 지운 항목은 빠져요. 2로 두면 "대기 중인 신청은 한 사람당 2개까지"라는 뜻이에요. 후원 신청에는 이 제한이 걸리지 않아요.

!신청은 봇 기본 명령어예요. 명령어 이름은 바꿀 수 없어요. 기본 명령어 설정의 !신청이 켜져 있어야 채팅 신청이 돼요. 끄고 켜는 법은 기본 명령어에 있어요. 후원 신청은 이 설정과 상관없이 받아요.

제목·설명은 비워 둘 수 없어요. 빈칸으로 저장하면 제목, 설명이라는 글자가 대신 들어가요. 오버레이에서 안 보이게 하려면 디자인에서 제목 글자·설명 글자 투명도를 0%로 내리세요.

시청자는 이렇게 신청해요

채팅으로 신청

!신청 뒤에 한 칸 띄우고 내용을 적어요.

!신청 마리오 카트 8

시청자닉네임님의 신청이 등록됐어요: 마리오 카트 8

가격이 있으면 포인트를 먼저 깎고 목록 맨 아래에 붙여요. 봇 대답에는 내용이 30자까지만 나오고 나머지는 ...로 줄여요. 목록에는 전체가 들어가요. 목록에 넣다가 실패하면 깎은 포인트를 돌려줘요.

이럴 때	봇 대답
내용 없이 `!신청`만 쳤을 때	사용법: !신청 [내용]
끝나지 않은 신청이 이미 유저당 최대 신청만큼 있을 때	시청자닉네임님, 동시 신청 가능 수(2)를 초과했어요.
포인트가 모자랄 때	시청자닉네임님, 포인트가 부족해요. (필요 100P / 보유 30P)
포인트 신청 받기가 꺼져 있을 때	대답 없음

스트리머가 채팅으로 신청해도 가격과 제한이 똑같이 걸려요. 직접 넣을 땐 목록 처리하기의 입력칸을 쓰세요.

후원으로 신청

후원 메시지를 !신청으로 시작하고, 1회 신청 가격(치즈) 이상 후원하면 목록에 들어가요.

!신청 고양이 그려 주세요

주의

메시지 맨 앞이 !신청이고 한 칸 띄워야 해요

오늘도 화이팅 !신청 고양이처럼 중간에 넣거나 !신청고양이처럼 붙여 쓰면 접수되지 않아요. 후원 신청은 성공해도 실패해도 봇이 채팅으로 대답하지 않아요. 접수됐는지는 목록과 오버레이에서 확인하세요.

후원 금액이 커도 항목은 하나만 들어가요. 1,000치즈 설정에 2,000치즈를 보내도 1개예요. 익명 후원도 접수돼요.

시청자가 목록 보기

시청자는 시청자 페이지의 신청 리스트 탭(/view/<채널>/request)에서 접수 조건, 진행 중인 항목, 전체 목록을 봐요. 10초마다 새로 고쳐져요. 이 탭을 숨기려면 시청자 페이지 설정에서 신청 현황을 끄세요.

목록 처리하기

신청 항목 카드에서 처리해요. 시청자가 신청하면 새로 고치지 않아도 맨 아래에 바로 붙어요. 카드 머리에는 5개 · 완료 2개처럼 전체와 완료 개수가 나와요.

하는 일	방법
현재 항목 정하기	행을 눌러요. 현재 칸의 ▶가 채워지고 오버레이 위쪽 박스에 그 내용이 나와요
다음으로 넘기기	카드 오른쪽 위 다음으로. 현재 항목을 완료로 바꾸고 바로 아래 항목을 현재로 정해요
완료 표시	완료 스위치를 켜요. 오버레이에서 취소선이 그어져요. 다시 끄면 대기로 돌아가요
순서 바꾸기	왼쪽 손잡이(⣿)를 끌어다 놓아요. 현재 표시는 그 항목을 따라가요
지우기	삭제 칸의 휴지통 버튼. 확인 창 없이 바로 지워져요
직접 넣기	카드 위쪽 입력칸에 적고 추가(또는 Enter). 500자까지, 신청자 없이 들어가요

처음엔 현재 항목이 없어요. 첫 행을 누르거나 다음으로를 한 번 누르면 첫 항목부터 시작돼요.

다음으로는 바로 아래 항목으로 넘어가요. 이미 완료된 항목도 건너뛰지 않아요. 마지막 항목에서 누르면 그 항목만 완료로 바뀌고 현재 표시는 그대로예요.

현재 항목을 지우면 바로 아래 항목이 현재가 돼요. 지운 게 마지막 항목이면 바로 위 항목이 현재가 돼요. 목록을 한 번에 비우는 버튼은 없어서, 끝난 항목은 하나씩 지워야 해요.

방송 화면에 띄우기

화면 맨 아래 오버레이 URL 카드에서 복사를 눌러요. 주소가 흐리게 가려져 있어도 그대로 복사돼요.
OBS 소스 목록 + → 브라우저를 고르고 URL 칸에 붙여 넣어요.
패널 폭이 500px로 정해져 있어요. 너비는 500 이상으로 두세요. 패널은 항목이 늘수록 아래로 길어지니 높이는 넉넉히 잡으세요.

주소에 채널 키가 들어 있어요. 방송 화면이나 채팅, 캡처에 주소가 보이지 않게 하세요.

오버레이에는 제목, 설명, 현재 항목 박스, 전체 목록이 차례로 나와요. 현재 항목이 없으면 박스가 숨겨져요. 완료한 항목도 취소선을 단 채 남아 있으니, 목록에서 빼려면 지워야 해요. 대시보드에서 바꾼 내용은 바로 반영돼요.

디자인 바꾸기

화면 오른쪽 위 오버레이 디자인을 누르면 설정 창이 열려요. 오른쪽 미리보기를 보면서 고치고 저장하세요. 목록이 비어 있으면 예시 항목으로 보여 줘요.

항목	설명
디자인 프리셋	design1 세로 리스트형(현재 항목 앞에 ▶) / design2 가로 칩형. 처음엔 design2
전체	패널 배경, 제목 글자, 설명 글자
상단 박스	현재 항목 박스의 배경, 글자, 테두리
목록 · 기본	대기 중인 항목의 배경, 글자
목록 · 현재	목록 안에서 강조되는 현재 항목의 배경, 글자, 테두리
목록 · 완료	취소선이 그어진 항목의 배경, 글자

색마다 옆의 막대로 투명도를 0~100%로 정해요. 기본값으로는 색만 기본 색(어두운 회색 계열)으로 돌리고 프리셋은 그대로 둬요. 이것도 저장을 눌러야 반영돼요. 닫기를 누르면 저장하지 않은 변경은 버려져요.

안 될 때

이럴 때	확인할 것
`!신청 내용`에 봇이 아무 대답도 안 해요	포인트 신청 받기가 켜졌는지, 기본 명령어 `!신청`이 켜졌는지
후원했는데 목록에 없어요	후원 신청 받기, 후원 금액이 1회 신청 가격 이상인지, 메시지가 `!신청` + 한 칸 띄움으로 시작하는지
받을 생각 없던 신청이 쌓여요	처음엔 두 접수가 다 켜져 있어요. 안 받을 쪽을 끄고 저장
오버레이에 '토큰이 유효하지 않습니다'가 떠요	오버레이 URL에서 다시 복사해 넣어요
세로 리스트형에서 아래쪽 항목이 안 보여요	목록 칸은 600px 높이까지만 보여요. 끝난 항목을 지우거나 design2로 바꿔요
오버레이 제목이 '제목'으로 나와요	제목을 비워 저장했어요. 제목을 넣거나 제목 글자 투명도를 0%로
휴대폰에서 순서를 못 바꿔요	좁은 화면에서는 끌기 손잡이가 숨겨져요. PC 화면에서 바꿔요
시청자 페이지에 신청 리스트 탭이 없어요	시청자 페이지 설정의 신청 현황

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

디스코드로 문의하기