Minecraft 플러그인 PhoenixCrates

🔌 Phoenix Crates 소개

Phoenix Crates는 서버에서 crate/보상 시스템을 운영하기 위한 Minecraft 플러그인입니다. crate 유형, 키(실물 및 가상), 애니메이션이 적용된 개봉 연출, 그리고 원본 파일을 직접 편집하지 않고도 crate와 보상을 만들고 관리할 수 있는 인게임 편집기를 제공합니다. 이 프로젝트는 Phoenix Plugins에서 배포하며, 무료 버전과 추가 기능이 포함된 유료 프리미엄 버전이 있습니다.

🎯 목적

서버 관리자에게 애니메이션 개봉을 보여주고, 키와 가상 화폐형 키를 관리하며, 스태프가 게임 내에서 crate와 보상을 만들거나 수정할 수 있는 설정 가능한 보상/crate 시스템을 제공하는 것입니다. 이벤트형 또는 상점/보상 메커니즘을 원하는 서버를 위한 것입니다(예: 보상 증정, 스토어 crate, 이벤트 상품).

⚙️ 기능

• 여러 crate 엔진 모드(바닐라 블록, 바닐라 모델, Model Engine 연동).
• 설정 가능한 단계와 조합을 가진 애니메이션 개봉 시퀀스와 대기 애니메이션.
• 실물 키와 가상 키 관리(가상 키 메뉴, 지불/전송, give/take/set 명령).
• crate, 키, 보상, 애니메이션을 만들고/수정하는 인게임 편집기.
• 랜덤 및 선택형 보상(플레이어가 선택), 재추첨, 확정 보상을 포함한 보상 유형.
• 애드온 및 프리미엄 추가 기능(추가 애니메이션, MySQL 지원, API, 프리미엄 플랜의 애드온 설치).
• 특정 애니메이션과 모델에 대한 기본 Bedrock/Geyser 보기 지원.
• 서버 측 미리보기 및 보상 관리 도구(전체/플레이어 당 당첨 제한, 쿨다운 초기화).

🧩 대상

• crate나 보상 시스템을 제공하는 Survival/SMP 및 경제 서버.
• 애니메이션/시각적 crate 개봉과 모델 지원(Model Engine)을 원하는 서버.
• 수동 파일 편집보다 인게임 편집기를 사용해 crate를 설정하려는 관리자.

🏗️ 사용 예시

• 플레이어에게 GUI에서 사용해 코스메틱 또는 아이템 crate를 열 수 있는 가상 키를 지급하기.
• 커스텀 개봉 애니메이션과 제한된 보상이 있는 시즌 테마 crate 만들기.
• YAML을 수동으로 편집하지 않고 인게임 편집기로 crate 구성을 이전하거나 다시 만들기.

⌨️ 명령어

(위 명령어는 Phoenix Crates 공식 문서와 명령어 참고 자료에서 가져온 것입니다.)

🔐 권한

(프로젝트에서 명시적으로 문서화한 권한 노드만 나열되어 있습니다.)

⚙️ 설치

📥 설정

• 공식 Phoenix Crates 플러그인 JAR을 다운로드하거나 공식 배포 채널에서 받으세요.
• 지원되는 서버의 경우 JAR을 서버의 plugins/ 디렉터리에 넣으세요(기술 참고 참조).
• 서버를 시작하거나 재시작한 뒤 콘솔에서 플러그인이 로드되었는지 확인하세요.
• 인게임 편집기나 제공된 명령어를 사용해 crate와 키를 만드세요. 플러그인에는 다시 불러오기 및 편집기 명령어도 포함되어 있습니다.

📦 종속성

• 기본적으로 필요한 서드파티 종속성은 없습니다. 이 플러그인은 사용자 지정 모델용 Model Engine 같은 선택적 시스템과 연동되며, 업데이트 로그에 언급된 placeholder도 제공합니다.

🧠 기술 참고

• 지원되는 서버 소프트웨어(작성자 기준): Spigot 및 Spigot 포크, Paper 및 Paper 포크, Folia.
• 지원되는 Minecraft 버전: 문서에 따르면 Phoenix Crates(명시된 버전 기준)는 Minecraft 1.20.4+를 지원합니다(이전 버전 지원은 언급된 주요 릴리스에서 종료됨).
• 선택적 연동: Model Engine(사용자 지정 애니메이션 모델), Bedrock 보기를 위한 GeyserMC 호환 참고, 업데이트에서 언급된 PlaceholderAPI placeholder.
• 프로젝트는 무료 및 프리미엄 등급으로 제공되며, 프리미엄에는 MySQL 지원, 공개 API 접근, 무제한 crate, 추가 애니메이션, 애드온이 포함됩니다.

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

설정 가능한 애니메이션 기반 crate 시스템이 필요하고, 인게임 편집기와 선택적 모델/Bedrock 지원이 필요하다면 Phoenix Crates는 플레이어용 시각 요소와 서버에서 보상 및 키를 관리하는 관리자 도구를 모두 제공합니다.