Minecraft प्लगइन QuickShop-Hikari

🔌 QuickShop-Hikari के बारे में

QuickShop-Hikari एक Minecraft प्लगइन है जो chest-based buy/sell shops (ChestShops) लागू करता है। खिलाड़ी chests के साथ इंटरैक्ट करके shops बनाते और इस्तेमाल करते हैं; ज़्यादातर gameplay के लिए किसी भी command की ज़रूरत नहीं होती। यह प्रोजेक्ट QuickShop-Community द्वारा मेंटेन किया जाता है और modern compatibility, data safety, तथा extensible integrations पर केंद्रित है।

🎯 उद्देश्य

एक in-game, item-based economy देना, जहाँ खिलाड़ी items को बिक्री के लिए सूचीबद्ध कर सकें या chests का उपयोग करके buy-shops बना सकें। यह plugin उन server administrators के लिए बनाया गया है जो एक physical, chest-driven economy और per-shop control चाहते हैं, बिना खिलाड़ियों को commands सीखने के लिए मजबूर किए।

⚙️ विशेषताएँ

• chests और signs का उपयोग करके buy और sell shops बनाना (chest-based shops)।
• NBT data, enchantments, item damage, potion data, और mob eggs के लिए समर्थन।
• shops के ऊपर toggleable virtual display item (ProtocolLib या PacketEvents समर्थित)।
• unlimited chest support और double-chest mixed buy/sell behavior।
• blacklist support के साथ bypass permission विकल्प।
• per-shop permission management और owners तथा अन्य खिलाड़ियों के बीच shop benefits।
• item और enchantment names के लिए i18n support तथा messages के लिए MiniMessage syntax।
• H2 (local) और MySQL (remote) datasource support।
• सामान्य protection और utility plugins के लिए integration hooks (compatibility modules उपलब्ध हैं)।
• Developer API (Maven/Gradle coordinates दिए गए हैं) shops query करने और features integrate करने के लिए।
• bStats telemetry, configuration के माध्यम से opt-out के साथ।

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

Survival/SMP या economy-focused servers चलाने वाले server owners और administrators के लिए, जो एक physical, chest-based marketplace चाहते हैं। यह छोटे से बड़े servers के लिए उपयुक्त है जो Vault-compatible economy plugins का उपयोग करते हैं और per-shop control तथा database-backed storage चाहते हैं।

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

• खिलाड़ी items को chest में रखते हैं और उसे label करके stacks को अपने-आप दूसरे खिलाड़ियों को बेचते हैं।
• कोई admin per-shop permissions सक्षम करता है ताकि moderators specific worlds या regions में shops manage कर सकें।
• एक network MySQL storage का उपयोग करके अलग-अलग server instances के बीच shops को persistent रखता है।

⌨️ Commands

नोट: project documentation के अनुसार normal player gameplay के लिए commands की आवश्यकता नहीं होती; commands मुख्य रूप से administrative हैं।

🔐 Permissions

⚙️ Installation

📥 Setup

• project distribution (Modrinth/Spigot/GitHub releases) से official QuickShop-Hikari jar डाउनलोड करें।
• jar फ़ाइल को अपने server के plugins/ folder में रखें।
• server शुरू करें और verify करें कि plugin loaded है (docs console में qs command चलाकर help/test output दिखाने के लिए कहते हैं)।

📦 Dependencies

Project द्वारा सूचीबद्ध confirmed required/optional integrations:

• Vault (economy bridging के लिए आवश्यक)
• एक Vault-compatible economy plugin (project द्वारा दिए गए examples)
• ProtocolLib या PacketEvents (virtual display items / per-player localization के लिए आवश्यक)
• LuckPerms (permission management के लिए recommended)

🧾 Configuration

• plugin config.yml बनाता और उपयोग करता है (docs display protocol और privacy settings के लिए config.yml keys का संदर्भ देते हैं)।
• data storage local H2 या remote MySQL को सपोर्ट करता है; configuration options plugin configuration files में उपलब्ध हैं।

🧠 Technical Notes

• official documentation Paper-based server पर चलाने की सलाह देती है और Java 21 की requirement बताती है।
• project compile-time usage के लिए developer API और Maven/Gradle coordinates प्रदान करता है।
• QuickShop-Hikari third-party plugins (जैसे WorldGuard, WorldEdit, OpenInv) के लिए compatibility modules optional downloads के रूप में ship करता है।
• Telemetry: bStats का उपयोग करता है; config settings के माध्यम से opt-out किया जा सकता है।

🤝 यह plugin कब उपयोगी है

अगर आप chest-driven, player-facing marketplace चाहते हैं जिसमें persistent storage और per-shop controls हों (GUI-only या command-driven shops के बजाय), तो QuickShop-Hikari common economy और protection plugins के लिए hooks के साथ एक modern, database-backed implementation प्रदान करता है.