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 はランク定義と進行ルールを一元化して、手動昇格なしでプレイヤーの進行を自動化します。