콘솔이 잠겨 있어요 · 명령이 안 보여요

둘 중 하나라면 여기서 시작해요. 웹 관리 콘솔이 잠겨 있거나 내 서버가 안 보여요. 또는 Discord에서 Kletoi 명령이 선택창에 안 떠요. 앞쪽(웹 콘솔)은 서버 관리자를 위한 구획이고, 뒤쪽(Discord 명령)은 멤버를 포함해 누구나 볼 수 있어요. 원인은 자주 걸리는 순서대로 적었어요.

트리거 음성 채널이 하나도 없는 서버에서는 관리자가 콘솔을 열면 설정 온보딩 화면이 먼저 열려요. 사이드바 메뉴에 자물쇠가 붙고, 메뉴에 마우스를 올리면 “잠김 · 트리거를 하나 정하면 열려요”라는 안내가 떠요. 눌러도 이 화면으로 돌아와요. 버그가 아니라 트리거를 먼저 정하게 하는 거예요. 봇에게 필요한 권한이 없는 서버에서는 이 잠금이 걸리지 않아요. 자세한 설명은 웹 콘솔 둘러보기와 로그인에 있어요.

관리 콘솔은 그 서버에서 서버 관리 권한이 있는 계정만 열 수 있어요. 권한이 없으면 관리 콘솔 버튼이 안 보여요. 주소를 직접 열면 “접근 권한이 없어요” 화면이 떠요. 내 서버 목록이 비고 “관리할 수 있는 서버가 없어요”라고 뜨는 것도 같은 이유일 수 있어요. 어제는 열렸는데 오늘 안 열린다면 그 사이 권한이 바뀌었을 수 있어요. 콘솔은 봇이 지금 확인한 권한을 먼저 봐요.

권한이 있는데도 “접근 권한이 없어요” 화면이 뜬다면 다른 Discord 계정으로 로그인했을 수 있어요. 오른쪽 위 이름을 눌러 계정 전환 항목을 눌러요. 지금 로그인을 지우고 Discord 승인 화면을 다시 열어요.

한동안 안 썼거나 다른 기기에서 다른 기기에서 로그아웃 항목을 썼다면 이 브라우저의 로그인이 끊겨요. 로그인이 필요한 화면을 열면 Discord 로그인 화면으로 넘어가고, 로그인하면 열려던 화면으로 돌아와요. 봇이 권한을 바로 확인하지 못하는 중에는, 로그인한 지 12시간이 지난 뒤 관리 콘솔 화면을 열 때도 다시 로그인으로 넘어가요. 다른 기기에서 로그아웃 항목이 로그인을 끊는 방식은 다른 기기에서 로그아웃에 있어요.

로그인하는 도중 “로그인을 마치지 못했어요” 화면이 뜨면 Discord에서 돌아온 뒤 로그인을 끝내지 못한 거예요. 인증 링크가 만료됐거나 이미 사용됐을 때, 또는 Discord 쪽이 불안정할 때 떠요. 다시 로그인 버튼을 눌러 처음부터 다시 해요. 고치는 사람은 본인이에요.

뒤로 가기나 새로 고침으로 로그인 주소를 다시 열었다면 이 화면이 아니라 코드 400이 붙은 “문제가 발생했어요” 화면이 떠요. 그럴 때는 홈으로 버튼으로 홈에 가서 로그인을 처음부터 다시 열어요.

홈 화면에는 봇이 들어 있는 서버만 카드로 나와요. 관리 콘솔 카드를 누르면 서버 관리 권한이 있는 서버가 모두 나오고, 서버마다 봇 설치됨 또는 미설치 표시가 붙어요.

봇이 서버에서 나간 뒤에 콘솔에서 저장하려 하면 “봇이 이 서버에 없어 변경할 수 없어요” 화면이 떠요. 같은 방법으로 봇을 다시 초대하면 다시 관리할 수 있어요. 주소를 직접 열었는데 “페이지를 찾을 수 없어요” 화면이 뜬다면 주소가 틀렸거나 봇이 한 번도 들어온 적 없는 서버일 수 있어요.

버그가 아니에요. 관리 콘솔 버튼은 서버 관리 권한이 있는 사람에게만 보여요. 매치메이커로 지정만 됐다면 보이지 않아요. 매치메이커는 방 패널의 ⚔️ 단추(봇을 뺀 사람이 방에 2명 이상 있어야 해요)나 관리자가 알려 준 매치 화면 주소로 처음 열고, 그 뒤에는 봇이 보내는 단계 재촉 같은 알림 DM의 링크로도 열어요. 다만 그 DM은 서버 설정의 봇 DM 알림 허용 스위치가 켜져 있어야 가요. 새 서버는 이 스위치가 꺼진 채 시작해서, 처음 지정한 매치메이커는 ⚔️ 단추나 관리자가 알려 준 주소로 들어와야 해요. 스위치를 켜는 법은 초대 DM이 안 와요에 있어요. 설정이나 멤버 같은 관리 화면은 서버 관리 권한이 있는 사람만 열어요. 매치메이커를 도와주는 사람은 서버 관리자예요. 길은 매치메이커 지정과 해제에 있어요.

설정을 바꾸고 저장하는 순간에 “잠시 후 다시 시도해 주세요” 화면이 뜨면, Kletoi가 그때 Discord에서 내 관리자 권한을 확인하지 못한 거예요. 봇이 다시 연결되는 중일 수 있어요. 바꾼 내용은 저장되지 않았어요. 화면을 보는 건 되는데 저장만 막히기도 해요.

/관리 명령과 /매치메이커 명령은 서버 관리 권한이 없는 사람에게는 기본으로 숨겨져요. 권한이 없으면 선택창에 아예 안 떠요. 권한이 있는 계정으로 다시 확인해요. 권한은 서버 관리 권한이 없어요처럼 서버 소유자나 관리자가 줘요. 권한이 있는데도 안 보이면 서버가 Discord에서 명령 사용 범위를 따로 정해 두었을 수 있어요. 그 설정은 Discord 쪽에 있어서 Kletoi가 바꿀 수 없어요.

명령마다 누가 쓸 수 있는지는 전체 명령어에 있어요.

/관리 · /매치메이커 · /라이엇 · /고정팀 · /배지 명령은 서버 안에서만 써요. 봇과의 DM에서는 선택창에 안 떠요.

/음성 도움말 명령을 뺀 /음성 명령은 서버의 임시 음성 채널에 들어가 있을 때만 해요. 아니면 “임시 음성 채널 안에서만 사용할 수 있어요.”라고 답해요. /음성 정보 명령 말고는 방장만 쓸 수 있어서, 방장이 아닌 사람이 쓰면 “이 채널의 방장만 사용할 수 있어요.”라고 답해요. 버그가 아니에요. 쓰는 법은 내 방 관리 — 이름·인원·잠금·숨김에 있어요.

같은 명령이 Discord 앱 언어에 따라 다른 이름으로 보일 수 있어요. 한국어·일본어·중국어·프랑스어·스페인어 앱은 그 언어의 이름을, 영어와 그 밖의 언어는 영어 이름을 보여요. 이 안내의 명령 이름은 읽는 언어에 맞춰 나와서 내 Discord 앱 언어와 다를 수 있어요. 그럴 땐 선택창에 뜬 이름을 골라요. 이름만 다르고 같은 명령이에요. 고칠 일은 없어요.

봇이 서버 멤버 목록에 없으면 명령도 없어요. 봇이 있는데도 Kletoi 명령이 하나도 안 보이면 봇을 넣을 때 명령 사용 범위(applications.commands)가 빠졌을 수 있어요. Kletoi의 초대 링크는 이 범위를 함께 요청해요. 그 밖의 주소로 봇을 넣었다면 빠졌을 수 있어요. 봇도 있고 범위도 맞는데 명령이 안 보이면, 서버가 Discord에서 누가 명령을 쓸 수 있는지 제한해 두었을 수 있어요. 그 설정은 Discord 쪽에 있어서 Kletoi가 바꿀 수 없어요. 고치는 사람은 서버 관리자예요.

봇이 업데이트되어 명령이 새로 생기거나 바뀐 직후에는 Discord 전체에 퍼지는 데 시간이 걸려요. 그때만 해당하는 원인이라서, 업데이트와 상관없이 명령이 안 보이면 위의 원인을 먼저 봐요. 걸리는 시간은 약속하지 못해요. 기다리는 게 기본이고, 고칠 사람도 따로 없어요.

문의할 때는 서버 이름, 열려던 화면, 화면에 뜬 문구를 함께 적어 줘요. “문제가 발생했어요” 화면에 요청 ID 항목이 보이면 그것도 알려 줘요.

로그인과 화면 구성은 웹 콘솔 둘러보기와 로그인에, 처음 설정은 서버 관리자 첫 5분에 있어요. 봇 권한이 헷갈리면 봇에 줘야 하는 서버 권한을 봐요. 매치메이커의 길은 매치메이커 지정과 해제에, 다른 기기의 로그인을 끊는 법은 다른 기기에서 로그아웃에 있어요. 설정 화면 전체는 서버 설정 한눈에 보기에서 훑어요. 초대 DM이 안 올 때는 초대 DM이 안 와요을, 프로필의 기록이 안 보일 때는 내 기록이 안 보여요를 봐요.