प्लगइन और API वर्ज़न कम्पैटिबिलिटी
आपके वर्ज़न पर प्लगइन क्यों नहीं चलता, api-version का क्या मतलब है, रिक्वायरमेंट कैसे पढ़ें, और मिसमैच से क्या हो सकता है।
13 अगस्त 2026 को अपडेट किया गया
प्लगइन सर्वर API के किसी खास वर्शन के लिए बनाया जाता है। मेल न खाने पर या तो वह लोड ही नहीं होता या चलते समय एरर देता है।
कम्पैटिबिलिटी किससे तय होती है
- गेम वर्शन। 1.20 के लिए बना प्लगइन आम तौर पर 1.21 पर काम नहीं करेगा: अंदरूनी क्लासेस बदल जाती हैं।
- कोर। Bukkit/Spigot/Paper “नीचे से ऊपर” कम्पैटिबल हैं: Bukkit प्लगइन Paper पर चलेगा, लेकिन उलटा नहीं, अगर Paper की खास API इस्तेमाल हो रही हो।
- डिपेंडेंसी। Vault, PlaceholderAPI, ProtocolLib — इनके वर्शन भी मेल खाने चाहिए।
api-version
प्लगइन की plugin.yml में लिखा होता है:
api-version: 1.21
अगर यह लाइन बिल्कुल न हो, तो सर्वर प्लगइन को लेगेसी मानकर कम्पैटिबिलिटी मोड चालू कर देता है — लॉग में चेतावनी दिखती है। यह एरर नहीं है, बस पुराने प्लगइन का संकेत है।
आम लक्षण
| लॉग में | मतलब |
|---|---|
Unsupported API version | प्लगइन नए कोर के लिए बनाया गया है |
NoSuchMethodError | आपके वर्शन में वह मेथड ही नहीं है — विस्तार से |
NoClassDefFoundError | डिपेंडेंसी मौजूद नहीं है — विस्तार से |
Invalid plugin.yml | फ़ाइल खराब है या यह प्लगइन ही नहीं है — विस्तार से |
इंस्टॉल करने से पहले जाँच
पैनल के “Plugins and mods” कैटलॉग में आपके कोर और वर्शन के हिसाब से फ़िल्टर लगता है और इंस्टॉल करने से पहले इनकम्पैटिबिलिटी की चेतावनी मिल जाती है — कैसे इंस्टॉल करें। मैन्युअली अपलोड करते समय प्लगइन का पेज देखें: उस पर सपोर्टेड वर्शन की रेंज हमेशा लिखी होती है।
Minecraft होस्टिंगआपके ऑफ़लाइन रहने पर भी सर्वर चलता हैसर्वर बनाएँ
