Minecraft 플러그인 Rankup

🔌 Rankup 소개

Rankup은 설정 가능한 랭크 사다리 진행 시스템을 구현하는 Bukkit/Spigot Minecraft 플러그인입니다. 랭크 단계를 살펴볼 수 있는 GUI, 플레이어가 언제 다음 단계로 올라갈 수 있는지 제어하는 유연한 요구사항 엔진, 반복 진행을 위한 prestige 시스템을 제공합니다. 이 플러그인은 플레이어를 자동으로, 그리고 설정 가능한 방식으로 승급시키고 싶은 서버 관리자용입니다.

🎯 목적

Rankup은 수동 승급 없이 플레이어 진행(랭크 사다리)을 관리하는 문제를 해결합니다. 랭크 정의, 진행 요구사항, 선택적 prestige 기능을 한곳에 모아 서버 소유자가 권한과 사용자 지정 요구사항에 연결된 다단계 진행을 정의할 수 있게 합니다.

⚙️ 기능

• rankups.yml에 정의된 설정 가능한 랭크 사다리.
• 플레이어가 rankup을 보고 확인할 수 있는 GUI.
• 각 랭크 단계의 조건을 정의하는 요구사항 시스템(예: 권한, 플레이 시간, 요구사항 플러그인이 제공하는 토큰/값).
• 별도의 prestiges.yml을 통한 prestige 지원.
• 랭크 목록 보기, 단일 또는 다단계 rankup 실행, 설정 재로드를 위한 명령어.
• 메시지와 GUI에 사용할 수 있도록 플러그인의 placeholder 엔진을 통한 플레이스홀더 지원.
• 명령어와 관리 기능에 대한 권한 기반 접근 제어.

🧩 대상

• 진행 요소나 랭크 사다리를 사용하는 Survival / SMP 서버.
• 단계별 승급 시스템을 제공하는 Prison 또는 경제 서버.
• GUI 지원과 함께 권한 기반 랭크 승급을 원하는 서버 관리자.

🏗️ 사용 예시

• 플레이어가 다음 단계로 올라가기 전에 플레이 시간이나 아이템이 자동으로 더 많이 요구되는 랭크 순서를 정의하기.
• prestige를 사용해 플레이어의 랭크를 초기화하면서 특별 보상이나 진행 카운터를 부여하기.
• 권한 플러그인과 연동해 플레이어가 승급할 때 랭크 관련 권한 노드를 부여하거나 제거하기.

⌨️ 명령어

🔐 권한

⚙️ 설치

📥 설정

• 플러그인 배포본(공식 리소스)에서 플러그인 JAR을 다운로드하거나 소스에서 빌드하세요.
• JAR을 서버의 plugins/ 디렉터리에 넣으세요.
• 서버를 시작하거나 재시작한 뒤 콘솔 출력을 확인해 플러그인이 로드되었는지 확인하세요.
• 제공된 설정 파일(rankups.yml, prestiges.yml, locale/config)과 재로드 명령어를 사용해 실행 중에 변경 사항을 적용하세요.

📦 소스에서 빌드

• 이 프로젝트에는 Gradle wrapper가 포함되어 있습니다. 포함된 gradlew build를 실행하면 build/libs 디렉터리에 플러그인 JAR이 생성됩니다.

🧠 기술 참고

• 이 플러그인은 랭크와 prestige 정의를 위해 YAML 설정 파일(특히 rankups.yml과 prestiges.yml)을 사용합니다.
• placeholder 엔진을 제공하며 메시지와 GUI에서 사용할 플레이스홀더를 지원합니다.
• 명령어용 명시적 권한 노드와 OP 접근을 반영하는 관리 권한을 제공합니다.
• 소스 코드는 GPL-3.0으로 배포됩니다.

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

GUI와 prestige 지원이 있는, 설정 가능하고 권한 기반인 랭크 사다리가 필요하다면 Rankup은 랭크 정의와 진행 규칙을 한곳에 모아 수동 승급 없이 플레이어 진행을 자동화합니다.