QuickShop-Hikari는 상자 기반 매입/매출 상점(ChestShops)을 구현하는 Minecraft 플러그인입니다. 플레이어는 상자와 상호작용해 상점을 만들고 사용하며, 대부분의 게임플레이에는 명령어가 필요하지 않습니다. 이 프로젝트는 QuickShop-Community가 유지 관리하며, 최신 호환성, 데이터 안전성, 확장 가능한 통합에 중점을 둡니다.

🎯 목적

플레이어가 아이템을 판매 목록에 올리거나 상자를 사용해 매입 상점을 만들 수 있는, 게임 내 아이템 기반 경제를 제공합니다. 이 플러그인은 플레이어에게 명령어 학습을 강요하지 않으면서도, 물리적이고 상자 중심의 경제와 상점별 제어를 원하는 서버 관리자를 대상으로 합니다.

⚙️ 기능

상자와 표지판을 사용해 매입/매출 상점을 생성할 수 있습니다(상자 기반 상점).
NBT 데이터, 인챈트, 아이템 내구도, 물약 데이터, 몹 알을 지원합니다.
상점 위에 표시되는 가상 디스플레이 아이템을 켜고 끌 수 있습니다(ProtocolLib 또는 PacketEvents 지원).
무제한 상자 지원과 더블 체스트의 혼합 매입/매출 동작을 제공합니다.
우회 권한 옵션이 있는 블랙리스트 지원.
상점별 권한 관리와 소유자와 다른 플레이어 간의 상점 혜택.
아이템 및 인챈트 이름의 i18n 지원과 메시지용 MiniMessage 문법.
H2(로컬) 및 MySQL(원격) 데이터 소스 지원.
일반적인 보호 및 유틸리티 플러그인을 위한 통합 훅(호환성 모듈 제공).
상점을 조회하고 기능을 통합하기 위한 개발자 API(Maven/Gradle 좌표 제공).
설정에서 비활성화할 수 있는 bStats 텔레메트리.

🧩 대상

Survival/SMP 또는 경제 중심 서버를 운영하며, 물리적인 상자 기반 마켓플레이스를 원하는 서버 소유자와 관리자를 위한 것입니다. Vault 호환 경제 플러그인을 사용하는 소규모부터 대규모 서버까지 적합하며, 상점별 제어와 데이터베이스 기반 저장을 제공합니다.

🏗️ 사용 예시

플레이어가 상자에 아이템을 넣고 라벨을 붙여 다른 플레이어에게 자동으로 묶음 판매합니다.
관리자가 상점별 권한을 활성화하여 특정 월드나 지역의 상점을 모더레이터가 관리할 수 있게 합니다.
네트워크에서 MySQL 저장소를 사용해 서버 인스턴스 간 상점을 지속적으로 유지합니다.

⌨️ 명령어

Command	Description	Permission	Access
`/qs`	설치 후 QuickShop 콘솔/명령어 도움말과 테스트 출력을 표시합니다.	지정되지 않음	Admin

참고: 프로젝트 문서에 따르면 일반 플레이어의 게임플레이에는 명령어가 필요하지 않으며, 명령어는 주로 관리용입니다.

🔐 권한

Permission	Description	Default
`quickshop.player`	플레이어가 상점을 만들고 사용할 수 있게 합니다.	false

⚙️ 설치

📥 설정

프로젝트 배포처(Modrinth/Spigot/GitHub releases)에서 공식 QuickShop-Hikari jar를 다운로드합니다.
jar 파일을 서버의 plugins/ 폴더에 넣습니다.
서버를 시작하고 플러그인이 로드되었는지 확인합니다(문서에서는 콘솔에서 qs 명령어를 실행해 도움말/테스트 출력을 표시하는 방법을 안내합니다).

📦 의존성

프로젝트가 명시한 확인된 필수/선택 통합:

Vault(경제 연동에 필요)
Vault 호환 경제 플러그인(프로젝트에서 예시 제공)
ProtocolLib 또는 PacketEvents(가상 표시 아이템 / 플레이어별 지역화에 필요)
LuckPerms(권한 관리에 권장)

🧾 설정

플러그인은 config.yml을 생성하고 사용합니다(문서에서는 표시 프로토콜과 개인정보 설정에 대한 config.yml 키를 참조합니다).
데이터 저장은 로컬 H2 또는 원격 MySQL을 지원하며, 플러그인 설정 파일에서 구성 옵션을 사용할 수 있습니다.

🧠 기술 참고

공식 문서는 Paper 기반 서버에서의 실행을 권장하며 Java 21 요구 사항을 안내합니다.
이 프로젝트는 개발자 API와 컴파일 시 사용을 위한 Maven/Gradle 좌표를 제공합니다.
QuickShop-Hikari는 타사 플러그인(예: WorldGuard, WorldEdit, OpenInv)을 위한 호환성 모듈을 선택적 다운로드로 제공합니다.
텔레메트리: bStats를 사용하며, config 설정에서 비활성화할 수 있습니다.