PickGuardShop

PickGuardShop 은 게임 안에서 상점 창(GUI)을 여는 플러그인이에요. 돈은 Vault 에 연결된 경제 플러그인(Essentials 등)을 써요.

• 상점 창에서 좌클릭 1개 구매 · Shift+좌클릭 64개, 우클릭 1개 판매 · Shift+우클릭 전부 (물건 설명(lore)에 가격과 힌트가 보여요). 창이 여러 쪽이면 이전 · 다음 쪽 버튼, 내 잔액 표시.
• 운영자 상점: OP 가 게임에서 /상점 생성 <이름> 으로 만들고, 손에 든 물건을 /상점 추가 로 그대로 넣고 /상점 가격 으로 값을 정해요. 상점 · 물건 · 가격은 shops.yml 에 저장돼요.
• 유저상점: 플레이어가 /유저상점 생성 <이름> 으로 자기 상점을 열고 물건을 등록 · 꺼내고, 번 돈을 돌려받아요. 한 사람당 상점 수(150, 기본 3) · 거래 수수료(050%, 기본 0) 는 대시보드 또는 config 에서 정해요.
• 스킨 NPC: /상점 npc · /유저상점 npc 로 상점을 여는 NPC 를 두고 옮기고 지울 수 있어요 (가이드: "스킨 NPC", "만든 사람 스킨의 NPC").
• 대시보드에서 상점 플러그인을 켜고 끄고, 만들어진 유저상점을 보고 닫기 · 열기 · 삭제해요. 대시보드에서 저장하면 1분 안에 반영돼요.
• 사고팔 때 · 창 열 때 · 쪽 넘길 때 소리(sounds, 끌 수 있음), 안내 문구 전부 messages 로 바꿀 수 있어요.

이 플러그인은 외부 서비스가 필요해요. 켜기와 유저상점 설정은 픽가드 대시보드에서 하고, 연결 토큰은 같은 서버의 PickGuardLink 것을 같이 써요. PickGuardLink 가 없어도 로드는 되지만 상점은 멈춰 있어요 (plugin.yml 주석).

필요한 것

• 픽가드 봇이 있는 디스코드 서버 + PickGuardLink (연결 확인까지 끝난 상태)
• Vault + Vault 를 지원하는 경제 플러그인 (예: EssentialsX)
• Spigot · Paper · Purpur 1.8.8 ~ 26.3 또는 Folia, Java 8 이상

설치 3단계

1. PickGuardLink 로 마크 서버를 먼저 연결하고, Vault 와 경제 플러그인을 넣어 두세요.
2. 대시보드 → 마인크래프트 → 상점 플러그인에서 PickGuardShop.jar 를 받아 plugins/ 에 넣고 서버를 다시 켜요. 대시보드에서 상점 플러그인을 켜요.
3. 게임에서 OP 로 /상점 생성 <이름> → 물건을 손에 들고 /상점 추가 → /상점 가격 으로 값을 정하면 /상점 <이름> 으로 열려요.

명령어 (plugin.yml)

config.yml: prefix(채팅 안내 머리말) · sounds · usershops.enabled · usershops.max-per-player(기본 3) · usershops.fee-percent(기본 0) · messages(구매 · 판매 · 잔액 부족 · 인벤토리 가득 · lore 문구 · GUI 버튼 문구). 대시보드 설정이 있으면 그 값을 먼저 써요.

자주 묻는 질문

• Vault 없이 되나요? 아니요. 돈은 Vault 경제로만 주고받아요. Vault 와 경제 플러그인(Essentials 등)을 먼저 넣어 주세요.
• 상점이 "멈춰 있어요" 라고 나와요. 대시보드에서 상점 플러그인이 꺼져 있거나 PickGuardLink 연결이 없을 때예요. 대시보드에서 켜고 연결 확인을 다시 해 보세요.
• 유저상점을 못 만들게 하고 싶어요. 대시보드(또는 config usershops.enabled: false)에서 끄거나, pgshop.usershop 권한을 빼면 돼요.

링크

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

English

PickGuardShop opens chest-style shop GUIs in-game. Money goes through a Vault-compatible economy (EssentialsX etc.).

• In the GUI: left-click buys 1, Shift+left buys 64; right-click sells 1, Shift+right sells all (prices and hints shown in item lore). Paged shops get prev/next buttons and a balance display.
• Admin shops: an OP runs /상점 생성 <name>, adds the item in hand with /상점 추가, sets prices with /상점 가격. Shops, items and prices are saved in shops.yml.
• Player shops: players open their own with /유저상점 생성 <name>, register and withdraw items, and collect earnings. Shops per player (1–50, default 3) and a sales fee (0–50 %, default 0) are set on the dashboard or in config.
• Skin NPCs: /상점 npc and /유저상점 npc place, move and remove an NPC that opens the shop (the guide calls these "skin NPCs" that use the creator's skin).
• Dashboard: enable/disable the plugin, list player shops, close/open/delete them. Saved settings reach the plugin within a minute.
• Sounds on buy/sell/open/page (sounds, can be turned off); every message is editable under messages.

This plugin requires an external service. Enabling the shop and player-shop settings happen on the PickGuard dashboard, and the plugin reuses PickGuardLink's pairing token on the same server. Without PickGuardLink it still loads, but the shop stays paused (plugin.yml note).

Requirements

• Discord server with the PickGuard bot + PickGuardLink (connection verified)
• Vault + a Vault-compatible economy plugin (e.g. EssentialsX)
• Spigot · Paper · Purpur 1.8.8 – 26.3 or Folia, Java 8+

Install in 3 steps

1. Pair the server with PickGuardLink first; install Vault and an economy plugin.
2. Dashboard → Minecraft → Shop plugin: download PickGuardShop.jar, drop it into plugins/, restart. Switch the shop plugin on in the dashboard.
3. In-game as OP: /상점 생성 <name> → hold an item and /상점 추가 → /상점 가격 to set prices. Players open it with /상점 <name>.

Commands (from plugin.yml)

Korean subcommand glossary: 목록 list · 열기 open · 생성 create · 삭제 delete · 제목 title · 설정 settings · 추가 add item · 가격 price · 제거 remove item · 정보 info · npc이동 move npc · npc삭제 remove npc · 리로드 reload · 등록 register · 꺼내기 withdraw · 돌려받기 collect earnings · 닫기 close.

config.yml: prefix, sounds, usershops.enabled, usershops.max-per-player (default 3), usershops.fee-percent (default 0), messages (buy/sell/not-enough/inventory-full/lore/GUI texts). Dashboard values take precedence when set.

FAQ

• Does it work without Vault? No. All money moves through Vault; install Vault and an economy plugin first.
• The shop says it is paused. Either the shop plugin is switched off on the dashboard or the PickGuardLink pairing is missing. Enable it and re-run "Verify connection".
• I don't want player shops. Turn them off on the dashboard (or usershops.enabled: false) or revoke pgshop.usershop.

Links

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