ExcellentCrates는 Spigot/Paper 서버용 Minecraft 플러그인으로, 기능이 풍부한 crates(lootbox) 시스템을 구현합니다. 설정 가능한 crate 유형, 키 관리(가상 및 물리), 그리고 서버 관리자가 주로 게임 내 GUI 편집기를 통해 관리할 수 있는 유연한 보상 정의에 중점을 둡니다.

🎯 목적

이 플러그인은 수동 파일 수정 없이 서버에서 crate 기반 보상을 만들고, 설정하고, 보여주는 문제를 해결합니다. 이벤트, 일일 보상, 수익화 기능, 또는 플레이어 진행 보상에 crates를 사용하면서도 설정과 미리보기를 게임 내에서 쉽게 접근할 수 있게 하려는 서버 소유자와 관리자를 위한 것입니다.

⚙️ 기능

게임 내 GUI 편집기로 crates, 키, 보상을 생성하고 관리.
물리 키와 가상 키 지원(가상 키는 거래/공유를 방지).
crate 블록용 내장 홀로그램과 파티클 효과(일부 홀로그램 기능에는 추가 플러그인이 필요할 수 있음).
Crate Blocks: crates를 물리 블록/구역에 연결하여 월드 내 crate 상호작용 제공.
crate별 사용자 지정 미리보기 GUI와 열기 GUI.
보상 유형: 아이템 보상과 명령 보상.
번들 지원: 보상당 여러 아이템 스택 가능(문서상 아이템 보상당 최대 27개 아이템 제한) 및 명령 보상당 무제한 명령.
보상 확률 밸런싱을 위한 희귀도와 가중치.
마일스톤과 대량 열기 기능.
열기 쿨다운과 플레이어별 열기 비용(열기 비용 기능상 경제 연동이 암시됨).
crates와 보상에 대한 권한 및 키 요구사항.
보상 제한(전체 및 플레이어별)과 보상 방송/로그.
공식 자료에 따르면 PlaceholderAPI 지원.

🧩 대상

이벤트, 수익화, 플레이어 참여를 위해 crates를 사용하는 공개 및 비공개 Spigot/Paper 서버.
수동 YAML 편집보다 게임 내 편집기를 선호하는 서버 관리자.

🏗️ 사용 예시

희귀도와 가중치가 있는 보상을 포함한 crate를 설정하고, 스폰에 crate 블록을 배치한 뒤 플레이어에게 여는 데 사용할 가상 키를 지급.
플레이어가 키를 사용하기 전에 보상을 확인할 수 있도록 crate 미리보기와 홀로그램을 생성.
대량 열기와 마일스톤을 사용해 기간 한정 이벤트를 진행하거나 활동적인 플레이어에게 보상.

⚙️ 설치

📥 설정

공식 플러그인 JAR를 다운로드하여 지원이 확인된 서버 빌드(Spigot 또는 Paper)의 plugins/ 디렉터리에 넣습니다.
서버를 재시작하고 콘솔을 확인하여 플러그인이 로드되었는지 확인합니다.
플러그인이 보조 엔진 종속성을 필요로 한다면, 필요한 종속 플러그인(nightcore)을 ExcellentCrates 이전 또는 함께 설치하세요.

📦 종속성

필수: 공식 자료에 명시된 nightcore(플러그인 엔진).
선택: 고급 홀로그램 기능용 ProtocolLib 또는 PacketEvents. 텍스트의 플레이스홀더는 PlaceholderAPI가 지원됩니다.

🧠 기술 메모

지원이 확인된 서버 소프트웨어: Spigot 및 Paper.
확인된 최소 서버 버전 요구사항: 1.21.8 이상(프로젝트 기준).
확인된 Java 요구사항: Java 21 이상.
Folia와 Forge 지원은 명시적으로 제공되지 않습니다.
프로젝트 저장소에는 GPL-3.0 라이선스가 표시되어 있습니다.

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

Spigot/Paper 서버에서 가상/물리 키, 홀로그램, 유연한 보상 정의(아이템, 명령, 희귀도, 제한)를 갖춘 게임 내 설정 가능한 crate 시스템이 필요하다면, ExcellentCrates는 이러한 기능과 수동 파일 편집을 거의 필요로 하지 않는 편집 워크플로를 제공합니다.

ExcellentCrates 플러그인 서버