디스코드 마인크래프트 인증 연동하는 법 (플러그인)

업데이트: 2026-10-05 · 읽는 데 약 8분

마인크래프트 서버와 디스코드 서버를 같이 운영하면 "이 마크 닉네임이 디스코드의 누구인지" 알기 어려워요. 픽가드의 ⛏️ 마인크래프트 인증 연동을 쓰면 마크 서버에 플러그인 하나만 넣고, 플레이어가 게임에서 받은 6자리 코드를 디스코드 인증 채널의 ⛏️ 마크 인증하기 버튼을 눌러 입력하는 것만으로 마크 계정과 디스코드 계정을 이어 줘요. 인증하면 역할과 닉네임을 자동으로 주고, 관리자는 누가 누구인지, 같은 IP 로 들어온 다른 계정이 있는지 한 번에 확인할 수 있어요.

⚡ 바로 설정하고 싶다면: 사용법 · 마인크래프트 인증 연동

1. 이렇게 동작해요

1. 관리자가 마크 서버에 PickGuardLink 플러그인을 넣고, 대시보드에서 만든 연결 코드로 디스코드 서버와 이어요. 서버마다 한 번만 하면 돼요.
2. 관리자가 대시보드에서 마크 인증 채널을 고르고 패널 올리기를 눌러요. 그 채널에 인증 방법과 ⛏️ 마크 인증하기 버튼이 달린 안내가 올라가요.
3. 플레이어가 마크에서 /인증 을 입력하면 6자리 숫자 코드가 나와요.
4. 디스코드 인증 채널에서 ⛏️ 마크 인증하기 버튼을 누르고 그 숫자를 넣으면 인증 끝이에요. 명령어를 몰라도 돼요. 정해 둔 역할과 닉네임을 받고, 게임 안에도 "✅ 디스코드 인증 완료" 알림이 떠요.

코드는 그 마크 서버에 직접 접속한 사람에게만 나와서, 디스코드에서 남의 마크 닉네임을 적어 흉내 낼 수 없어요. 한 서버에서 마크 계정 하나는 디스코드 계정 하나와만 이어져요. 원하면 인증하지 않은 사람을 인증할 때까지 대기 장소에 묶어 둘 수도 있어요 (인증 대기 모드).

2. 지원하는 서버와 버전

서버의 자바는 8 이상이면 돼요. 프록시 뒤에 있는 하위 서버(Spigot · Paper)에 넣으면 연결 확인에서 "정보가 달라요"가 나올 수 있어요. 이때는 아래 자주 묻는 질문을 보세요.

3. 마인크래프트 서버 연결하기

디스코드 서버에서 서버 관리 권한이 있는 사람이, 마크 서버의 콘솔(또는 OP 계정)을 쓸 수 있을 때 해요.

1. 화면 열기 — 대시보드에서 서버를 고르고 왼쪽 메뉴 API → 마인크래프트 인증 API를 눌러요.
2. 서버 주소 확인 — 플레이어가 접속할 때 쓰는 주소(예: play.example.com 또는 play.example.com:25566)를 넣고 서버 확인을 눌러요. 포트를 빼면 25565 를 쓰고, SRV 레코드로 연결된 주소도 찾아요. 서버가 켜져 있으면 버전 · 접속 인원 · MOTD 가 보여요.
3. 플러그인 설치 — 플러그인 받기 버튼(또는 PickGuardLink.jar)으로 받은 파일을 서버의 plugins 폴더에 넣고 서버를 다시 켜요.
4. 연결 코드 넣기 — 대시보드에서 연결 코드 만들기를 누르면 PG-XXXX-XXXX 모양의 코드가 나와요. 10분 안에 한 번만 쓸 수 있어요. 서버 콘솔에 이렇게 입력해요. 게임 안에서는 OP 계정으로 /pickguard link 코드 를 써도 돼요.

   pickguard link PG-ABCD-2345

5. 연결 확인 — 대시보드에서 연결 확인을 눌러요. 플러그인이 2분 안에 신호를 보냈고, 입력한 주소로 조회한 서버 정보(최대 인원 · 버전 · MOTD)가 플러그인이 알려 준 정보와 같으면 연결됨이 돼요. 그때부터 설정과 인증한 사람 목록이 열려요. 이어서 인증 채널과 패널을 준비해요.

화면 위쪽에는 지금 상태가 보여요: 연결 안 됨(주소나 코드가 아직 없음) · 플러그인 기다리는 중(코드는 넣었지만 확인 전) · 연결됨 · 정보가 달라요(주소의 서버와 플러그인 서버가 달라 보임).

왜 주소를 확인하나요? 대시보드에 적은 주소의 서버와 플러그인이 깔린 서버가 같은 서버인지 확인해서, 엉뚱한 서버와 이어지는 실수를 막아요. 같은 서버가 맞는데 프록시 때문에 정보가 다르게 보인다면, 서버 주인이나 관리자 권한이 있는 사람이 그래도 연결을 눌러 넘어갈 수 있어요.

4. 인증 설정 고르기

연결된 뒤 같은 화면에서 고르고, 아래 저장을 눌러요.

• 마인크래프트 인증 사용 — 꺼 두면 플레이어가 인증할 수 없어요.
• 마크 인증 채널 — 인증 패널을 올릴 채널이에요. 아래 5. 인증 채널과 패널 올리기를 보세요.
• 인증하면 줄 역할 · 뺄 역할 — 예: @마크 인증 을 주고 @미인증 을 빼요. 픽가드 역할이 그 역할보다 위에 있어야 해요. (봇 권한 가이드)
• 닉네임 바꾸기 — 안 바꿈 · 마크닉 · 디코이름 (마크닉) 중에 골라요 (32자까지). 서버 주인과 픽가드보다 역할이 높은 사람은 바꿀 수 없어서 건너뛰고 알려 줘요.
• 인증 안 한 사람은 — 그대로 들어오게(기본) · 접속 막기 · 대기 장소에 묶어 두기 (추천) 중에 골라요. 접속 막기는 인증하지 않은 플레이어가 접속할 때 새 코드가 적힌 안내와 함께 막아요. 인증 채널을 정했다면 "디스코드 #마크-인증 채널에서 [마크 인증하기] 버튼을 누르고 123456 을 입력하세요" 처럼 그 채널과 버튼으로 안내하고, 정하지 않았다면 /마크인증 코드 로 안내해요. 대기 장소에 묶어 두기는 아래 6. 인증 대기 모드를 보세요. 픽가드에 잠깐 연결할 수 없을 때는 기본으로 들여보내요.
• 코드 유효 시간 — 1~60분 (기본 10분).
• 다른 마크 계정으로 옮기기 — 켜 두면(기본) 디스코드 계정 하나가 다른 마크 계정으로 다시 인증할 때 예전 연결을 풀고 옮겨요.
• 접속 IP 저장 — 원문(기본) · 해시(원래 IP 는 알 수 없고 같은 IP 인지만 비교) · 저장 안 함 중에 고르고, 보관 기간(1~365일, 기본 90일)을 정해요.
• 기록 채널 — 인증 · 해제를 알릴 운영진 채널.
• 조회할 수 있는 운영진 역할 — 서버 관리 권한이 없어도 /마크인증 조회 를 쓸 수 있는 역할.

5. 인증 채널과 패널 올리기

플레이어가 명령어를 몰라도 버튼 하나로 인증할 수 있게, 인증할 채널을 정하고 안내 패널을 올려요. 서버 관리 권한이 있는 사람이 해요.

1. 채널 고르기 — 같은 화면 설정의 마크 인증 채널에서 채널을 골라요 (예: #마크-인증). 픽가드에게 그 채널의 채널 보기 · 메시지 보내기 · 링크 첨부 권한이 있어야 해요.
2. 패널 올리기 — 패널 올리기를 누르면 그 채널에 ⛏️ 마인크래프트 계정 인증 안내가 올라가요. 디스코드에서 /마크인증 패널 의 채널에 인증 채널을 골라 올려도 돼요.
3. 패널 확인하기 — 패널에는 인증 순서와 버튼 두 개가 있어요.
   • ① 마크 서버 play.example.com 접속 → ② 채팅에 /인증 → ③ 아래 [마크 인증하기] 버튼을 눌러 6자리 숫자 입력
   • ⛏️ 마크 인증하기 — 6자리 숫자를 넣는 창이 열려요.
   • 내 인증 상태 — 지금 이어진 마크 계정을 나만 보이게 보여 줘요.

인증 채널을 정하면 이렇게 바뀌어요.

• 게임 속 /인증 안내가 "디스코드 #마크-인증 채널에서 [마크 인증하기] 버튼을 누르고 123456 을 입력하세요 (10분 안에)" 로 바뀌어요. 접속 막기나 대기 장소에 묶어 두기를 골랐다면 그때 나오는 안내도 그 채널과 버튼으로 알려 줘요.
• /마크인증 코드 는 인증 채널 안에서만 돼요. 다른 채널에서 쓰면 인증 채널로 가는 링크를 나만 보이게 알려 줘요.
• 패널을 다시 올리면 예전 패널은 지우고 새로 올려요. 패널을 지웠거나 서버 주소를 바꿨다면 다시 올려 주세요. 봇을 다시 켜도 예전 패널 버튼은 그대로 돼요.

팁: 인증 채널에서 멤버의 메시지 보내기를 꺼 두면 패널이 대화에 묻히지 않아요. 버튼은 메시지 보내기 권한이 없어도 눌려요. 다만 채널 보기 · 메시지 기록 보기는 남겨 두세요. @미인증 같은 역할로 다른 채널을 가려 두었다면 인증 채널만은 보이게 열어 두세요.

6. 인증 대기 모드

인증하지 않은 사람이 서버를 돌아다니지 못하게, 인증할 때까지 관리자가 정한 대기 장소에 묶어 두는 모드예요. 접속을 막는 것과 달리 게임 안에서 바로 /인증 을 할 수 있고, 디스코드에서 인증하면 몇 초 안에 풀려서 추천해요.

플레이어에게는 이렇게 보여요

• 접속하면 대기 장소로 옮겨지고, 화면 가운데에 큰 글씨로 디스코드 인증을 진행해주세요, 그 아래 /인증 을 입력하세요 가 계속 떠요. 채팅에는 인증 코드가 바로 나와요 (1.9 이상은 핫바 위 알림줄에도 안내가 떠요).
• 움직이면 대기 장소로 되돌아가요. 고개는 돌릴 수 있어요.
• /인증 (/verify · /마크인증) 말고 다른 명령어를 치면 "인증 전에는 /인증 만 쓸 수 있어요" 라고 막아요.
• 기본으로 일반 채팅 · 블록 부수기 · 놓기 · 문 · 상자 누르기 · 아이템 버리기 · 줍기 · 인벤토리 옮기기 · 때리기를 막아요. 대기 중에는 맞지도 않고 배고픔도 줄지 않아요.
• 디스코드에서 인증하면 몇 초 안에 풀려요. 레벨업 소리와 함께 "✅ 인증 완료! 이제 자유롭게 플레이하세요" 가 뜨고, 대기 장소로 오기 전에 있던 곳으로 돌아가요.

켜는 법

1. 모드 고르기 — 대시보드 → API → 마인크래프트 인증 API의 🚪 인증 안 한 사람은 에서 대기 장소에 묶어 두기 (추천) 를 골라요. 다른 선택지는 그대로 들어오게(기본)와 접속 막기(새 코드 안내와 함께 튕기기)예요. 위 설정의 마인크래프트 인증 사용이 켜져 있어야 동작해요.
2. 대기 장소 정하기 — 마크 서버에서 OP(또는 pickguard.admin) 계정으로 원하는 자리에 서서 /pickguard setspawn 을 입력해요. 서 있는 곳과 바라보는 방향이 저장되고 대시보드에도 저절로 들어와요 (대시보드의 지금 불러오기). 좌표 직접 입력에서 월드 이름 · X · Y · Z · 방향을 숫자로 넣어도 돼요. 좌표는 게임에서 F3 을 누르면 보여요. 정하지 않으면 첫 번째 월드의 기본 스폰을 써요.
3. 문구 확인하고 저장 — 필요하면 화면 가운데 안내의 큰 글씨 · 작은 글씨(각 64자까지)를 바꾸고, 미리보기 · 게임 화면에서 어떻게 보일지 본 뒤 저장해요. 마크 서버에는 1분 안에 적용돼요.
4. 직접 미리 보기 — 관리자는 대기 모드에 묶이지 않아요. 게임에서 /pickguard freeze-test 를 입력하면 플레이어가 보는 화면을 그대로 볼 수 있고, 한 번 더 입력하면 풀려요.

인증이 풀리면 다시 묶어요

게임에 접속해 있는 사람의 연결이 풀리면 — 본인이 /마크인증 해제, 관리자가 해제, 같은 디스코드 계정으로 다른 마크 계정을 인증해 옮김, 대시보드에서 기록 삭제 — 10초 안에 다시 대기 모드가 돼요.

• 화면에 인증이 해제됐어요 / /인증 으로 다시 인증해 주세요 가 뜨고 채팅으로도 알려 줘요.
• 대기 장소로 옮겨지고, 이동 · 명령어 제한이 다시 걸려요.
• 다시 인증하면 풀리고, 해제됐을 때 있던 곳으로 돌아가요.
• 접속 막기를 골랐다면 접속 중인 사람을 바로 튕기지는 않고 채팅으로만 알려요. 다음 접속부터 막혀요.

효과음

플레이어가 화면을 보지 않아도 알 수 있게 소리가 나요. 서버 버전(1.8.8 ~ 26.3)에 맞는 소리를 알아서 골라요.

소리는 그 플레이어에게만 들리고, 막혔을 때 · 코드를 받을 때 소리는 같은 사람에게 1초에 한 번까지만 나요. 서버 관리자는 플러그인 config.yml 의 sounds: 에서 소리를 끄거나 다른 소리 · 크기 · 높낮이로 바꿀 수 있어요.

알아 두세요

• OP 와 pickguard.bypass 권한이 있는 사람은 묶지 않아요. 권한 플러그인(LuckPerms 등)으로 운영진에게 pickguard.bypass 를 주면 돼요.
• 대기 장소는 막힌 방처럼 안전한 곳으로 정하세요. 용암 · 공허 위나 몹이 나오는 곳은 피하고, 스폰 보호 구역 안이면 더 좋아요.
• Spigot · Paper · Purpur 1.8.8 ~ 26.3 과 Folia 에서 모두 돼요. 화면 가운데 글씨를 띄울 수 없는 서버에서는 채팅으로 알려요.

7. 플레이어가 인증하는 법

1. 마크 서버에서 /인증 을 입력해요 (/verify · /마크인증 도 돼요). "디스코드 #마크-인증 채널에서 [마크 인증하기] 버튼을 누르고 123456 을 입력하세요 (10분 안에)" 처럼 코드가 나와요. 인증 채널을 정하지 않은 서버라면 "디스코드에서 /마크인증 코드 123456 을 입력하세요" 로 나와요.
2. 디스코드 마크 인증 채널로 가서 패널의 ⛏️ 마크 인증하기 버튼을 누르고, 열린 창에 6자리 숫자를 넣어 보내요. 인증 채널 안에서는 /마크인증 코드 의 숫자 칸에 넣어도 돼요 (영어 디스코드: /mcverify code).
3. 나만 보이는 ✅ 인증 완료 카드에 마크 닉네임 · 머리 그림 · 받은 역할이 보여요. 잠시 뒤 게임 안에도 "✅ 디스코드 인증 완료" 알림이 떠요.

• 서버가 인증 대기 모드를 쓰면 접속하자마자 대기 장소로 옮겨지고 화면에 안내가 떠요. 채팅에 나온 코드(안 보이면 /인증)를 디스코드에 넣으면 몇 초 안에 풀려요.
• 코드를 받으면 "띠링", 인증이 끝나면 레벨업 소리가 나요.
• 이미 인증했다면 /인증 이 연결된 디스코드 이름을 보여 줘요. 새 코드가 필요하면 /인증 다시 를 입력해요.
• 디스코드 패널의 내 인증 상태 버튼으로 지금 이어진 마크 계정을 언제든 볼 수 있어요.
• 새 코드를 받으면 예전 코드는 바로 못 써요. 디스코드에서 코드를 10분 안에 5번 틀리면 잠시 기다렸다가 다시 해야 해요.

8. 계정 조회와 인증 해제

• 디스코드 — /마크인증 조회 의 대상에 마크 닉네임 · UUID · @유저 중 하나를 넣어요. 서버 관리 권한이나 지정한 운영진 역할이 있어야 하고, 결과는 나만 보여요.
• 마크 서버 — /인증 관리 마크닉 (권한 pickguard.admin, 기본은 OP · 콘솔에서도 돼요).
• 대시보드 — 인증한 사람 목록을 검색하고 자세히 볼 수 있어요. IP 는 눌러야 보여요. 서버에 들어온 모든 플레이어 목록도 인증 여부로 걸러 봐요.

조회하면 마크 닉네임 · UUID · 연결된 디스코드 · 최초 접속 · 마지막 접속 · 접속 횟수 · 인증 시각 · 최근 접속 IP(최대 5개) · 같은 IP 로 들어온 다른 계정 · 닉네임 변경 기록을 한 번에 보여 줘요.

주의: 가족 · 친구 · PC방 · 학교처럼 같은 인터넷을 쓰면 다른 사람도 IP 가 같을 수 있어요. 같은 IP 계정은 부계정을 의심해 볼 단서일 뿐이니, 이것만 보고 처벌하지 마세요.

• 인증 해제 — 본인은 /마크인증 해제, 관리자는 /마크인증 해제 유저:@이름 이나 대시보드에서 풀어요. 확인 버튼을 한 번 더 눌러야 해요. 인증 대기 모드를 쓰는 서버라면 접속 중인 사람은 10초 안에 다시 대기 장소로 옮겨져요.
• 플러그인 명령 — 콘솔에서 pickguard status(연결 상태) · pickguard unlink(연결 끊기) · pickguard reload(설정 다시 읽기). 게임 안에서 /pickguard setspawn(대기 장소 정하기) · /pickguard freeze-test(대기 모드 미리 보기).
• 연결 끊기 · 모든 데이터 삭제 — 대시보드 맨 아래에 있어요. 연결 끊기는 플러그인 연결만 풀고, 모든 데이터 삭제는 서버 주인만 할 수 있으며 되돌릴 수 없어요.

9. 저장하는 정보와 개인정보

• 픽가드는 플러그인이 보낸 마크 UUID · 닉네임 · 닉네임 변경 기록 · 최초 접속 · 마지막 접속 · 접속 횟수 · 접속 IP(서버 설정에 따라)와, 인증한 디스코드 ID · 이름 · 인증 시각을 저장해요.
• 접속 기록은 정한 기간(기본 90일)이 지나면 자동으로 지워요. 인증을 해제하면 연결 정보도 지워져요.
• 이 정보는 그 서버의 관리자만 볼 수 있고, 다른 디스코드 서버와 나누지 않아요.
• 플레이어가 미리 알 수 있게, 서버 규칙이나 공지에 "디스코드 인증 연동으로 접속 기록을 남긴다"고 적어 두세요.

자세한 내용은 개인정보 처리방침 · 마인크래프트 인증 연동에 있어요.

자주 묻는 질문

연결 확인을 누르면 '정보가 달라요'라고 나와요.

입력한 주소로 조회한 서버 정보(최대 인원 · 버전 · MOTD)가 플러그인이 알려 준 정보와 달라서 그래요. 화면에 다른 항목이 함께 보여요. 주소를 잘못 적었다면 고치고, 플러그인을 넣은 서버가 맞는지 확인하세요. BungeeCord · Velocity 같은 프록시 뒤의 서버라면 프록시의 정보가 보여 다를 수 있어요. 같은 서버가 맞다면 서버 주인이나 관리자 권한이 있는 사람이 그래도 연결을 누르면 돼요.

마크에서 /인증 을 쳤는데 '아직 디스코드 서버와 연결되지 않았어요'라고 나와요.

플러그인에 연결 코드를 아직 넣지 않았거나, 대시보드에서 연결을 끊은 거예요. 대시보드 → API → 마인크래프트 인증 API에서 연결 코드를 새로 만들고, 서버 콘솔에 pickguard link 코드 를 입력하세요. 연결 코드는 10분 안에 한 번만 쓸 수 있어요.

디스코드에서 /마크인증 명령어가 안 보여요.

명령어 없이 마크 인증 채널의 ⛏️ 마크 인증하기 버튼을 누르고 6자리 숫자를 넣으면 돼요. 패널이 없다면 운영진이 대시보드 → API → 마인크래프트 인증 API에서 인증 채널을 고르고 패널 올리기를 눌러 주세요. 명령어도 쓰고 싶다면 디스코드를 Ctrl+R(휴대폰은 앱 재시작)로 새로고침하고, 서버 설정 → 연동 → 픽가드에서 명령어가 막혀 있지 않은지 확인하세요.

/마크인증 코드 를 쳤더니 인증 채널에서 하라고 나와요.

운영진이 마크 인증 채널을 정해 두면 코드는 그 채널에서만 넣을 수 있어요. 안내의 채널 링크를 눌러 이동한 뒤 ⛏️ 마크 인증하기 버튼을 누르거나, 그 채널에서 /마크인증 코드 를 다시 입력하세요.

인증했는데 대기 장소에서 안 풀려요.

디스코드에서 인증하면 보통 몇 초 안에 풀려요. 10초가 지나도 그대로라면 디스코드에 ✅ 인증 완료 카드가 떴는지 확인하세요. 코드가 틀렸거나 시간이 지났다면 게임에서 /인증 다시 로 새 코드를 받아 다시 넣어요. 그래도 안 되면 픽가드에 잠깐 연결이 안 되는 것일 수 있으니 잠시 뒤 다시 접속해 보세요.

로그인 플러그인(AuthMe 등)을 같이 쓰는데 대기 중에 /login 이 막혀요.

대시보드 → API → 마인크래프트 인증 API의 인증 전에도 쓸 수 있는 명령어에 login · register 를 넣고 저장하세요. 1분 안에 마크 서버에 적용돼요.

인증을 해제했더니 게임에서 다시 대기 장소로 옮겨졌어요.

인증 대기 모드를 쓰는 서버에서는 연결이 풀리면(본인 해제 · 관리자 해제 · 다른 마크 계정으로 옮김 등) 접속 중이어도 10초 안에 "인증이 해제됐어요" 안내와 함께 다시 대기 장소로 옮겨져요. /인증 으로 다시 인증하면 풀리고, 해제됐을 때 있던 곳으로 돌아가요.

인증 패널이 안 올라가요.

픽가드에게 인증 채널의 채널 보기 · 메시지 보내기 · 링크 첨부 권한이 있는지 확인하세요. 채널이나 카테고리 권한에서 픽가드 역할이 막혀 있으면 올릴 수 없어요. 권한을 고친 뒤 패널 올리기를 다시 누르면 돼요.

서버 확인을 누르면 서버에 접속할 수 없다고 나와요.

서버가 켜져 있는지, 주소와 포트가 맞는지, 방화벽이나 공유기에서 포트가 열려 있는지 확인하세요. 포트를 빼면 25565 를 써요. 192.168.x.x 나 localhost 같은 내부 주소는 바깥에서 들어올 수 없어서 확인할 수 없어요. 플레이어가 접속할 때 쓰는 주소를 넣어 주세요.

다른 마크 계정으로 다시 인증하고 싶어요.

새 마크 계정에서 /인증 으로 코드를 받아 디스코드 인증 채널의 ⛏️ 마크 인증하기 버튼(또는 /마크인증 코드)으로 넣으면 돼요. 예전 연결은 풀리고 새 계정으로 옮겨져요. 관리자가 계정 옮기기를 꺼 두었다면 먼저 /마크인증 해제 로 연결을 푸세요. 그 마크 계정이 이미 다른 디스코드 계정과 이어져 있다면 관리자에게 해제를 부탁해야 해요.

Forge · Fabric · BungeeCord · Velocity 서버에서도 되나요?

아직 안 돼요. 지금은 Spigot · Paper · Purpur 1.8.8 ~ 26.3 (최신) 과 Folia 서버에 넣는 플러그인만 있어요. 모드 서버(Forge · Fabric)와 프록시(BungeeCord · Velocity)용은 아직 없어요.