Minecraft 플러그인 Shopkeepers

🔌 Shopkeepers 소개

Shopkeepers는 Bukkit/Spigot용 Minecraft 플러그인으로, 서버 관리자가 설정한 아이템을 설정한 가격에 판매하는 커스터마이즈 가능한 주민 상인을 배치할 수 있게 해줍니다. 이 플러그인은 관리자 상점(무한 재고)과 컨테이너에서 재고를 가져오는 플레이어 상점을 모두 지원하며, 애드온 통합과 확장을 위한 ShopkeepersAPI도 제공합니다.

🎯 목적

이 플러그인은 게임 내 NPC 기반 상점 시스템을 제공하여, 수동 상자 관리나 복잡한 명령 기반 상점 없이 서버에 지속적인 상점을 운영할 수 있게 합니다. 서버 경제, 롤플레이 상점, 그리고 NPC 상인이 필요한 survival/SMP 서버에 적합합니다. ()

⚙️ 기능

• 정해진 거래와 가격이 있는 커스텀 주민 상인을 생성할 수 있습니다.
• 무한 공급의 관리자 상점.
• 연결된 컨테이너(상자)에서 아이템을 가져와 재고를 채우는 플레이어 상점.
• 플러그인 작성자가 상인을 프로그램적으로 조회하고 관리할 수 있는 ShopkeepersAPI.
• 프로젝트의 위키와 언어 파일을 통한 게임 내 아이템/아이템 데이터 커스터마이징 및 언어 파일 지원. ()

🧩 대상

• NPC가 운영하는 상점을 원하는 Survival 및 SMP 서버.
• 주민 NPC를 상인으로 사용하는 롤플레이 또는 경제 서버.
• 다른 시스템에 상점 동작을 통합하기 위한 API가 필요한 플러그인 개발자. ()

🏗️ 사용 예시

• 관리자가 서버 제공 아이템을 판매하는 무한 관리자 상점을 만듭니다.
• 플레이어가 연결된 상자에서 아이템을 자동으로 판매하는 상점을 엽니다.
• 개발자가 ShopkeepersAPI를 사용해 상인을 목록화하거나 수정하는 애드온을 만듭니다. ()

⌨️ 명령어

(참고: 위에는 공식 소스에 명시적으로 문서화된 명령어만 나열되어 있습니다.) ()

⚙️ 설치

📥 설정

• 공식 플러그인 jar를 다운로드하여 서버의 plugins/ 폴더에 넣습니다.
• 서버를 재시작하고 콘솔에서 플러그인이 로드되었는지 확인합니다.

(이는 Bukkit/Spigot 플러그인의 표준 설치 단계이며 프로젝트 문서에서도 지원됩니다.) ()

🧠 기술 참고

• Shopkeepers는 GPL-3.0 라이선스로 배포되며, 프로젝트 저장소에는 API 모듈(ShopkeepersAPI)과 빌드 안내가 포함되어 있습니다. ()
• 이 프로젝트는 애드온 개발자를 위해 Maven 아티팩트와 공개 API를 제공하며, README에는 저장소 사용법과 API 의존성 좌표가 문서화되어 있습니다. ()
• 공식 배포와 커뮤니티 지원은 Spigot 리소스 페이지와 이 플러그인의 Discord 서버에서 이용할 수 있습니다. ()

🤝 이 플러그인이 유용한 경우

관리자 및 플레이어 운영 상점을 모두 지원하는 지속적이고 설정 가능한 NPC 상인이 필요하고, 다른 플러그인에 상점을 통합하기 위한 API가 필요하다면, Shopkeepers는 Bukkit/Spigot 서버를 위한 검증된 구현을 제공합니다. ()