PickGuardLink

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)

저장하는 정보

플러그인이 픽가드에 보내는 것: 마크 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

English

PickGuardLink connects your Minecraft server to PickGuard (https://guard.dicopick.com), a free Korean Discord management bot. With it:

• Players press the ⛏️ Get code button in your Discord verification channel, receive a private 6-digit code, and type /verify 123456 in-game. The Minecraft account and the Discord account are now linked. No Discord slash command needed.
• On verification, PickGuard can add/remove roles and set the Discord nickname to the Minecraft name.
• For unverified players choose allow · kick with a code · freeze at a waiting spot. Freeze mode teleports them to a spot you set, shows a title telling them to verify, blocks movement/chat/blocks/items/combat (each toggleable), and releases them the moment they verify — back to where they were.
• Admins look up who is who and which other accounts share an IP from Discord, in-game or the dashboard.
• Alt-account approval: when an already-verified person verifies a second Minecraft account, an approval request goes to the admins (1–5 alts per person).
• Address spoof protection: during "Verify connection" the plugin briefly changes the server-list max player count to a check number, so the dashboard can confirm the address you entered really is the server running the plugin.
• Optional (enabled from the dashboard): Discord ↔ Minecraft chat bridge, live player-count channel, role ↔ Minecraft permission commands (only when allow-remote-commands: true in config.yml), server-down alerts.

This plugin requires an external service. It only works together with the PickGuard Discord bot and a pairing code from the dashboard (guard.dicopick.com). Bot, dashboard and plugin are free. The plugin talks over HTTPS to guard.dicopick.com/api/mc/v1 only; what it sends is listed under "Data" below.

Requirements

• A Discord server with the PickGuard bot (invite from https://guard.dicopick.com)
• Spigot · Paper · Purpur 1.8.8 – 26.3 or Folia, Java 8+ (8u141+ recommended for TLS)
• Not supported yet: Forge · Fabric · BungeeCord · Velocity (behind a proxy the address check may fail)

Install in 3 steps

1. Dashboard → Minecraft → Verification plugin: enter your server address and press Check server. Drop PickGuardLink.jar into plugins/ and restart.
2. Press Create pairing code on the dashboard and run pickguard link PG-XXXX-XXXX in the server console (one use, valid 10 minutes; OPs can run /pickguard link in-game).
3. Press Verify connection on the dashboard. When it shows "Connected · ✅ address verified", pick a verification channel and press Post panel. Players can now verify.

Commands (from plugin.yml)

Data

Sent to PickGuard: Minecraft UUID, name and name history, first/last join, join count, join IP (per-server setting: raw · hashed · not stored; retention 1–365 days, default 90). Visible only to admins of that Discord server; never shared across servers. The token is never written to logs. Details: https://guard.dicopick.com/privacy

FAQ

• Can I use the plugin without the bot? No. Codes, roles and records live in the PickGuard bot and dashboard. Before pairing, every command except pickguard link just says the server is not linked yet.
• What if PickGuard is unreachable? By default (fail-open: true, dashboard setting wins) unverified players are let in. In kick/freeze mode, players verified within the last 7 days still pass.
• I use AuthMe or another login plugin. Add login and register to "Commands allowed before verification" on the dashboard so frozen players can still log in.

Links

• Guides: https://guard.dicopick.com/guide/discord-minecraft-verify · https://guard.dicopick.com/guide/minecraft-server-plugins (Korean)
• Get started: https://guard.dicopick.com/setup/link
• Resource page (pickmc.kr): https://pickmc.kr/resources/pickguardlink
• Discord: https://discord.gg/Jf6fdj8FuA