Minecraft 서버 EconomyShopGUI 플러그인

## 🔌 EconomyShopGUI 소개 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 상점)은 무료 버전에 포함되어 있습니다. ## 🤝 이 플러그인이 유용한 경우 기존 경제 플러그인과 연동되고, 설정 가능한 레이아웃, 상점 섹션, 판매 흐름을 지원하는 게임 내 그래픽 상점이 필요하다면, EconomyShopGUI는 문서화된 관리자용 인터페이스와 플러그인 통합용 API를 제공합니다.

플러그인