EconomyShopGUI는 플레이어가 채팅 명령 대신 메뉴를 통해 아이템을 사고팔 수 있도록, 설정 가능한 그래픽 상점 시스템을 제공하는 Minecraft 플러그인입니다. 이 플러그인은 상점 섹션, 페이지가 나뉜 상점 페이지, 판매 인터페이스, 그리고 선택 사항인 물리적 "ShopStand" 아이템을 제공합니다. Bukkit/Spigot/Paper 서버 환경용으로 설계되었으며, 일반적인 경제 플러그인과 연동됩니다.

🎯 목적

이 플러그인은 텍스트 기반 상점 명령을 GUI 기반 상점과 관리용 상점 설정으로 대체하거나 보완합니다. 이미 존재하는 경제 플러그인에 연결되는, 구조화되고 설정 가능한 게임 내 상점을 원하는 서버 소유자와 관리자를 위한 것입니다.

⚙️ 기능

설정 가능한 상점 섹션과 페이지가 나뉜 GUI 페이지.
거래 화면과 설정 가능한 제한이 있는 구매 및 판매 흐름.
전역 및 섹션별 sell-all 기능.
ShopStand 물리 아이템 지원(배치 가능한 전시 상점).
레이아웃 마켓플레이스 / 설치 가능한 레이아웃 / 게임 내 레이아웃 설치.
다른 플러그인에서 이 플러그인에 연결할 수 있는 개발자 API.
여러 경제 시스템과의 연동, 그리고 스포너 및 유틸리티 플러그인을 위한 선택적 연동.
익명 플러그인 메트릭을 위해 bStats 사용.

🧩 대상

게임 내 GUI 상점을 원하는 Survival 및 SMP 서버.
이미 별도의 경제 플러그인을 사용하고 있으며, 전면 상점 UI가 필요한 서버.
설정 가능한 상점 레이아웃과 선택적 물리 상점 스탠드를 원하는 서버.
상점 동작을 통합하기 위한 상점 API가 필요한 플러그인 개발자.

🏗️ 사용 예시

운영자가 자원, 도구, 꾸미기용 상점 섹션을 만들고 플레이어가 GUI를 통해 구매하도록 합니다.
서버가 플레이어가 구성된 상점 섹션에 아이템을 판매할 수 있도록 /sellall 명령을 제공합니다.
관리자가 원본 파일을 수정하지 않고도 상점 외형을 바꾸기 위해 레이아웃을 설치하거나 업로드합니다.

⌨️ 명령어

명령어	설명	권한	접근
`/eshop additem <section> <material> <buy price> <sell price>`	상점 섹션에 아이템을 추가합니다.	`EconomyShopGUI.eshop.additem`	관리자
`/eshop edititem <section> <index> <action> <key> <value>`	섹션 안의 아이템 속성을 수정합니다.	`EconomyShopGUI.eshop.edititem`	관리자
`/eshop deleteitem <section> <index>`	상점 섹션에서 아이템을 제거합니다.	`EconomyShopGUI.eshop.deleteitem`	관리자
`/eshop addhanditem <section> <buy price> <sell price>`	손에 든 아이템을 상점 섹션에 추가합니다.	`EconomyShopGUI.eshop.addhanditem`	관리자
`/eshop installLayout <id>`	id로 상점 레이아웃을 설치합니다(레이아웃 마켓플레이스 연동).	`EconomyShopGUI.eshop.installLayout`	관리자
`/eshop logs export`	거래 로그를 웹 보기로 내보냅니다(거래 기록 기능).	`지정되지 않음`	관리자
`/sellall`	구성된 상점 섹션에 따라 판매 가능한 모든 아이템을 판매합니다.	`EconomyShopGUI.sellall`	플레이어
`/sellgui`	메뉴를 통해 아이템을 판매할 수 있도록 Sell GUI를 엽니다.	`EconomyShopGUI.sellgui`	플레이어

(위 명령어는 플러그인 작성자가 문서화한 경우에만 포함됩니다.)

🔐 권한

권한	설명	기본값
`EconomyShopGUI.shop`	플레이어가 상점을 열 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.shop.<section>`	이름으로 특정 상점 섹션을 열 수 있는 권한입니다.	지정되지 않음
`EconomyShopGUI.shop.all`	모든 상점 섹션을 열 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.sellall`	`/sellall` 명령어 사용을 허용합니다.	지정되지 않음
`EconomyShopGUI.sellall.<section>`	`/sellall`로 특정 상점 섹션에 판매할 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.sellall.all`	`/sellall`로 모든 섹션에 판매할 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.sellallitem`	`/sellall <item>` 사용을 허용합니다.	지정되지 않음
`EconomyShopGUI.sellgui`	Sell GUI를 열 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.reload`	플러그인 다시 불러오기를 허용합니다.	지정되지 않음
`EconomyShopGUI.eshop.additem`	명령어로 상점 아이템을 추가할 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.eshop.edititem`	명령어로 상점 아이템을 수정할 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.eshop.deleteitem`	명령어로 상점 아이템을 삭제할 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.eshop.addhanditem`	명령어로 손에 든 아이템을 상점에 추가할 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.eshop.addsection`	명령어로 상점 섹션을 추가할 수 있게 합니다.	지정되지 않음
`EconomyShopGUI.eshop.uploadLayout`	레이아웃 업로드를 허용합니다.	지정되지 않음
`EconomyShopGUI.eshop.installLayout`	레이아웃 설치를 허용합니다.	지정되지 않음
`EconomyShopGUI.eshop.shopstands.create`	ShopStand 아이템 생성/배치를 허용합니다.	지정되지 않음
`EconomyShopGUI.eshop.shopstands.destroy`	ShopStand 파괴를 허용합니다.	지정되지 않음

(플러그인 문서의 권한 목록에 기본값이 명시되지 않은 경우 기본값은 "지정되지 않음"으로 기록됩니다.)

⚙️ 설치

📥 설정

공식 플러그인 JAR를 다운로드해 서버의 plugins/ 폴더에 넣습니다.
서버를 재시작하거나 플러그인 관리자를 사용해 플러그인을 로드합니다.
시작 시 서버 콘솔을 확인하여 플러그인이 로드되었는지와 의존성 경고가 있는지 확인합니다.

📦 의존성

경제 제공자가 필요합니다. 플러그인은 다음 중 하나에 대한 지원을 문서화합니다: Vault, PlayerPoints, CoinsEngine, GemsEconomy, UltraEconomy, VotingPlugin, zEssentials (경제 작업을 위해 이 중 하나가 있어야 합니다).
선택적 연동에는 PlaceholderAPI, Citizens, Quests, 그리고 직접 지원을 위한 다양한 spawner 플러그인이 포함됩니다.

🧠 기술 노트

이 플러그인은 Bukkit/Spigot/Paper 서버용으로 배포되며, 작성자는 모드/하이브리드 서버는 지원하지 않는다고 밝힙니다.
작성자가 명시한 요구 사항: Minecraft 1.8+ 및 Java 8 이상.
이 플러그인은 다른 플러그인이 상점 이벤트와 기능에 연결할 수 있도록 개발자 API를 제공합니다.
이 플러그인은 익명 메트릭 수집을 위해 bStats를 사용합니다.
GUI 편집기, 명령어 아이템, 커스텀 NBT 아이템 같은 기능을 추가하는 프리미엄 버전이 있으며, 핵심 기능(GUI 상점)은 무료 버전에 포함되어 있습니다.