Minecraft प्लगइन AxRewards

🔌 AxRewards के बारे में

AxRewards एक Minecraft प्लगइन है जो एक हल्का, कॉन्फ़िगर करने योग्य रिवॉर्ड सिस्टम प्रदान करता है। सर्वर एडमिन मनचाहे cooldown के साथ रिवॉर्ड तय करते हैं, उन्हें editable GUI में दिखाते हैं, और जब खिलाड़ी रिवॉर्ड claim करते हैं तो claim commands चलाते हैं। इस प्रोजेक्ट का रखरखाव Artillex-Studios द्वारा किया जाता है और इसमें database-backed storage तथा multi-server support शामिल है।

🎯 उद्देश्य

AxRewards खिलाड़ियों के scheduled या repeatable rewards की सामान्य आवश्यकता को हल करता है (जैसे daily या weekly login rewards) और साथ ही flexible cooldowns, permission locks, और GUI presentation भी देता है। यह उन सर्वरों के लिए बनाया गया है जो external caching systems की जरूरत के बिना एक integrated, configurable reward system चाहते हैं।

⚙️ सुविधाएँ

• मनचाहे cooldowns के साथ configurable rewards (seconds में निर्दिष्ट)।
• Rewards दिखाने के लिए editable GUI menus; GUI items अलग-अलग states दिखा सकते हैं (claimable / unclaimable / no-permission)।
• H2, SQLite, MySQL, और PostgreSQL के समर्थन के साथ database storage.
• Redis की जरूरत के बिना multi-server support.
• Auto-updating GUI (GUI बिना दोबारा खोले periodically refresh होती है)।
• Permissions के पीछे rewards को lock करने की क्षमता (हर reward के लिए permission आवश्यक हो सकता है)।
• Claim actions server commands की सूची के रूप में लागू किए गए हैं ( %player% placeholder का समर्थन करता है)।
• PlaceholderAPI integration और कई color formats का समर्थन.

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

• Survival और SMP servers जो daily/weekly/custom claimable rewards चाहते हैं।
• Server operators जिन्हें restarts के बीच या कई servers पर database-backed persistence चाहिए।
• Admins जो GUI-based reward presentation और permission-locked rewards पसंद करते हैं।

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

• एक daily login reward दें जो claim होने पर items देता है या commands चलाता है।
• ऐसे gated weekly VIP rewards प्रदान करें जिनके लिए claim करने से पहले rank permission आवश्यक हो।
• command-based rewards चलाएँ जो money, items दें, या %player% का उपयोग करके custom server commands execute करें।

⌨️ Commands

(केवल आधिकारिक documentation में पुष्टि किए गए commands सूचीबद्ध हैं।)

⚙️ Installation

📥 Setup

• प्लगइन JAR डाउनलोड करें और Bukkit/Spigot/Paper-compatible server के लिए इसे अपने server के plugins/ folder में रखें।
• server को start या restart करें ताकि plugin अपनी data folders और configuration बना सके।
• Configuration और menu files plugin folder में रखी जाती हैं (उदाहरण के लिए plugins/AxRewards/menus)।

📦 Dependencies

• PlaceholderAPI (placeholders के लिए optional integration) — समर्थन पुष्टि किया गया है।

🧠 Technical Notes

• पुष्टि किए गए database backends: H2, SQLite, MySQL, PostgreSQL.
• यह प्लगइन PlaceholderAPI और common color formats (MiniMessage और legacy formats सहित) का समर्थन करता है।
• GUI automatically refresh होती है (auto-updating) बिना खिलाड़ियों को इसे फिर से खोलने की जरूरत के।
• Rewards अपना cooldown seconds में परिभाषित करते हैं; cooldown को -1 पर सेट करने से reward कभी refresh नहीं होता।
• यह project open-source है और MIT के अंतर्गत licensed है।
• पुष्टि किए गए supported server software और topics में Bukkit, Spigot, Paper, और Folia शामिल हैं।
• पुष्टि की गई आवश्यकता: modern Java runtime (project notes recent releases के लिए Java 21 या उससे ऊपर दर्शाते हैं)।

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

अगर आपको एक configurable, GUI-driven rewards system चाहिए जिसमें persistent storage और cross-server support हो, तो AxRewards editable menus, cooldown handling, और command-based claim actions प्रदान करता है, साथ ही PlaceholderAPI और common databases के साथ integrate भी करता है।