Minecraft प्लगइन ajLeaderboards

🔌 ajLeaderboards के बारे में

ajLeaderboards एक Minecraft प्लगइन है जो किसी भी PlaceholderAPI placeholder से लीडरबोर्ड बनाने के लिए है, जो एक numeric value लौटाता है। यह placeholders द्वारा रिपोर्ट किए गए मानों को इकट्ठा करता है और रैंक करता है, और परिणामों को holograms, built-in signs, NPCs, armor stands, और player heads के जरिए दिखा सकता है।

🎯 उद्देश्य

यह प्लगइन custom integration की जरूरत बिना flexible, cross-plugin leaderboards बनाने की समस्या हल करता है: कोई भी प्लगइन जो numeric PlaceholderAPI placeholder expose करता है, उसे track किया जा सकता है और in-world displays पर दिखाया जा सकता है या दूसरे display plugins के लिए placeholders के रूप में expose किया जा सकता है।

⚙️ फीचर्स

• किसी भी numeric PlaceholderAPI placeholder को leaderboard entry के रूप में track करें।
• कई display विकल्प: holograms, built-in signs, NPCs, armor stands, और player heads।
• automatic resets के साथ timed leaderboards (hourly, daily, monthly, आदि) और साथ में all-time stats सुरक्षित रहें।
• servers के बीच synchronized leaderboards के लिए MySQL support (tracked placeholder का sync भी होना चाहिए)।
• Vault integration के जरिए player prefix/suffix को optional रूप से दिखाना।
• leaderboard entries के साथ अतिरिक्त placeholder text दिखाने के लिए "Extra" placeholders।
• Folia support और आम display plugins (जैसे hologram और NPC systems) के साथ compatibility।
• bStats के जरिए anonymous usage stats collection (bStats config में disabled किया जा सकता है)।

🧩 यह किसके लिए है

• Survival और SMP servers जो balances, stats, या custom metrics के लिए dynamic leaderboards चाहते हैं।
• ऐसे servers जो पहले से PlaceholderAPI का उपयोग करते हैं और world में ranks दिखाना चाहते हैं (holograms, signs, NPCs)।
• Admins जिन्हें timed leaderboards (daily/hourly/monthly) और optional MySQL synchronization की जरूरत है।

🏗️ उदाहरण उपयोग

• economy plugin placeholder और hologram plugin का उपयोग करके सबसे ऊँचे economy balances दिखाना।
• NPCs या signs पर top kill counts या custom minigame scores दिखाना।
• event winners के लिए hourly या daily leaderboards चलाना और all-time records बनाए रखना।

⌨️ कमांड्स

(नोट: command names plugin द्वारा documented हैं; server operators को पूरी command list और syntax के लिए plugin की wiki देखनी चाहिए।)

🔐 Permissions

⚙️ Installation

📥 Setup

• official plugin JAR डाउनलोड करें और उसे अपने server के plugins/ folder में रखें।
• server शुरू करने से पहले सुनिश्चित करें कि PlaceholderAPI installed है; plugin को tracked values पढ़ने के लिए PlaceholderAPI चाहिए।
• server start या restart करें और server console जांचें ताकि पुष्टि हो सके कि plugin loaded है।

📦 Dependencies

• PlaceholderAPI (required)
• Vault (optional; prefixes/suffixes दिखाने के लिए)
• Citizens (optional; NPC-based leaderboard displays के लिए)
• DecentHolograms या अन्य hologram plugins (optional; hologram displays के लिए)

🧠 Technical Notes

• यह plugin timed leaderboards (hourly/daily/monthly) support करता है और tracked placeholder value भी synchronized हो तो leaderboards sync करने के लिए MySQL का उपयोग कर सकता है।
• Folia support उपलब्ध है।
• plugin anonymous metrics bStats को भेजता है; इसे bStats configuration के माध्यम से disabled किया जा सकता है।

🤝 यह प्लगइन कब उपयोगी है

अगर आप पहले से PlaceholderAPI उपयोग करते हैं और ranked numeric data (economy, stats, custom metrics) को world में या placeholders के रूप में दिखाने का आसान, display-agnostic तरीका चाहते हैं, तो ajLeaderboards timed leaderboards, multiple display options, और optional MySQL sync प्रदान करता है, बिना प्रति-plugin custom integrations के।