PickGuardChat

PickGuardChat 은 서버 채팅을 지역 · 전체 · 거래 세 채널로 나눠요.

• 그냥 치면 내 채널로 가요 (처음 접속한 사람은 config default-channel, 기본 지역).
• 앞 글자를 붙이면 그 메시지만 다른 채널로: 기본값은 ! 전체 · $ 거래 (config prefix 로 바꾸거나 비울 수 있어요).
• /지역 /전체 /거래 를 글 없이 치면 내 채널이 바뀌고, 글과 함께 치면 그 채널로 한 번 보내요.
• 지역 채팅은 같은 월드에서 정한 반경(5~1000칸, 기본 100칸) 안의 사람에게만 보여요. 반경 안에 아무도 없으면 보낸 사람에게 알려 줘요 (empty-notice).
• 채널마다 도배 방지 대기 시간(기본 지역 0초 · 전체 5초 · 거래 30초)과 채팅 모양(format, & 색 코드, {player} {display} {world} {message})을 정해요.
• 플레이어는 /채팅 끄기 전체 처럼 전체 · 거래 채널을 스스로 끄고 켤 수 있어요.
• OP 는 /채팅 감시 로 반경 밖 지역 채팅도 볼 수 있어요 (spy-format).
• 대시보드 값이 서버 config.yml 값보다 우선 적용되고, 저장하면 1분 안에 플러그인에 반영돼요.

이 플러그인은 외부 서비스가 필요해요. 대시보드 설정을 받으려면 픽가드 봇과 같은 서버의 PickGuardLink 연결이 있어야 해요 (연결 토큰은 PickGuardLink 것을 같이 써요).

필요한 것

• 픽가드 봇이 있는 디스코드 서버 + PickGuardLink (연결 확인까지 끝난 상태)
• Spigot · Paper · Purpur 1.8.8 ~ 26.3 또는 Folia, Java 8 이상

설치 3단계

1. PickGuardLink 로 마크 서버를 먼저 연결해 두세요.
2. 대시보드 → 마인크래프트 → 채팅 플러그인에서 PickGuardChat.jar 를 받아 plugins/ 에 넣고 서버를 다시 켜요.
3. 대시보드에서 반경 · 도배 방지 · 안내를 정하고 저장해요 (1분 안에 반영). config.yml 을 직접 고쳤다면 /채팅 리로드.

명령어 (plugin.yml)

자주 묻는 질문

• 대시보드 없이 config.yml 만으로도 되나요? 채널 · 반경 · 형식은 config.yml 에 있어요. 다만 대시보드에 저장한 값이 있으면 그 값이 우선이에요.
• 플레이어가 전체 채팅을 안 보고 싶대요. /채팅 끄기 전체 로 본인이 끄면 돼요. /채팅 켜기 전체 로 다시 켜요.
• 지역 채팅인데 아무도 못 들었어요. 기본으로 "반경 안에 아무도 없어요" 안내가 떠요. 전체에 말하려면 앞에 ! 를 붙여요.

링크

• 가이드: https://guard.dicopick.com/guide/minecraft-server-plugins
• 시작하기: https://guard.dicopick.com/setup/chat
• 픽마크 자료 페이지: https://pickmc.kr/resources/pickguardchat
• PickGuardLink 받기: https://hangar.papermc.io/PickGuard/PickGuardLink (Hangar) · https://modrinth.com/plugin/pickguardlink (Modrinth)
• 공식 디스코드: https://discord.gg/Jf6fdj8FuA

English

PickGuardChat splits server chat into local · global · trade channels.

• Plain chat goes to your current channel (new players start in default-channel, local by default).
• A prefix sends just that message elsewhere: ! global, $ trade by default (change or clear under prefix in config.yml).
• /지역 /전체 /거래 without text switch your channel; with text they send once to that channel.
• Local chat reaches players in the same world within a radius (5–1000 blocks, default 100). If nobody is in range the sender is told (empty-notice).
• Per-channel cooldowns (defaults: local 0 s, global 5 s, trade 30 s) and formats (& colour codes, {player} {display} {world} {message}).
• Players can mute/unmute global or trade for themselves with /채팅 끄기|켜기 <전체|거래>.
• OPs can watch local chat outside their radius with /채팅 감시 (spy-format).
• Dashboard values override config.yml and reach the plugin within a minute of saving.

This plugin requires an external service. Dashboard settings arrive through the PickGuard bot and the PickGuardLink pairing on the same server (it reuses PickGuardLink's token).

Requirements

• Discord server with the PickGuard bot + PickGuardLink (connection verified)
• Spigot · Paper · Purpur 1.8.8 – 26.3 or Folia, Java 8+

Install in 3 steps

1. Pair the server with PickGuardLink first.
2. Dashboard → Minecraft → Chat plugin: download PickGuardChat.jar, drop it into plugins/, restart.
3. Set radius, cooldowns and messages on the dashboard and save (applied within a minute). If you edited config.yml by hand, run /채팅 리로드.

Commands (from plugin.yml)

Note: command names are Korean (지역 = local, 전체 = global, 거래 = trade, 채팅 = chat, 끄기/켜기 = off/on, 감시 = spy, 리로드 = reload). Only /pgchat has an English alias.

FAQ

• Does config.yml alone work? Channels, radius and formats are in config.yml, but any value saved on the dashboard takes precedence.
• A player doesn't want to see global chat. They run /채팅 끄기 전체; /채팅 켜기 전체 turns it back on.
• Nobody heard my local message. The sender gets a notice by default; prefix with ! to speak globally.

Links

• Guide (KO): https://guard.dicopick.com/guide/minecraft-server-plugins
• Get started: https://guard.dicopick.com/setup/chat
• Resource page: https://pickmc.kr/resources/pickguardchat
• PickGuardLink: https://hangar.papermc.io/PickGuard/PickGuardLink (Hangar) · https://modrinth.com/plugin/pickguardlink (Modrinth)
• Discord: https://discord.gg/Jf6fdj8FuA