Minecraft plugin ajLeaderboards

🔌 About ajLeaderboards

ajLeaderboards is a Minecraft plugin for creating leaderboards from any PlaceholderAPI placeholder that returns a numeric value. It collects and ranks values reported by placeholders and can display results using holograms, built-in signs, NPCs, armor stands, and player heads.

🎯 Purpose

The plugin solves the problem of producing flexible, cross-plugin leaderboards without requiring custom integration: any plugin that exposes a numeric PlaceholderAPI placeholder can be tracked and shown on in-world displays or exposed as placeholders for other display plugins.

⚙️ Features

• Track any numeric PlaceholderAPI placeholder as a leaderboard entry.
• Multiple display options: holograms, built-in signs, NPCs, armor stands and player heads.
• Timed leaderboards with automatic resets (hourly, daily, monthly, etc.) while preserving all-time stats.
• MySQL support for synchronized leaderboards across servers (requires the tracked placeholder to be synced as well).
• Optional display of player prefix/suffix via Vault integration.
• "Extra" placeholders to display additional placeholder text alongside leaderboard entries.
• Folia support and compatibility with common display plugins (e.g., hologram and NPC systems).
• Anonymous usage stats collection via bStats (can be disabled in bStats config).

🧩 Who It Is For

• Survival and SMP servers that want dynamic leaderboards for balances, stats or custom metrics.
• Servers that already use PlaceholderAPI and want to display ranks in-world (holograms, signs, NPCs).
• Admins who need timed leaderboards (daily/hourly/monthly) and optional MySQL synchronization.

🏗️ Example Use Cases

• Display the top economy balances using an economy plugin placeholder and a hologram plugin.
• Show the top kill counts or custom minigame scores on NPCs or signs.
• Run hourly or daily leaderboards for event winners while retaining all-time records.

⌨️ Commands

(Note: command names are documented by the plugin; server operators should check the plugin's wiki for the full command list and syntax.)

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official plugin JAR and place it in your server plugins/ folder.
• Ensure PlaceholderAPI is installed before starting the server; the plugin requires PlaceholderAPI to read tracked values.
• Start or restart the server and check the server console to confirm the plugin loaded.

📦 Dependencies

• PlaceholderAPI (required)
• Vault (optional; used for showing prefixes/suffixes)
• Citizens (optional; for NPC-based leaderboard displays)
• DecentHolograms or other hologram plugins (optional; for hologram displays)

🧠 Technical Notes

• The plugin supports timed leaderboards (hourly/daily/monthly) and can use MySQL to sync leaderboards when the tracked placeholder value is also synchronized.
• Folia support is provided.
• The plugin sends anonymous metrics to bStats; this can be disabled via bStats configuration.

🤝 When This Plugin Is Useful

If you already use PlaceholderAPI and want an easy, display-agnostic way to expose ranked numeric data (economy, stats, custom metrics) in-world or as placeholders, ajLeaderboards provides timed leaderboards, multiple display options and optional MySQL sync without requiring custom per-plugin integrations.