Minecraftプラグイン ajLeaderboards

🔌 ajLeaderboards について

ajLeaderboards は、数値を返す任意の PlaceholderAPI プレースホルダーからランキングを作成するための Minecraft プラグインです。プレースホルダーが返す値を収集して順位付けし、ホログラム、内蔵看板、NPC、装備立て、プレイヤーヘッドを使って結果を表示できます。

🎯 目的

このプラグインは、独自実装なしで柔軟かつプラグイン横断的なランキングを作成する問題を解決します。数値の PlaceholderAPI プレースホルダーを提供するプラグインであれば、追跡してワールド内の表示に出したり、他の表示プラグイン向けのプレースホルダーとして公開したりできます。

⚙️ 機能

• 任意の数値 PlaceholderAPI プレースホルダーをランキング項目として追跡。
• 複数の表示方法: ホログラム、内蔵看板、NPC、装備立て、プレイヤーヘッド。
• 自動リセット付きの時間制ランキング（毎時、毎日、毎月など）と、累計統計の保持。
• サーバー間で同期されたランキングのための MySQL 対応（追跡するプレースホルダーも同期されている必要があります）。
• Vault 連携によるプレイヤーの prefix/suffix 表示のオプション。
• ランキング項目と一緒に追加のプレースホルダーテキストを表示するための "Extra" プレースホルダー。
• Folia 対応と、一般的な表示プラグイン（例: ホログラムや NPC システム）との互換性。
• bStats による匿名の利用統計収集（bStats の設定で無効化可能）。

🧩 対象ユーザー

• 経済、統計、カスタム指標の動的ランキングを求める Survival / SMP サーバー。
• すでに PlaceholderAPI を使っていて、ワールド内に順位を表示したいサーバー（ホログラム、看板、NPC）。
• 時間制ランキング（毎日/毎時/月次）と、任意の MySQL 同期が必要な管理者。

🏗️ 使用例

• 経済プラグインのプレースホルダーとホログラムプラグインを使って、経済残高の上位を表示する。
• NPC や看板に、キル数上位やミニゲームのカスタムスコアを表示する。
• イベント勝者向けに毎時または毎日のランキングを実行しつつ、累計記録は保持する。

⌨️ コマンド

(注: コマンド名はプラグインで文書化されています。サーバー運営者は、完全なコマンド一覧と構文についてプラグインの wiki を確認してください。)

🔐 権限

⚙️ インストール

📥 セットアップ

• 公式のプラグイン JAR をダウンロードし、サーバーの plugins/ フォルダに配置します。
• サーバーを起動する前に PlaceholderAPI がインストールされていることを確認してください。追跡値の読み取りには PlaceholderAPI が必要です。
• サーバーを起動または再起動し、コンソールでプラグインが読み込まれたことを確認します。

📦 依存関係

• PlaceholderAPI（必須）
• Vault（任意; prefix/suffix の表示に使用）
• Citizens（任意; NPC ベースのランキング表示用）
• DecentHolograms または他のホログラムプラグイン（任意; ホログラム表示用）

🧠 技術メモ

• このプラグインは時間制ランキング（毎時/毎日/月次）をサポートし、追跡中のプレースホルダー値も同期されている場合に MySQL を使ってランキングを同期できます。
• Folia 対応です。
• プラグインは匿名メトリクスを bStats に送信します。これは bStats の設定で無効化できます。

🤝 このプラグインが役立つ場面

すでに PlaceholderAPI を使っていて、ゲーム内やプレースホルダーとしてランク付けされた数値データ（経済、統計、カスタム指標）を、表示方法に依存せず簡単に公開したいなら、ajLeaderboards は時間制ランキング、複数の表示オプション、任意の MySQL 同期を提供し、プラグインごとの独自統合を必要としません。