Minecraft 서버 Shopkeepers 플러그인

## 🔌 Shopkeepers 소개 Shopkeepers는 Bukkit/Spigot용 Minecraft 플러그인으로, 서버 관리자가 설정한 아이템을 설정한 가격에 판매하는 커스터마이즈 가능한 주민 상인을 배치할 수 있게 해줍니다. 이 플러그인은 관리자 상점(무한 재고)과 컨테이너에서 재고를 가져오는 플레이어 상점을 모두 지원하며, 애드온 통합과 확장을 위한 ShopkeepersAPI도 제공합니다. ## 🎯 목적 이 플러그인은 게임 내 NPC 기반 상점 시스템을 제공하여, 수동 상자 관리나 복잡한 명령 기반 상점 없이 서버에 지속적인 상점을 운영할 수 있게 합니다. 서버 경제, 롤플레이 상점, 그리고 NPC 상인이 필요한 survival/SMP 서버에 적합합니다. () ## ⚙️ 기능 - 정해진 거래와 가격이 있는 커스텀 주민 상인을 생성할 수 있습니다. - 무한 공급의 관리자 상점. - 연결된 컨테이너(상자)에서 아이템을 가져와 재고를 채우는 플레이어 상점. - 플러그인 작성자가 상인을 프로그램적으로 조회하고 관리할 수 있는 ShopkeepersAPI. - 프로젝트의 위키와 언어 파일을 통한 게임 내 아이템/아이템 데이터 커스터마이징 및 언어 파일 지원. () ## 🧩 대상 - NPC가 운영하는 상점을 원하는 Survival 및 SMP 서버. - 주민 NPC를 상인으로 사용하는 롤플레이 또는 경제 서버. - 다른 시스템에 상점 동작을 통합하기 위한 API가 필요한 플러그인 개발자. () ## 🏗️ 사용 예시 - 관리자가 서버 제공 아이템을 판매하는 무한 관리자 상점을 만듭니다. - 플레이어가 연결된 상자에서 아이템을 자동으로 판매하는 상점을 엽니다. - 개발자가 ShopkeepersAPI를 사용해 상인을 목록화하거나 수정하는 애드온을 만듭니다. () ## ⌨️ 명령어 | **Command** | **Description** | **Permission** | **Access** | |---|---|---|---| | `/shopkeeper history [player|'all'|'self'] [shop=...|owner=...|'own'|'player'|'admin'|'all'] [page]` | 필터가 적용된 거래/기록 목록을 봅니다(문법은 공식 문서에서 확인됨). | 지정되지 않음 | Admin | (참고: 위에는 공식 소스에 명시적으로 문서화된 명령어만 나열되어 있습니다.) () ## ⚙️ 설치 ### 📥 설정 - 공식 플러그인 jar를 다운로드하여 서버의 `plugins/` 폴더에 넣습니다. - 서버를 재시작하고 콘솔에서 플러그인이 로드되었는지 확인합니다. (이는 Bukkit/Spigot 플러그인의 표준 설치 단계이며 프로젝트 문서에서도 지원됩니다.) () ## 🧠 기술 참고 - Shopkeepers는 GPL-3.0 라이선스로 배포되며, 프로젝트 저장소에는 API 모듈(ShopkeepersAPI)과 빌드 안내가 포함되어 있습니다. () - 이 프로젝트는 애드온 개발자를 위해 Maven 아티팩트와 공개 API를 제공하며, README에는 저장소 사용법과 API 의존성 좌표가 문서화되어 있습니다. () - 공식 배포와 커뮤니티 지원은 Spigot 리소스 페이지와 이 플러그인의 Discord 서버에서 이용할 수 있습니다. () ## 🤝 이 플러그인이 유용한 경우 관리자 및 플레이어 운영 상점을 모두 지원하는 지속적이고 설정 가능한 NPC 상인이 필요하고, 다른 플러그인에 상점을 통합하기 위한 API가 필요하다면, Shopkeepers는 Bukkit/Spigot 서버를 위한 검증된 구현을 제공합니다. ()

플러그인