**PickGuardShop** 은 게임 안에서 상점 창(GUI)을 여는 플러그인이에요. 돈은 **Vault** 에 연결된 경제 플러그인(Essentials 등)을 써요. - 상점 창에서 **좌클릭 1개 구매 · Shift+좌클릭 64개**, **우클릭 1개 판매 · Shift+우클릭 전부** (물건 설명(lore)에 가격과 힌트가 보여요). 창이 여러 쪽이면 이전 · 다음 쪽 버튼, 내 잔액 표시. - **운영자 상점**: OP 가 게임에서 `/상점 생성 <이름>` 으로 만들고, 손에 든 물건을 `/상점 추가` 로 그대로 넣고 `/상점 가격` 으로 값을 정해요. 상점 · 물건 · 가격은 `shops.yml` 에 저장돼요. - **유저상점**: 플레이어가 `/유저상점 생성 <이름>` 으로 자기 상점을 열고 물건을 등록 · 꺼내고, 번 돈을 돌려받아요. 한 사람당 상점 수(1~50, 기본 3) · 거래 수수료(0~50%, 기본 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) | 명령 | 별칭 | 하위 명령 (plugin.yml usage) | 누가 | |---|---|---|---| | `/상점` | `/pgshop` | `[이름 \| 목록 \| 열기 <이름> \| 생성 \| 삭제 \| 제목 \| 설정 \| 추가 \| 가격 \| 제거 \| 정보 \| npc \| npc이동 \| npc삭제 \| 리로드]` — 열기 · 목록은 모두, 만들기 · 물건 · 가격 · npc · 리로드는 `pgshop.admin` | 모두 / OP | | `/유저상점` | `/pgushop` | `[이름 \| 목록 \| 열기 <이름> \| 생성 \| 설정 \| 등록 \| 꺼내기 \| 정보 \| 삭제 \| 돌려받기 \| 닫기 \| npc \| npc이동 \| npc삭제]` | `pgshop.usershop` | | 권한 | 기본 | 설명 | |---|---|---| | `pgshop.use` | 모두 | 상점을 열고 사고 팔아요 | | `pgshop.usershop` | 모두 | 유저상점을 만들고 써요 | | `pgshop.admin` | OP | 상점 만들기 · 지우기 · 물건과 가격 편집 · 리로드 | 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 `/상점 생성 `, 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 `/유저상점 생성 `, 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: `/상점 생성 ` → hold an item and `/상점 추가` → `/상점 가격` to set prices. Players open it with `/상점 `. #### Commands (from plugin.yml) | Command | Alias | Subcommands (plugin.yml usage) | Who | |---|---|---|---| | `/상점` | `/pgshop` | `[name \| 목록 \| 열기 \| 생성 \| 삭제 \| 제목 \| 설정 \| 추가 \| 가격 \| 제거 \| 정보 \| npc \| npc이동 \| npc삭제 \| 리로드]` — open/list for everyone; create · items · prices · npc · reload need `pgshop.admin` | everyone / OP | | `/유저상점` | `/pgushop` | `[name \| 목록 \| 열기 \| 생성 \| 설정 \| 등록 \| 꺼내기 \| 정보 \| 삭제 \| 돌려받기 \| 닫기 \| npc \| npc이동 \| npc삭제]` | `pgshop.usershop` | 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. | Permission | Default | Description | |---|---|---| | `pgshop.use` | true | Open shops, buy and sell | | `pgshop.usershop` | true | Create and use player shops | | `pgshop.admin` | OP | Create/delete shops, edit items and prices, reload | 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

PickGuardShop

1.2.2