**PickGuardPunish** 를 넣으면 OP 가 게임에서 경고 · 임시 차단 · 영구 차단을 주고, 픽가드가 그 기록을 디스코드 서버마다 모아 둬요. - 처벌할 때마다 **마크 채팅**과 **디스코드 처벌 기록 채널**에 대상 · 처리자 · 사유 · 일시를 알려요. - **접속하지 않은 사람**도 닉네임으로 처벌할 수 있어요. - 모든 차단은 **마크 계정(UUID) · 닉네임 · IP** 를 같이 막아요. 따로 IP 차단 명령은 없어요. 연결된 모든 마크 서버에 똑같이 적용돼요. - 그 사람이 디스코드 인증으로 이어 둔 본계정 · 부계정도 함께 막아요. - IP 는 원문을 저장하지 않고 알아보는 키만 저장해요. 대시보드 · 디스코드 · 마크 어디에도 IP 를 보여 주지 않아요. - **확인 코드**: 같은 IP 로 같이 막히는 계정이 3개 이상이거나 운영진 계정이 끼어 있으면 목록과 4글자 코드가 나오고, `/처벌확인 AB12` 처럼 60초 안에 쳐야 실행돼요. 실수로 여러 명을 막는 걸 줄여요. - **경고 누적 자동 차단**(기본 꺼짐): 추천 = 3회 1일 · 5회 7일 · 7회 영구, 또는 엄격 · 직접 단계. - **디스코드 연동**(기본 꺼짐, 관리자만 켬): 마크 차단 → 디스코드 차단, 마크 해제 → 디스코드 해제, 디스코드 차단 → 마크 차단, 디스코드 해제 → 마크 해제, 마크 경고를 디스코드 경고 기록에도 남기기. - 대시보드에서도 차단 · 해제 · 경고 · 경고 취소를 할 수 있어요 (사유 200자까지). 차단 목록 · 경고 목록 · 기록, 접속 막힘 화면 안내, IP 막기 기간, 경고 유효 기간도 대시보드에서 정해요. - 인증하지 않은 사람을 자동으로 내보내거나 정리하는 기능은 **없어요**. 차단된 사람만 막아요. **이 플러그인은 외부 서비스가 필요해요.** 픽가드 봇 + 같은 서버의 **PickGuardLink 1.2.0 이상**이 있어야 하고, 연결 토큰은 PickGuardLink 것을 같이 써요 (따로 연결할 필요 없어요). 봇이 디스코드 서버에 없거나, 대시보드에서 껐거나, 연결 확인 전이면 명령 · 접속 막기 · 공지가 모두 멈춰요. #### 필요한 것 - 픽가드 봇이 있는 디스코드 서버 + PickGuardLink 1.2.0 이상 (연결 확인까지 끝난 상태) - Spigot · Paper · Purpur 1.8.8 ~ 26.3 또는 Folia, Java 8 이상 #### 설치 3단계 1. PickGuardLink 로 마크 서버를 먼저 연결해 두세요 (연결 확인까지). 2. 대시보드 → **마인크래프트 → 경고 · 차단 플러그인**에서 `PickGuardPunish.jar` 를 받아 `plugins/` 에 넣고 서버를 다시 켜요. 3. 플러그인 신호가 대시보드에 보이면 **시스템 사용**을 켜요. 공지 · 기록 채널, 디스코드 연동, 경고 단계는 같은 화면에서 정해요. #### 명령어 (plugin.yml — 모두 OP · 콘솔 전용) | 명령 | 영어 별칭 | 하는 일 | |---|---|---| | `/경고 <닉네임> <사유>` | `/pgwarn` | 경고 | | `/경고취소 <닉네임> [경고 번호]` | `/pgunwarn` | 경고 취소 | | `/경고확인 <닉네임>` | `/pgwarns` | 경고 · 차단 기록 보기 | | `/임시차단 <닉네임> <기간> <사유>` | `/pgtempban` | 기간 차단 (계정 · 닉네임 · IP). 기간: `30분` `12시간` `7일` `2주` `1개월` `1년` · 영어 `30m` `12h` `7d` `2w` · 1분~365일 | | `/영구차단 <닉네임> <사유>` | `/pgban` | 영구 차단 (계정 · 닉네임 · IP) | | `/차단해제 <닉네임> [사유]` | `/pgunban` | 차단 해제 | | `/처벌확인 <코드>` | `/pgconfirm` `/pgok` | 확인이 필요한 처벌 실행 (4글자 코드, 60초 안) | | `/pgpunish ` | `/처벌플러그인` | 플러그인 상태 · 동기화 · 리로드 | | 권한 | 기본 | 설명 | |---|---|---| | `pickguard.punish.op` | OP | 명령 목록 · 탭 완성에 보이게만 해요. **실제로는 OP 와 콘솔만** 쓸 수 있어요 (권한 플러그인으로 줘도 OP 가 아니면 거절). 반대로 OP 에게서 이 권한을 빼앗으면 OP 도 못 써요. | config.yml: `server-name`(기록에 보일 이름) · `check-timeout-ms`(접속 때 픽가드에 물어보는 최대 시간 300~3000, 기본 1500 — 넘으면 서버에 저장된 목록으로 판단) · `debug`. #### 자주 묻는 질문 - **콘솔에서 한글 명령이 깨져요.** 영어 별칭을 쓰세요: `pgban Steve 핵`, 확인 코드는 `pgok AB12`. - **PC방 · 학교에서 같이 막혔어요.** 대시보드 차단 목록 → 자세히에서 그 IP 를 공용 IP 로 표시하면 그 IP 로는 아무도 막지 않아요. 한 사람만 풀려면 `/차단해제 그사람` → `/처벌확인 코드`. - **playit.gg 같은 터널 뒤라 모두 IP 가 같아요.** 픽가드가 그런 주소는 IP 막기에 쓰지 않고 계정 · 닉네임으로만 막아요 (대시보드에 안내가 떠요). #### 링크 - 가이드: https://guard.dicopick.com/guide/minecraft-server-plugins · 자세한 설명: https://guard.dicopick.com/help (⚠️ 마인크래프트 경고 · 차단 플러그인) - 시작하기: https://guard.dicopick.com/setup/punish - 픽마크 자료 페이지: https://pickmc.kr/resources/pickguardpunish - PickGuardLink 받기: `https://hangar.papermc.io/PickGuard/PickGuardLink` (Hangar) · `https://modrinth.com/plugin/pickguardlink` (Modrinth) - 공식 디스코드: https://discord.gg/Jf6fdj8FuA --- ## English **PickGuardPunish** lets OPs warn, temp-ban and permanently ban players in-game, while the PickGuard bot keeps the records per Discord server. - Every action is announced in **Minecraft chat** and a **Discord punishment-log channel**: target, staff, reason, time. - Works on **offline players** by name. - Every ban blocks **account (UUID), name and IP** together (there is no separate IP-ban command) and applies to every Minecraft server linked to the same Discord server. - Main and alt accounts linked through Discord verification are blocked together. - IPs are stored only as a lookup key, never shown on the dashboard, in Discord or in-game. - **Confirmation code**: if 3+ other accounts share the IP, or a staff account is involved, the plugin shows the list and a 4-letter code; you must run `/pgok AB12` within 60 seconds. Fewer accidental mass bans. - **Warn-threshold auto-ban** (off by default): recommended 3 → 1 day, 5 → 7 days, 7 → permanent; or strict / custom tiers. - **Discord sync** (off by default, admins only): Minecraft ban → Discord ban, unban → unban, Discord ban → Minecraft ban, Discord unban → unban, and mirror Minecraft warnings into the Discord warning history. - The dashboard can also ban, unban, warn and cancel warnings (reason up to 200 chars), and holds the ban list, warning list, history, kick-screen text, IP-block duration and warning expiry. - There is **no** automatic kick/cleanup of unverified players. Only banned players are blocked. **This plugin requires an external service.** It needs the PickGuard Discord bot and **PickGuardLink 1.2.0+** on the same server; it reuses PickGuardLink's pairing token (no separate pairing). If the bot is not in the Discord server, the feature is switched off on the dashboard, or the connection is not verified yet, commands, join blocking and announcements all pause. #### Requirements - Discord server with the PickGuard bot + PickGuardLink 1.2.0+ (connection verified) - Spigot · Paper · Purpur 1.8.8 – 26.3 or Folia, Java 8+ #### Install in 3 steps 1. Pair your Minecraft server with PickGuardLink first (through "Verify connection"). 2. Dashboard → **Minecraft → Warnings & bans plugin**: download `PickGuardPunish.jar`, drop it into `plugins/`, restart. 3. Once the dashboard sees the plugin heartbeat, switch **Enable system** on. Announcement/log channels, Discord sync and warning tiers live on the same page. #### Commands (from plugin.yml — OP and console only) | Command | English alias | What | |---|---|---| | `/경고 ` | `/pgwarn` | Warn | | `/경고취소 [warning #]` | `/pgunwarn` | Cancel a warning | | `/경고확인 ` | `/pgwarns` | Show warnings and bans | | `/임시차단 ` | `/pgtempban` | Temp ban (account · name · IP). Duration `30m` `12h` `7d` `2w`, 1 minute – 365 days | | `/영구차단 ` | `/pgban` | Permanent ban (account · name · IP) | | `/차단해제 [reason]` | `/pgunban` | Unban | | `/처벌확인

` | `/pgconfirm` `/pgok` | Confirm a punishment that needs the 4-letter code (60 s) |
| `/pgpunish ` | `/처벌플러그인` | Plugin status · sync · reload |

| Permission | Default | Description |
|---|---|---|
| `pickguard.punish.op` | OP | Only controls visibility in command lists / tab completion. **Only OPs and the console can actually run the commands**, even if a permissions plugin grants this node. Removing it from an OP hides the commands from them. |

config.yml: `server-name` (name shown in logs), `check-timeout-ms` (max wait for PickGuard on join, 300–3000, default 1500; falls back to the locally cached list), `debug`.

#### FAQ
- **Korean commands look broken in the console.** Use the English aliases: `pgban Steve reason`, confirmation `pgok AB12`.
- **A whole LAN café got banned together.** On the dashboard ban list → details, mark that IP as shared; nobody is blocked by that IP any more. To release one person: `/pgunban ` → `/pgok `.
- **Everyone shares one IP behind playit.gg or a tunnel.** PickGuard detects such addresses, skips IP blocking for them and bans by account/name only (the dashboard shows a notice).

#### Links
- Guide (KO): https://guard.dicopick.com/guide/minecraft-server-plugins · details: https://guard.dicopick.com/help
- Get started: https://guard.dicopick.com/setup/punish
- Resource page: https://pickmc.kr/resources/pickguardpunish
- PickGuardLink: `https://hangar.papermc.io/PickGuard/PickGuardLink` (Hangar) · `https://modrinth.com/plugin/pickguardlink` (Modrinth)
- Discord: https://discord.gg/Jf6fdj8FuA

PickGuardPunish

1.0.1