| 장르 | 서버 관리자 툴 |
|---|---|
| 게임버전 | 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 26.1, 26.2, 26.3 |
| API | 버킷 |
| 원산지 | 국산 |
| 개발자 | PickGuard |
| 저작권 | All Rights Reserved |
| 자료 출처 | https://pickmc.kr/resources/pickguardlink |
📌 2026-10-25 1.3.3 업데이트 — 게임 안 /신고(디스코드로 전달) · /랭킹(플레이타임, 기본 꺼짐) · PlaceholderAPI 지원(%pickguard_linked% 등) · 디스코드 공지를 게임 채팅으로 받기(기본 꺼짐). 1.8.8 ~ 26.3 실서버 확인.
PickGuardLink 는 디스코드 관리봇 픽가드(https://guard.dicopick.com) 와 마인크래프트 서버를 잇는 플러그인이에요. 넣고 나면 이런 게 돼요.
- 플레이어가 디스코드 인증 채널의 ⛏️ 코드 발급받기 버튼으로 6자리 코드를 받아, 게임 채팅에 /인증 123456 을 치면 마크 계정과 디스코드 계정이 이어져요. 디스코드에서는 명령어 없이 버튼만 누르면 돼요.
- 인증하면 정해 둔 역할을 주고 · 빼고, 디스코드 닉네임을 마크 닉네임으로 바꿀 수 있어요.
- 인증 안 한 사람은 그대로 들어오게 · 접속 막기 · 대기 장소에 묶어 두기 중에 골라요. 묶어 두기(인증 대기 모드)는 접속하자마자 정해 둔 자리에 묶이고 화면 가운데 안내가 떠요. /인증 으로 코드를 넣으면 바로 풀리고 원래 있던 곳으로 돌아가요.
- 관리자는 디스코드 · 게임 · 대시보드에서 누가 누구인지, 같은 IP 로 들어온 다른 계정이 있는지 조회해요.
- 부계정 승인제: 이미 인증한 사람이 다른 마크 계정으로 또 인증하면 관리자에게 승인 요청이 가요 (한 사람당 1~5개).
- 서버 주소 사칭 방지: 연결 확인 때 서버 목록의 최대 인원을 잠깐 확인 숫자로 바꿔 "입력한 주소 = 플러그인이 깔린 서버" 인지 확인해요.
- 선택 기능(대시보드에서 켬): 디스코드 ↔ 마크 채팅 연결, 실시간 인원 표시 채널, 역할 ↔ 마크 권한 명령(allow-remote-commands: true 일 때만), 서버 꺼짐 알림.
이 플러그인은 외부 서비스가 필요해요. 픽가드 봇이 들어 있는 디스코드 서버와 대시보드(guard.dicopick.com)에서 만든 연결 코드가 있어야 동작해요. 봇 · 대시보드 · 플러그인 모두 무료예요. 플러그인은 HTTPS 로 guard.dicopick.com/api/mc/v1 에만 접속하고, 보내는 정보는 아래 "저장하는 정보" 에 적어 두었어요.
필요한 것
- 픽가드 봇이 있는 디스코드 서버 (초대: https://guard.dicopick.com)
- Spigot · Paper · Purpur 1.8.8 ~ 26.3 또는 Folia, Java 8 이상 (8u141 이상 권장)
- Forge · Fabric · BungeeCord · Velocity 는 아직 지원하지 않아요 (프록시 뒤 서버에 넣으면 주소 확인이 안 될 수 있어요)
설치 3단계
1. 대시보드 → 마인크래프트 → 접속 인증 플러그인에서 서버 주소를 넣고 서버 확인. PickGuardLink.jar 를 plugins/ 에 넣고 서버를 다시 켜요.
2. 대시보드에서 연결 코드 만들기 → 서버 콘솔에 pickguard link PG-XXXX-XXXX (10분 안에 한 번만 쓸 수 있어요. OP 는 게임에서 /pickguard link 도 돼요).
3. 대시보드에서 연결 확인 → "연결됨 · ✅ 주소 확인됨" 이 되면 끝. 이어서 인증 채널을 고르고 패널 올리기를 누르면 플레이어가 인증할 수 있어요.
명령어 (plugin.yml)
명령 · 별칭 · 누가 · 하는 일
/인증 <코드 6자리> · /verify /pgverify /마크인증 · 모두 · 디스코드에서 받은 코드로 인증. 코드 없이 치면 인증 방법 안내
/인증 관리 <마크닉> · — · pickguard.admin · 콘솔 · 플레이어 조회 (UUID · 디스코드 · 접속 기록 · 최근 IP · 같은 IP 계정 · 닉네임 기록)
/디스코드 · /discord /디코 · 모두 · 디스코드 서버 입장 링크
/pickguard link <코드> · /pg · pickguard.admin · 콘솔 · 디스코드 서버와 연결
/pickguard status · · 〃 · 연결 상태 · 설정 · 대기 중 인원
/pickguard unlink · · 〃 · 연결 끊기 (토큰 삭제)
/pickguard reload · · 〃 · config.yml 다시 읽기
/pickguard setspawn · · pickguard.admin (게임) · 서 있는 곳을 인증 대기 장소로 (대시보드에도 저장)
/pickguard freeze-test · · pickguard.admin (게임) · 대기 모드 화면 미리 보기 (한 번 더 치면 해제)
/pickguard markpick <토큰> · · 〃 · 픽마크(pickmc.kr)에 등록한 서버의 주인 인증
권한 · 기본 · 설명
pickguard.admin · OP · /pickguard 전체, /인증 관리
pickguard.bypass · OP · 인증 대기 모드에 묶이지 않아요
저장하는 정보
플러그인이 픽가드에 보내는 것: 마크 UUID · 닉네임 · 닉네임 변경 기록 · 최초/마지막 접속 · 접속 횟수 · 접속 IP(서버 설정: 원문 · 해시 · 저장 안 함, 보관 1~365일 기본 90일). 그 디스코드 서버의 관리자만 볼 수 있고 다른 서버와 나누지 않아요. 토큰은 로그에 남기지 않아요. 자세한 건 https://guard.dicopick.com/privacy
자주 묻는 질문
- 봇 없이 플러그인만 쓸 수 있나요? 아니요. 인증 코드 · 역할 · 기록이 모두 픽가드 봇과 대시보드에 있어요. pickguard link 말고는 연결 전엔 "아직 디스코드 서버와 연결되지 않았어요" 라고만 나와요.
- 픽가드 서버가 잠깐 안 되면요? 기본(fail-open: true · 대시보드 설정 우선)은 인증 안 한 사람도 들여보내요. 접속 막기 · 대기 모드에서도 최근 7일 안에 인증 확인된 사람은 통과해요.
- AuthMe 같은 로그인 플러그인과 같이 쓰면요? 대시보드 "인증 전에도 쓸 수 있는 명령어" 에 login · register 를 넣으면 대기 중에도 로그인할 수 있어요.
링크
- 가이드: https://guard.dicopick.com/guide/discord-minecraft-verify · https://guard.dicopick.com/guide/minecraft-server-plugins
- 시작하기: https://guard.dicopick.com/setup/link
- 픽마크 자료 페이지: https://pickmc.kr/resources/pickguardlink
- 공식 디스코드: https://discord.gg/Jf6fdj8FuA
댓글이 없습니다.
새로운 댓글을 등록해 주세요!