기능 소개
Monvoke의 모든 명령어와 기능을 자세히 정리한 레퍼런스입니다.
명령어 목록
/invoke - 모집 명령어
기본적인 모집을 만드는 메인 명령어입니다.
파라미터
| 파라미터 | 필수/선택 | 설명 |
|---|---|---|
image_url |
선택 | 첨부 이미지의 URL |
color |
선택 | 모집 메시지의 강조 색상 |
background |
선택 | 모집 이미지의 배경 (표시 스타일이 텍스트인 모집에서는 사용되지 않음) |
입력 항목 (모달)
| 항목 | 필수 | 설명 |
|---|---|---|
| 모집 내용 | 필수 | 최대 1000자. 모집의 상세 설명 (여러 줄 가능). [ ]로 감싼 부분이 제목이 됩니다 (예: [랭크 모집] 골드 구간 3명 모집) |
| 모집 인원 | 선택 | 1~99의 숫자. 실제 상한은 "입력값 + 호스트"로 최대 100명. 비워 두면 인원 무제한 모집이 됩니다 |
| 시작 시간 | 선택 | 입력하면 예약 시간 모집이 됩니다 (예: 21:00, 2100, 9pm, 09/03 21:00, 2026-09-03 21:00, 032100 / 시간대는 서버 설정을 따름 / 1개월 앞까지 지정 가능) |
| 기존 유저 | 선택 | 처음부터 멤버로 추가할 유저를 선택 |
| 멘션할 역할 | 선택 | 모집을 게시할 때 멘션으로 알릴 역할을 선택 |
모달에 정보를 입력하고 전송하면 모집 메시지가 게시됩니다.
/custom - 커스텀 매치 모집
자동 팀 나누기 기능이 있는 커스텀 매치 모집을 만듭니다.
파라미터
| 파라미터 | 필수/선택 | 설명 |
|---|---|---|
rating_type |
선택 | 레이트 타입을 선택 (서버에서 설정한 것) |
asymmetric |
선택 | 1v4 (킬러 1명 + 생존자 4명) 또는 2v8 (킬러 2명 + 생존자 8명)을 선택. 지정하지 않으면 대칭 매치 |
image_url |
선택 | 첨부 이미지의 URL |
color |
선택 | 모집 메시지의 강조 색상 |
background |
선택 | 모집 이미지의 배경 (표시 스타일이 텍스트인 모집에서는 사용되지 않음) |
입력 항목 (모달)
| 항목 | 필수 | 설명 |
|---|---|---|
| 모집 내용 | 필수 | 최대 1000자. 모집의 상세 설명 (여러 줄 가능). [ ]로 감싼 부분이 제목이 됩니다 (예: [랭크 모집] 골드 구간 3명 모집) |
| 모집 인원 | 필수 | 호스트를 제외한 모집 인원. 1~9의 홀수만 가능 (대칭 매치만 해당). 호스트를 포함한 합계를 2팀으로 나누므로 4대4라면 7을 입력합니다. 비대칭 매치는 인원이 고정이라 입력하지 않습니다 |
| 시작 시간 | 선택 | 입력하면 예약 시간 모집이 됩니다 (예: 21:00, 2100, 9pm, 09/03 21:00, 2026-09-03 21:00, 032100 / 시간대는 서버 설정을 따름 / 1개월 앞까지 지정 가능) |
| 기존 유저 | 선택 | 처음부터 멤버로 추가할 유저를 선택 |
| 멘션할 역할 | 선택 | 모집을 게시할 때 멘션으로 알릴 역할을 선택 |
대칭 매치와 비대칭 매치
| 매치 형식 | 모집 인원 | 팀 구성 | 어울리는 게임 |
|---|---|---|---|
| 대칭 | 홀수 (1, 3, 5, 7, 9명) + 호스트 | 팀 A vs 팀 B | FPS, MOBA 등 |
| 비대칭 (1v4) | 5명 고정 | 킬러 1명 vs 생존자 4명 | 데드 바이 데이라이트 등 |
| 비대칭 (2v8) | 10명 고정 | 킬러 2명 vs 생존자 8명 | 데드 바이 데이라이트 2v8 등 |
/preset - 프리셋 실행
저장해 둔 프리셋으로 빠르게 모집을 만듭니다.
파라미터
| 파라미터 | 필수/선택 | 설명 |
|---|---|---|
name |
필수 | 실행할 프리셋 이름 |
프리셋으로 만든 모집을 예약 시간 모집으로 하려면, 만든 뒤에 모집 메시지에서 시작 시간을 설정합니다 (모집 내용 편집 참고).
프리셋을 만드는 방법
프리셋은 전용 명령어가 아니라 만들어 둔 모집 메시지에서 저장합니다. /invoke나 /custom으로 만든 모집 메시지의 톱니바퀴 아이콘 버튼을 누르면 모집 설정 패널이 열립니다. "프리셋으로 저장"을 누르고 프리셋 이름을 입력하면 그 모집의 설정이 프리셋으로 저장됩니다.
저장할 수 있는 프리셋은 Free 플랜에서 1개, Plus 플랜에서 최대 20개입니다.
/preset-delete - 프리셋 삭제
저장해 둔 프리셋을 삭제합니다.
프리셋을 만든 사람 또는 서버 관리자만 삭제할 수 있습니다.
삭제 절차
파라미터는 없습니다. 명령어를 실행하면 모달이 열리고, 저장된 프리셋 중에서 삭제할 것을 고릅니다. 여러 프리셋을 한꺼번에 선택할 수 있습니다.
/recurring - 정기 실행
저장해 둔 프리셋을 매일 또는 매주 정해진 시각에 자동으로 실행합니다.
파라미터
| 파라미터 | 필수/선택 | 설명 |
|---|---|---|
action |
필수 | 생성·삭제 중 무엇을 할지 선택 |
입력 항목 (모달·생성 시)
| 항목 | 필수/선택 | 설명 |
|---|---|---|
| 반복 | 필수 | 매일, 또는 매주 ◯요일 중에서 선택 |
| 프리셋 | 필수 | 실행할 프리셋을 선택 |
| 게시 시각 (HHMM) | 필수 | 모집을 게시할 시각 (예: 2000). 시간대는 서버 설정을 따릅니다 |
| 시작 시간 (HHMM) | 선택 | 모집이 시작되는 시각 (예: 2100). 지정하면 게시된 날의 그 시각에 시작하는 예약 시간 모집이 됩니다. 게시 시각보다 나중의 시각만 지정할 수 있습니다. 생략하면 인원 제한 모집이 됩니다 |
| 자신을 멤버로 포함 | 필수 | 포함하면 등록한 사람이 호스트가 됩니다. 포함하지 않으면 멤버 0명으로 시작하고, 가장 먼저 참가한 사람이 호스트가 됩니다 |
정기 실행으로 만들어지는 모집
모집은 명령어를 실행한 채널에 게시됩니다. 내용은 프리셋의 설정 그대로입니다. 모집 유형은 시작 시간의 지정 여부로 정해지며, 지정하지 않으면 인원 제한, 지정하면 그날의 지정 시각에 시작하는 예약 시간 모집이 됩니다. 정기 실행으로 만들어진 모집에는 푸터 맨 앞에 그것을 나타내는 표시가 붙습니다.
시작 시간을 지정한 경우: 모집 메시지에 시작 예정 시각이 표시되고, 그 시각이 되면 멤버에게 알림이 갑니다. 그 시점에 인원이 모였으면 모집이 완료되고, 자리가 남아 있으면 모집이 이어집니다. 시작 시간보다 먼저 시작하고 싶을 때는 호스트가 톱니바퀴 아이콘 버튼에서 "먼저 시작"을 누릅니다.
"자신을 멤버로 포함"에서 포함하지 않은 경우: 호스트 자리가 비어 있는 상태, 멤버 0명으로 시작합니다. 가장 먼저 참가 버튼을 누른 사람이 호스트가 되어, 취소·종료·설정 변경·VC 생성 같은 호스트용 조작을 할 수 있게 됩니다.
삭제
action에서 삭제를 고르면 모달이 열리고, 등록된 정기 실행 중에서 삭제할 것을 고릅니다. 여러 개를 한꺼번에 선택할 수 있습니다. 서버 관리자는 서버 안의 모든 정기 실행을, 그 외의 유저는 자신이 등록한 정기 실행만 삭제할 수 있습니다.
등록 수와 자동 중지
- 등록할 수 있는 정기 실행은 Free 플랜에서 5개, Plus 플랜에서 최대 20개입니다.
- 참조하고 있는 프리셋을 삭제하면 그 정기 실행도 함께 삭제됩니다.
- 게시할 채널에 모집을 만들 수 없는 상태가 3회 연속되면 중지됩니다.
- "자신을 멤버로 포함"으로 등록한 사람이 서버를 떠나면 중지됩니다.
- 중지된 정기 실행은 자동으로 재개되지 않습니다. 삭제 화면에 중지됨으로 표시되므로 필요 없다면 삭제해 주세요.
/ranking - 랭킹 표시
서버 안의 레이트 랭킹을 표시합니다.
기능
명령어를 실행하면 인터랙티브한 랭킹 메시지가 표시됩니다.
| 요소 | 설명 |
|---|---|
| 선택 메뉴 | 레이트 타입을 선택해 랭킹을 전환 |
| 페이지 넘김 버튼 | 페이지 넘김 (한 페이지에 10명 표시) |
| 레이트 확인 버튼 | 누른 유저 본인의 모든 레이트 타입의 레이트를 표시 |
특징
- 레이트 타입 전환: 선택 메뉴에서 선택하면 랭킹이 즉시 갱신됩니다
- 페이지 나누기: 최대 100명까지 표시하며, 10명씩 페이지를 넘깁니다
- 개인 레이트 확인: "레이트 확인" 버튼으로 자신의 모든 레이트 타입의 레이트와 순위를 확인합니다 (썸네일에 아이콘 표시)
- 영속화: 봇을 재시작해도 버튼과 선택 메뉴가 동작합니다
/config - 서버 설정
서버의 관리자 권한(Administrator)을 가진 멤버만 실행할 수 있습니다. 서버 전체의 설정을 변경합니다.
설정 항목 목록
명령어를 실행한 뒤 설정 항목을 선택하면 모달이 표시되며, 각종 값을 입력·변경할 수 있습니다. "모집 디자인"만은 모달이 아니라 조작한 사람에게만 보이는 설정 패널이 열립니다.
| 설정 이름 | 설명 |
|---|---|
| 전용 VC를 생성할 카테고리 | 전용 VC를 만들 카테고리 설정 |
| 오토룸 | 트리거 채널의 추가·삭제, VC 이름 장식, 명명 유형 설정 (Free 플랜: 1개 / Plus 플랜: 최대 20개 + 고스트 모드) |
| 레이트 타입 | 레이트 타입의 추가·삭제·초기화를 한꺼번에 설정 |
| 시간대 | 예약 시간 모집의 시각 입력에 사용하는 시간대 (UTC 오프셋) |
| 기본 멘션 | 모집할 때 기본으로 멘션 알림을 보낼 역할을 설정 (비워 두면 비활성화) |
| 모집 전용 채널 | 일반 메시지를 자동으로 삭제하는 채널의 추가·삭제 (Free: 1ch / Plus: 10ch) |
| 모집 목록 채널 | 서버 안에서 유효한 모집을 모아서 표시하는 채널 설정 |
| 표시 언어 | 서버 전체의 봇 표시 언어를 통일. "자동 (명령어 실행자의 언어)"을 고르면 각 유저의 클라이언트 언어로 돌아감 |
| 모집 디자인 | 모집의 표시 스타일(모집 이미지/텍스트), 모집 이미지의 캐릭터·유저 아이콘·기본 배경, 색상을 설정. 이름을 붙인 설정을 만들어 채널별로 구분해 쓸 수 있음 (Plus 플랜). 패널에서 배경 이미지·캐릭터 이미지 관리와 기본 첨부 이미지 URL 설정도 수행 |
| 아이콘 이미지 등록/초기화 | 이 서버에 표시되는 Monvoke의 아이콘을 교체 (Plus 플랜) |
| ID 라벨 | ID 공유에서 표시할 ID를 전환하는 라벨과 플래그의 등록·삭제 (서버당 최대 15개) |
/support - 커뮤니티 후원
커뮤니티 후원 안내 메시지를 채널에 게시합니다.
Plus 플랜에 가입한 서버 전용 명령어입니다.
기능
명령어를 실행하면 채널에 커뮤니티 후원 안내 메시지가 게시됩니다. 메시지에는 Monvoke 소개 링크와 후원 페이지로 가는 링크 버튼이 들어 있습니다.
서버 멤버는 버튼으로 Monvoke 웹사이트의 후원 페이지에 접속해 스타를 구매하고 Plus 플랜의 요금을 후원할 수 있습니다.
/id - ID 공유
VC에서 공유할 ID와 프로필 링크를 등록·관리합니다.
등록한 ID와 프로필 링크는 전용 VC나 오토룸에 참가했을 때 자동으로 표시됩니다. 게임 ID나 친구 코드를 공유할 때 편리합니다.
프로필 링크는 자기소개를 쓴 Discord 메시지로 가는 링크입니다. 서버마다 1건 등록할 수 있으며, ID 라벨과 관계없이 공통으로 표시됩니다.
ID는 라벨별로 따로 등록할 수 있습니다. 서버에 ID 라벨이 등록되어 있으면, 참가한 VC에 따라 표시되는 ID가 자동으로 바뀝니다 (설정 방법은 ID 공유 참고).
옵션
| 파라미터 | 설명 | 필수 |
|---|---|---|
작업 |
등록·확인·삭제·프로필 중에서 선택 | 예 |
작업 목록
| 작업 | 설명 |
|---|---|
| 등록 | 열린 모달에서 라벨을 고르고 ID를 등록·갱신 |
| 확인 | 등록한 자신의 ID를 라벨별로 목록 표시 (프로필 링크를 등록했다면 그것도 표시) |
| 삭제 | 열린 모달에서 라벨을 고르고 등록한 ID를 삭제 |
| 프로필 | 열린 모달에서 자신의 프로필 메시지 링크(Discord 메시지 링크)를 등록·변경. 비워서 전송하면 해제 |
모집 기능 상세
모집 유형
기본 모집 기능
"지금 ○명 모으고 싶다"처럼 그 자리에서 인원이 차면 바로 마감하고 싶은 모집에 어울립니다.
- 입력한 모집 인원(호스트를 포함하지 않은, 모으고 싶은 인원)이 차면 자동으로 완료됩니다
- 갑작스러운 모집을 간편하게 열고 싶을 때 편리합니다
예약 시간 모집 (시작 시간을 입력)
"○일 ○시부터 같이 하고 싶다"처럼 미리 시작 시간을 정해 모집하고 싶을 때 어울립니다.
- 인원 제한 모집은 인원이 차는 즉시 멤버에게 알리지만, 예약 시간 모집은 시작 시간에 알립니다. 시작 시간 전에 가득 차도 그 시점에는 알림이 가지 않습니다
- 시작 시간은 서버에 설정된 시간대로 해석됩니다 (설정하지 않은 경우, 한국어 또는 일본어 클라이언트를 쓰는 유저는 UTC+9, 그 외는 UTC)
- 모집을 만들 때 모달의 "시작 시간"에 시각만(
21:00,2100,9pm), 월/일과 시각(09/03 21:00), 연-월-일과 시각(2026-09-03 21:00), 일·시·분의 6자리(032100= 3일 21:00) 중 하나를 입력합니다. 시각만 입력하면 다음에 오는 그 시각(오늘, 이미 지났다면 내일)이 됩니다 - 지정할 수 있는 것은 1개월 앞까지입니다
- 모집 메시지의 유효 기간은 시작 시간부터 셉니다 (Free 플랜은 24시간, Plus 플랜은 7일). 먼 날짜를 지정해도 시작 전에 기간이 만료되는 일은 없습니다
- 시작 전 리마인더를 설정할 수 있습니다. 시작 5분 전·10분 전·30분 전 중에서 여러 개를 고를 수 있으며, 고른 시각에 멤버와 미정 멤버에게 DM 알림이 전송됩니다
- 시작 시간과 리마인더는 모집을 만든 뒤에 모집 메시지에서 설정·변경할 수 있습니다 (모집 내용 편집 참고)
참가·탈퇴·미정의 구조
모집 메시지에는 다음 버튼이 표시됩니다.
참가 버튼
- 정식으로 모집에 참가
- 멤버 목록에 추가
- 미정 상태라면 정식 참가로 변경
- 가득 찬 경우에는 참가할 수 없음
탈퇴 버튼
- 모집에서 탈퇴
- 멤버 또는 미정 멤버 목록에서 삭제
- 호스트는 탈퇴할 수 없습니다
미정 버튼
- 참가가 불확실할 때 임시로 등록
- 참가 인원에는 포함되지 않습니다
- 용도:
- 참가할 수 있을지 불확실할 때("갈 수 있으면 갈게") 의사를 표시
- 인원이 모일 것 같을 때 참가 가능 여부의 최종 확인을 받고 싶을 때
미정 멤버에게 가는 알림: 정식 참가 인원 + 미정 인원이 목표 인원에 도달한 시점에, 미정 상태인 유저에게 "참가할 수 있나요?"라고 묻는 DM 알림이 전송됩니다 (참가 의사 확인).
중요: 미정은 자리를 확보하는 것이 아닙니다. 미정인 채로 다른 유저들로 멤버 자리가 다 차면 그 시점에는 불참으로 처리됩니다. 참가하고 싶다면 DM이나 모집 메시지에서 "참가"로 바꿔 주세요.
취소 버튼 (호스트 전용)
- 모집을 취소
- 모든 버튼이 비활성화됨
대기열 버튼 (모집 완료 후)
- 모집이 완료된 뒤에 표시되는 버튼
- 멤버가 탈퇴하면 대기열의 맨 앞에서부터 자동으로 멤버로 승격
- 용도:
- 가득 찬 모집에 자리가 나면 참가하고 싶을 때
- 대기 순번으로 등록
모집 완료 방식
기본(시작 시간을 입력하지 않은) 경우
모집 인원에는 호스트를 포함하지 않고, 앞으로 모으고 싶은 인원을 입력합니다. 호스트를 더한 인원에 멤버가 도달하면 즉시 완료됩니다.
모집 인원: 5 → 실제 상한: 6명 (호스트 + 5명)
멤버가 6명에 도달 → 자동 완료
시작 시간을 지정한 경우
시작 시간이 지나고 인원이 모인 시점에 완료됩니다.
시작 시간: 2024-12-31 20:00
모집 인원: 5 → 실제 상한: 6명
케이스 1: 19:50에 6명이 모임 → 20:00까지 모집 계속 → 20:00 이후에 완료
케이스 2: 20:10에 6명이 모임 → 즉시 완료
완료 후의 흐름
- 멤버에게 DM으로 모집 완료 알림이 전송됩니다.
- 호스트는 모집 메시지의 VC 액션 메뉴에서 멤버 전용 VC를 만들 수 있습니다.
역할 기능
모집 안에서 역할을 설정하고 선택할 수 있습니다.
역할 사용법
- 모집을 만들 때: 호스트가 역할을 정의
- 참가한 뒤: 멤버가 선택 메뉴에서 역할을 선택
- 표시: 멤버 목록이 역할별로 나뉘어 표시
역할별 인원 설정
역할을 추가할 때 그 역할의 최소 인원과 최대 인원을 선택적으로 설정할 수 있습니다. 설정하면 인원이 부족하거나 넘치는 동안에만 모집 메시지에 경고가 표시됩니다.
인원 지정은 기준일 뿐이며 모집의 진행을 제한하지 않습니다. 역할별 인원이 채워지지 않아도 모집은 완료됩니다.
그룹
역할을 설정한 모집에는 그룹을 추가할 수 있습니다. 그룹을 추가하면 멤버가 역할과 그룹을 모두 고르게 되고, 멤버 목록이 그룹별로 인원수와 함께 나뉘어 표시됩니다. 같은 구성의 파티를 여러 개 동시에 편성하는 모집에 사용합니다.
인원 부족·초과 경고도 그룹별로 판정해 표시됩니다.
역할별 인원 설정은 그룹이 달라도 공통된 값입니다. 그룹마다 다른 인원을 설정할 수는 없습니다.
모집 내용 편집
만든 모집은 호스트가 모집 메시지에서 내용을 변경할 수 있습니다.
편집 절차
모집 메시지의 톱니바퀴 아이콘 버튼을 누르면 본인에게만 보이는 모집 설정 패널이 열립니다. 패널의 버튼과 선택 메뉴로 조작하면 모집 메시지가 그 자리에서 갱신됩니다.
편집할 수 있는 항목
- 모집 수정: 제목·설명·시작 시간을 고쳐 씁니다. 제목을 비우면 제목 없음이 되고, 시작 시간은 비워 두면 변경되지 않습니다
- 유저 추가: 고른 유저를 멤버로 추가 (한 번에 최대 25명). 미정·대기열에 있던 사람은 정식 참가로 옮겨집니다
- 멤버 추방: 고른 멤버를 모집에서 제외 (한 번에 최대 25명)
- 리마인더: 시작 전에 멤버와 미정 멤버에게 DM으로 알리는 타이밍을 선택
- 먼저 시작: 시작 시간이나 인원이 모이기를 기다리지 않고 모집을 시작 (
/invoke만 해당) - 프리셋으로 저장: 프리셋 이름을 입력해 그 모집의 설정을 프리셋에 저장
역할과 그룹의 추가는 모집 메시지 아래쪽의 역할 선택 메뉴에서 합니다.
시작 시간과 리마인더
시작 시간을 설정·변경하면 멤버와 미정 멤버에게 새 시작 시간이 DM으로 알려집니다.
편집할 수 없는 항목
- 모집 인원, 멘션할 역할
- 첨부 이미지, 강조 색상, 배경 이미지, 표시 스타일(모집 이미지/텍스트)
- 추가한 역할·그룹의 삭제나 이름 변경
이를 바꾸고 싶다면 모집을 취소하고 다시 만들어 주세요.
조작할 수 있는 사람
모집 설정 패널은 호스트만 열 수 있습니다. 역할의 선택과 해제는 멤버가 할 수 있습니다 (미정 멤버와 대기열에 있는 사람은 선택할 수 없습니다).
퀵 모집
슬래시 명령어 없이 텍스트 메시지를 보내는 것만으로 모집을 만들 수 있는 기능입니다.
명령어 입력이 번거롭거나 빠르게 모집을 열고 싶을 때 편리합니다.
형식
모집 설명@모집 인원 형태로 보냅니다. 모집 인원은 자신을 제외한 수를 숫자(1~99)로 지정합니다. @0이라고 쓰면 인원 무제한 모집이 됩니다.
모집 설명 안에서 [ ]로 감싼 부분이 제목이 됩니다 (예: [랭크 모집] 골드 구간 @3).
멘션 붙이기
같은 메시지 안에 멘션을 넣으면 모집에 그대로 반영됩니다.
- 역할 멘션: 그 역할에 모집을 알립니다 (
/config의 기본 멘션 설정보다 우선합니다) - 유저 멘션: 그 유저를 처음부터 멤버로 추가합니다
- 멘션은 설명 텍스트의 어디에 써도 괜찮습니다. 설명문에서는 자동으로 제거됩니다
- 봇, 호스트 본인, 서버에 없는 유저는 멤버로 추가되지 않습니다
- 모집 인원을 넘는 수의 유저를 멘션한 경우, 넘은 만큼은 추가되지 않습니다
이용 조건
- 이 기능을 쓰려면 먼저 모집 전용 채널 설정이 필요합니다
- 설정은
/config에서 모집 전용 채널을 골라 합니다 - 설정한 채널 안에서만 유효합니다
설명 텍스트가 프리셋 이름과 일치하면 그 프리셋이 호출되고 모집 인원만 덮어써집니다. 다만 역할 멘션을 붙인 경우에는 프리셋의 알림 대상보다 멘션한 역할이 우선합니다.
모집 메시지의 언어
슬래시 명령어로 만든 경우와 정해지는 방식이 다릅니다. /config의 표시 언어를 설정했다면 그 언어가 됩니다. 설정하지 않았다면 보낸 설명 텍스트의 언어를 자동으로 판정해 정해집니다 (판정할 수 없으면 영어). 메시지를 보낼 때는 실행자의 클라이언트 언어를 가져올 수 없기 때문입니다.
커스텀 매치 기능
대칭 매치
멤버를 자동으로 팀 A/팀 B로 나눕니다.
- 모집 인원: 홀수 (1, 3, 5, 7, 9명) + 호스트
- 레이트 반영: 높은 레이트 순으로 번갈아 배정 (팀 균등화)
비대칭 매치 (DbD 등)
킬러 vs 생존자의 비대칭 구성으로 멤버를 나눕니다.
- 1v4 모드: 킬러 1명 + 생존자 4명 (합계 5명 고정)
- 2v8 모드: 킬러 2명 + 생존자 8명 (합계 10명 고정)
- 팀 배정은 무작위 셔플로 정해집니다
팀 나누기 로직
레이트를 반영한 공정한 팀 나누기를 합니다.
- 멤버를 레이트가 높은 순으로 정렬
- 번갈아 팀 A/팀 B에 배정
- 팀 사이의 레이트 차이를 최소화
완료 화면에서의 조작
팀 나누기가 끝난 뒤, 경기를 시작하기 전에 모집 메시지의 버튼으로 편성을 바꿀 수 있습니다.
- "팀 전환" 버튼: 멤버가 누르면 자신만 반대 팀으로 이동합니다
- "셔플" 버튼: 호스트가 누르면 팀 나누기를 다시 합니다
두 버튼 모두 대칭 매치와 비대칭 매치에서 모두 쓸 수 있습니다.
승패 보고
커스텀 매치가 완료된 뒤 호스트는 승패를 보고할 수 있습니다.
- 표시되는 선택지: "팀 A 승리", "팀 B 승리" 등
- 레이트 갱신: 승패를 보고하면 멤버의 레이트가 자동으로 갱신됩니다
- 무효 경기: 경기가 성립하지 않았다면 무효로 보고할 수 있습니다
레이트 시스템
개요
- 레이트 타입별, 서버별, 유저별로 레이트를 관리합니다
- 레이트 타입은 서버 관리자가
/config에서 추가할 수 있습니다 - 초기 레이트: 1500 (Elo 방식)
- 승패를 보고하면 자동으로 갱신됩니다
레이트와 랭킹을 확인하는 방법
/ranking을 실행합니다- 랭킹 메시지가 표시됩니다
- 선택 메뉴에서 레이트 타입을 선택해 랭킹을 확인합니다
- "레이트 확인" 버튼을 누르면 자신의 모든 레이트 타입의 레이트와 순위를 확인할 수 있습니다
레이트 초기화 (관리자 전용)
/config → 레이트 타입을 선택하고, 모달에서 초기화할 타입을 지정합니다. 지정한 레이트 타입의 모든 유저의 레이트를 초기값(1500)으로 되돌립니다.
VC 기능
전용 VC 생성 기능
호스트는 모집을 만든 직후부터 멤버 전용 VC를 만들 수 있습니다.
전제 조건
- 봇이 채널을 만들 권한을 가지고 있을 것
/config에서 카테고리 ID를 설정해 두면 지정한 카테고리에 VC가 만들어집니다 (설정하지 않은 경우 모집 채널의 카테고리에 만들어집니다)
VC 액션 목록
| 조작 | 내용 |
|---|---|
| 전용 VC 생성 | 멤버만 접속할 수 있는 VC를 새로 만듭니다 |
| 공개 VC 생성 | 누구나 접속할 수 있는 VC를 새로 만듭니다 |
| 현재 VC 연결 | 호스트가 지금 들어가 있는 VC를 이 모집의 VC로 표시합니다 |
| 모으기 | 같은 서버 안의 다른 VC에 있는 멤버를 호스트가 있는 VC로 이동시킵니다 |
| 부르기 | 이 모집에 연결된 VC에 아직 참여하지 않은 유저를 멘션합니다 |
메뉴는 서버의 모든 사람에게 보이지만, 조작할 수 있는 것은 호스트뿐입니다.
전용 VC에 접속할 수 있는 유저 권한은 멤버가 바뀔 때마다 덮어써집니다.
"모으기"의 대상: 이동하는 것은 실행한 시점에 이미 어딘가의 VC에 접속해 있는 멤버뿐입니다. VC에 들어가 있지 않은 멤버는 그 자리에 남고 알림도 가지 않습니다. VC에 들어가 있지 않은 멤버에게는 "부르기"로 VC 채팅에서 멘션을 보낼 수 있습니다.
필요한 봇 권한: "모으기"에는 멤버 이동 권한이 필요합니다. 권한이 없으면 버튼을 눌러도 아무 일도 일어나지 않습니다 (오류 메시지는 표시되지 않습니다).
"부르기"의 사용법: 먼저 "전용 VC 생성", "공개 VC 생성", "현재 VC 연결" 중 하나로 모집에 VC를 연결해 두어야 합니다. 대상은 연결된 VC에 없는 멤버 전원입니다 (다른 VC에 있는 멤버를 포함하며, 호스트 본인은 제외합니다). 전송되는 것은 멘션뿐입니다. 모두 이미 VC에 있는 경우에는 "VC에 없는 멤버가 없습니다."라고 표시됩니다.
VC의 종류
| 종류 | 접근 권한 |
|---|---|
| 전용 VC | 멤버만 접속·발언 가능 |
| 공개 VC | 누구나 접속 가능 |
만들어지는 VC의 특징
- 이름: 모집의 제목이 VC 이름이 됩니다.
- 채널 관리: 호스트에게는 채널 관리 권한이 부여되어, 채널 편집의 개요 탭(VC 이름 등)을 변경할 수 있습니다.
- 자동 삭제: 모두 나가면 자동으로 삭제됩니다.
오토룸 기능
트리거 채널에 접속하면 그 사람 전용 VC가 자동으로 만들어지고 그곳으로 이동합니다. 모두 나가면 VC는 자동으로 삭제됩니다.
- 만들어지는 VC는 트리거 채널의 설정(비트레이트, 인원 제한 등)을 이어받습니다
- VC를 만든 사람에게는 그 VC의 관리 권한이 부여됩니다
- 트리거 채널은 여러 개 등록할 수 있습니다 (Free 플랜: 1개 / Plus 플랜: 최대 20개)
- VC 이름을 붙이는 방식과 장식은 트리거 채널별로 고를 수 있습니다
- 고스트 모드 (Plus 플랜 전용): 만들어진 VC를 만든 사람 외에는 보이지 않는 비공개 VC로 만들 수 있습니다. 열람을 허용할 유저·역할은 나중에 추가할 수 있습니다
설정은 /config에서 합니다 (오토룸 트리거 채널 설정 참고).
ID 공유
VC에 참가하면 멤버가 등록해 둔 ID가 자동으로 그 VC의 채팅에 표시됩니다.
구조
전용 VC나 오토룸에 멤버가 참가·퇴장할 때마다 VC 안의 모든 멤버의 ID 목록이 자동으로 갱신됩니다. 미리 /id 명령어로 ID와 프로필 링크를 등록해 두면, VC에 참가할 때 친구 코드나 게임 ID를 직접 공유하는 수고를 덜 수 있습니다.
표시 내용
- ID를 등록한 멤버: 유저 이름과 ID가 표시됩니다.
- 프로필 링크를 등록한 멤버: 줄 끝에 "프로필" 링크가 표시되며, 누르면 등록한 메시지로 이동합니다 (ID를 등록하지 않았어도 표시됩니다).
- ID도 프로필 링크도 등록하지 않은 멤버: 유저 이름만 표시됩니다.
멤버가 많아 목록이 길어지면 여러 페이지로 나뉩니다. 목록 아래의 ⏪ / ⏩ 버튼으로 페이지를 전환할 수 있고, 버튼 사이에 "1 / 3"처럼 현재 페이지가 표시됩니다.
자동 갱신 타이밍
- 멤버가 VC에 참가했을 때
- 멤버가 VC에서 퇴장했을 때
/id로 프로필 링크를 등록·해제했을 때 (본인이 들어가 있는 VC의 목록)
표시 ID 전환 (ID 라벨)
/config → ID 라벨에서 라벨 이름과 플래그(쉼표로 구분한 키워드. 예: apex,에이펙스)를 등록할 수 있습니다 (서버당 최대 15개). VC를 만들 때 제목·설명(오토룸은 트리거 채널 이름)에 플래그의 키워드가 포함되어 있으면, 그 라벨에 등록된 ID만 ID 목록에 표시됩니다. 어떤 플래그에도 일치하지 않으면 라벨 없이 등록한 기본 ID가 표시됩니다.
멤버는 /id로 등록할 때 라벨을 고르면 라벨별로 다른 ID를 등록할 수 있습니다. 게임마다 오토룸의 트리거 채널을 나눠 두면, 만들어진 VC에 그 게임의 ID만 표시하는 식으로 쓸 수 있습니다.
ID 등록 방법
/id 작업:등록을 실행하면 열리는 모달에서 라벨을 고르고 ID를 입력합니다. 자세한 내용은 /id 명령어를 참고하세요.
프로필 링크
멤버들이 각자 자기소개 메시지를 써 둔 서버에서는, ID에 더해 자기소개 메시지를 추가로 링크할 수 있습니다.
프로필 링크는 /id 작업:프로필을 실행하고, 프로필을 쓴 메시지의 링크(메시지 메뉴의 "메시지 링크 복사"로 얻음)를 붙여 넣어 등록합니다.
서버 설정
기본 이미지 설정
/config → 모집 디자인 패널에서 기본 첨부 이미지 URL을 누르면, 선택 중인 설정(기본 설정 또는 이름을 붙인 설정)의 이미지 URL을 설정할 수 있습니다. 설정한 이미지는 명령어로 따로 지정하지 않는 한 모집 메시지에 표시됩니다. 이름을 붙인 설정별 지정은 Plus 플랜 전용입니다.
이미지는 모집 메시지의 멤버 목록과 버튼 사이에 표시됩니다 (/custom에서는 팀 표시와 VC 링크 뒤). 표시 스타일이 텍스트인 모집에도 표시됩니다.
이미지 URL 요건
- 프로토콜:
https://로 시작할 것 - 확장자:
.jpg,.jpeg,.png,.gif,.webp중 하나 - 권장 호스트: Discord CDN (
https://cdn.discord.com/)
이미지의 우선순위
- 명령어 파라미터로 지정한 이미지
- 모집한 채널에 할당한 이름 붙은 설정의 이미지 (Plus)
- 기본 설정의 이미지
전용 VC 카테고리 설정
/config → 전용 VC를 생성할 카테고리를 선택하고, 모달에서 카테고리를 설정합니다. 설정한 카테고리에 VC가 만들어집니다. 설정하지 않으면 모집 채널의 카테고리로 자동 대체됩니다.
필요한 봇 권한: 채널 관리
오토룸 트리거 채널 설정
/config → 오토룸 추가 또는 오토룸 설정을 선택하면 트리거 채널의 추가·삭제, VC 이름을 붙이는 방식과 장식, 고스트 모드(Plus 전용)를 설정할 수 있습니다.
필요한 봇 권한: 채널 관리, 멤버 이동
모집 전용 채널 설정
등록된 채널에서는 유저의 일반 메시지가 자동으로 삭제되므로 모집 채널이 눈에 잘 띄는 상태로 유지됩니다.
또한 이 채널에서는 퀵 모집을 쓸 수 있게 됩니다 (모집 설명@모집 인원이라고 보내기만 하면 모집을 만들 수 있는 기능). 퀵 모집은 이 설정을 한 채널 안에서만 동작하므로, 이용하려면 먼저 채널을 등록해야 합니다.
/config → 모집 전용 채널을 선택하면 모달에서 채널의 추가·삭제를 한꺼번에 설정할 수 있습니다.
상한: Free 플랜 1ch / Plus 플랜 10ch
레이트 타입 관리
커스텀 매치용 레이트 타입을 관리합니다. 레이트 타입의 추가는 Plus 플랜 전용입니다. Free 플랜에서는 처음부터 있는 Default 1종류만 사용합니다 (삭제·초기화는 플랜과 관계없이 할 수 있습니다).
/config → 레이트 타입을 선택하면 모달에서 타입의 추가·삭제·레이트 초기화를 한꺼번에 설정할 수 있습니다.
등록된 레이트 타입 확인: /ranking 명령어의 선택 메뉴에서 확인할 수 있습니다.
시간대 설정
예약 시간 모집의 시작 시간 입력을 어떤 시간대로 해석할지 설정합니다.
/config → 시간대를 선택하고, 모달에서 UTC 오프셋을 입력합니다 (예: +9는 한국 표준시). 비워서 전송하면 초기화됩니다.
설정하지 않은 경우, 한국어 또는 일본어 클라이언트를 쓰는 유저는 UTC+9(한국 표준시), 그 외는 UTC로 해석됩니다.
표시 언어 설정
/config → 표시 언어를 선택하면 서버 전체의 봇 표시 언어를 통일할 수 있습니다.
- 영어, 일본어, 프랑스어, 독일어, 한국어, 포르투갈어(브라질), 러시아어 중에서 선택할 수 있습니다
- 자동 (명령어 실행자의 언어)를 선택하면 각 유저의 클라이언트 언어 설정으로 돌아갑니다
배경 이미지 설정
직접 준비한 이미지를 배경으로 등록하는 기능이며, Plus 플랜 전용입니다. 기본 제공 배경 7종은 Plus 플랜 없이도 쓸 수 있습니다 (아래 "모집 디자인 설정" 참고).
/config → 모집 디자인 패널에서 배경 이미지 관리를 누르면 모집 이미지의 배경으로 쓸 PNG 이미지를 등록·삭제할 수 있습니다.
- 형식·크기: PNG, 1128×770px, 3MB 이하
- 상한: 서버당 최대 10장
- 등록할 때 이미지 이름과 플래그(쉼표로 구분)를 선택적으로 설정할 수 있습니다
캐릭터 이미지 설정
Plus 플랜 전용 기능입니다.
/config → 모집 디자인 패널에서 캐릭터 이미지 관리를 누르면, 모집 이미지에 표시되는 캐릭터를 직접 준비한 이미지로 교체할 수 있습니다. 서버의 마스코트 캐릭터를 쓰면 모집 기능을 커뮤니티만의 특별한 것으로 만들 수 있습니다. 모집 중, 가득 참, 종료 각각의 이미지를 등록하면 모집 상태에 맞춰 자동으로 전환됩니다.
등록하면 "모집 디자인"의 캐릭터에 "커스텀"이 추가되며, 이를 고르면 교체한 이미지가 쓰입니다.
이미지를 만드는 방법과 배포 템플릿은 "캐릭터 이미지 제작 가이드"를 참고하세요.
모집 디자인 설정
/config → 모집 디자인을 선택하면 설정 패널이 열리며, 모집의 표시 스타일, 모집 이미지의 캐릭터·유저 아이콘·기본 배경, 색상을 설정할 수 있습니다. 기본 설정은 플랜과 관계없이 쓸 수 있습니다.
패널의 편집할 설정 선택...에서 설정을 고르고 디자인 편집을 누르면 다음 항목을 변경할 수 있습니다.
- 표시 스타일: 모집 이미지·텍스트 중에서 선택. 텍스트로 하면 모집 이미지를 만들지 않고 제목과 설명을 글자로 표시합니다
- 캐릭터: Monvoke·간판·없음 중에서 선택. 캐릭터 이미지를 등록한 서버에서는 "커스텀"도 고를 수 있습니다. "없음" 이외를 고르면 모집 중, 가득 참, 종료 상태에 맞춰 표시가 자동으로 전환됩니다 (플랜과 관계없음)
- 유저 아이콘: 모집 이미지에 멤버의 아이콘을 표시할지(있음·없음) 선택
- 기본 배경: 투명, 기본 제공 배경 7종(벽·황무지·우주·숲·놀이방·무지개·광장), 등록한 배경 이미지 중에서 선택
- 색상: 모집 메시지 왼쪽 끝 선의 색을 선택
기본 제공 배경 7종은 모든 서버에서 쓸 수 있습니다. Plus 플랜이 필요한 것은 직접 준비한 이미지를 배경으로 등록할 때뿐입니다 (위의 "배경 이미지 설정" 참고).
미리보기를 누르면 버튼을 포함한 모집 메시지 전체의 견본이 별도 메시지로 도착합니다. 설정을 저장하기만 해서는 견본이 표시되지 않습니다.
채널별 구분 사용 (Plus 플랜)
Plus 플랜에서는 기본 설정과 별도로 이름을 붙인 설정을 최대 5개까지 만들어, 채널마다 디자인을 구분해 쓸 수 있습니다.
- 새로 만들기로 이름 붙은 설정을 만듭니다 (이름은 30자까지).
- 이 설정을 사용할 채널 선택...에서 그 설정을 쓸 채널을 할당합니다. 채널 안의 스레드나 포럼 게시물에서 만드는 모집에도 같은 설정이 쓰입니다.
- 할당되지 않은 채널에서는 기본 설정이 쓰입니다.
- 이름 붙은 설정에서 고르지 않은 항목은 기본 설정의 값이 쓰입니다.
- Plus 플랜이 만료되면 이름 붙은 설정은 쓰이지 않게 됩니다 (삭제는 할 수 있습니다).
아이콘 이미지 설정
Plus 플랜 전용 기능입니다.
/config → 아이콘 이미지 등록/초기화를 선택하면, 이 서버에 표시되는 Monvoke의 아이콘을 직접 준비한 이미지로 교체할 수 있습니다. 바뀌는 것은 설정한 서버에서의 표시뿐이며, 다른 서버에는 영향을 주지 않습니다.
데이터 관리
서버 퇴장 시의 데이터 삭제
봇이 서버에서 추방되거나 차단되면 그 서버의 데이터는 자동으로 삭제됩니다.
삭제되는 것
- 모집 데이터 (진행 중·완료된 것 모두)
- 유저 레이트 데이터
/config로 설정한 내용 (기본 이미지, VC 카테고리 등)- 만든 레이트 타입
삭제되지 않는 것
- Monvoke 웹사이트의 서버 등록
- Plus 구독
봇을 다시 초대하면 Plus 플랜은 이어지지만, 레이트와 설정은 초기 상태에서 시작합니다.