기록 명령어

서버에서 멤버에게 어떤 모더레이션 기록이 있는지 조회하고, 멤버가 자기 기록을 직접 확인하게 하고, 제재를 마친 멤버의 끝난 기록을 깨끗이 지울 수 있어요.

이 일을 하는 명령어는 세 가지예요. /history(스태프용), /my-history(누구나), /clear-history(스태프용, 삭제해요).

🔎 멤버의 기록 보기: /history

1. 멤버의 Discord 사용자 ID를 복사하세요. Discord에서 개발자 모드(Developer Mode)를 켜고(사용자 설정의 고급), 멤버를 오른쪽 클릭한 뒤 사용자 ID 복사(Copy User ID)를 고르세요.
2. /history를 입력하고 user_id에 ID를 붙여 넣은 다음 Enter를 누르세요.
3. 봇이 나에게만 보이게, 최신순으로 최근 10개의 기록을 답해 줘요.

각 줄은 이런 모양이에요.

1. BAN 🔴 (3d) - spamming invites - 2 hours ago #418

• 유형은 대문자(BAN, MUTE, KICK, WARN, SOFTBAN, UNBAN, UNMUTE)
• 기록이 아직 활성이면 🔴
• 밴, 뮤트, 소프트밴은 괄호 안에 기간
• 사유, 또는 "No reason"
• 일어난 시점
• # 뒤의 케이스 번호. 기록의 문구를 바꾸는 /reason에 쓰는 번호예요

명령어가 보이려면 Discord의 Kick Members 권한이 필요해요. 같은 목록이 더 자세하게 패널에도 있어요. 모더레이션 → 이력 탭에서 기록 하나당 한 행인 표로 볼 수 있고, 유형과 상태로 필터링할 수 있어요.

🙋 멤버가 자기 기록을 보게 하기: /my-history

누구나 /my-history를 입력할 수 있어요. 봇이 서버가 가지고 있는 본인에 대한 최근 모더레이션 기록 10개를 본인에게만 보여 줘요. "내가 뭐 때문에 경고받았지?" 같은 궁금증을 스태프를 귀찮게 하지 않고 풀 수 있는 빠른 방법이에요.

• 서버에서 모더레이션 기능이 켜져 있어야 해요. 꺼져 있으면 멤버에게 그렇다는 메시지가 나와요.
• 허용된 모더레이터 역할 설정은 무시해요. 역할이 필요 없어요.
• 텍스트 명령어 접두사를 설정했다면 !my-history도 되지만, 텍스트 답장은 본인에게만 보이게 할 수 없어요. 봇이 채널에 올리고 30초 뒤에 삭제해요.
• 기록이 없는 멤버에게는 "You have no moderation records on this server."(이 서버에는 모더레이션 기록이 없어요.)가 나와요.

패널에 있는 본인의 페이지 내 제재에는 모든 서버의 같은 기록이 나열돼요.

🧹 멤버의 끝난 기록 지우기: /clear-history

/clear-history는 서버에서 한 멤버의 더 이상 활성이 아닌 기록을 모두 삭제해요. 누군가 제재 기간을 마치고 기록을 깨끗이 하고 싶을 때 쓰세요.

1. 멤버에게 활성인 것이 없는지 확인하세요(아래 참고).
2. /clear-history를 입력하고 멤버의 사용자 ID를 user_id에 붙여 넣은 다음 Enter를 누르세요.
3. 봇이 Cleared N inactive records for @member(@member의 비활성 기록 N개를 지웠어요) 또는 No inactive records found for @member(비활성 기록이 없어요)라고 답해요.

이 작업은 되돌릴 수 없어요. 기록은 숨겨지는 것이 아니라 삭제돼요.

비활성으로 치는 것

활성인 기록은 건드리지 않아요. 멤버의 경고도 없애고 싶다면 먼저 패널에서 제거한 다음 /clear-history를 실행하세요.

사용할 수 있는 사람

다음이 모두 참이어야 해요.

• 서버에서 모더레이션 기능이 켜져 있다
• 그 사람이 Discord의 Ban Members 권한을 가지고 있다(참고: /history가 요구하는 Kick Members보다 높아요)
• 모더레이션 설정에서 *허용된 모더레이터 역할 (슬래시 명령어)*을 지정했다면, 그 역할 중 하나도 가지고 있다

패널에서 같은 작업

모더레이션 → 이력 탭에서 그 멤버의 끝난(활성이 아닌) 기록에 있는 모두 지우기를 클릭하고, 다시 클릭하여 확인이라고 나오면 한 번 더 클릭하세요. 그 멤버의 끝난 기록이 모두 지워져요. 명령어와 같은 삭제예요.

패널 버튼은 서버의 활동 로그에 한 줄("Cleared N inactive sanction(s)...")을 남기고, 모더레이션 로그 채널을 설정했다면 거기에도 올려요. /clear-history 명령어는 둘 다 하지 않아요. 활동 로그에 항목이 남지 않고 로그 채널에도 아무것도 올리지 않아요. 팀이 눈에 보이는 기록을 원한다면 패널 버튼을 쓰거나, 로그 채널에 직접 한 줄을 적어 두세요.

💡 예시

어떤 멤버가 3월에 경고를 두 번 받았고 4월에 하루 뮤트를 당했어요. 지금은 10월이고 그 뒤로 모범적으로 지냈어요.

1. /history user_id:123456789012345678은 MUTE(1d, 점 없음, 끝남), WARN 🔴, WARN 🔴를 보여 줘요.
2. 경고 두 개는 아직 🔴이므로 /clear-history만 쓰면 뮤트만 지워져요.
3. 패널에서 모더레이션 → 이력 탭을 열고 그 멤버를 찾아 각 경고 행의 제거를 클릭하세요.
4. 이제 /clear-history user_id:123456789012345678을 실행하세요. 봇이 Cleared 3 inactive records라고 답하고 멤버의 기록이 비워져요.

🔧 문제가 생겼을 때

🚨 "The Moderation feature is not enabled for this server"

패널에서 기능을 켠 다음 다시 시도하세요. 메시지에 링크가 들어 있어요.

🚨 "You do not have a role that is allowed to use moderation commands on this server"

서버가 모더레이션 명령어를 특정 역할로 제한하고 있어요. 관리자에게 *허용된 모더레이터 역할 (슬래시 명령어)*에 내 역할을 추가하거나 그 목록을 비워 달라고 요청하세요.

🚨 명령어 목록에서 /clear-history가 보이지 않아요

Discord는 Ban Members가 없는 사람에게는 이 명령어를 숨겨요. 서버 관리자는 서버 설정 → 연동 → YAWBDB(Server Settings → Integrations → YAWBDB)에서 누가 볼 수 있는지 바꿀 수도 있어요.

🚨 "No inactive records found"인데 /history에는 기록이 보여요

그 기록들은 아직 활성이에요. 먼저 패널에서 해제하거나 제거하세요(경고와 소프트밴은 수동으로만 제거돼요).

🚨 "Failed to clear history" 또는 "Server not registered in panel"

봇이 패널에 연결하지 못했거나, 서버가 패널에 연결되어 있지 않아요. 1분쯤 뒤에 다시 시도하세요. 서버가 새로 추가된 것이라면 먼저 연결을 끝내세요.

🚨 엉뚱한 멤버의 기록을 지웠어요

복원할 수 없어요. 직접 적어 둔 메모나 활동 로그를 바탕으로 기록을 다시 만드세요. 활동 로그에는 패널에서 지운 경우에만 한 줄이 남아요.

🚨 /my-history가 서버가 등록되지 않았다고 해요

위와 같은 원인이에요. 서버가 패널에 연결되어 있지 않아요.