پلگ ان اور API ورژن کی مطابقت

آپ کے ورژن پر پلگ ان کیوں کام نہیں کرتا، api-version کا مطلب کیا ہے، ضروریات کیسے پڑھیں، اور مماثلت نہ ہونے سے کیا ہو سکتا ہے۔

اپ ڈیٹ 13 اگست، 2026

پلگ ان سرور API کے مخصوص ورژن کے لیے بنایا جاتا ہے۔ مماثلت نہ ہونے کی صورت میں یا تو یہ لوڈ ہی نہیں ہوتا یا چلتے وقت ایرر دیتا ہے۔

مماثلت کا تعین کیا کرتا ہے

گیم ورژن۔ 1.20 کے لیے بنایا گیا پلگ ان عام طور پر 1.21 پر کام نہیں کرے گا: اندرونی کلاسز بدل جاتی ہیں۔
کور۔ Bukkit/Spigot/Paper "نیچے سے اوپر" کے اصول پر مماثل ہیں: Bukkit پلگ ان Paper پر چلے گا، لیکن اس کے برعکس نہیں، اگر Paper کے مخصوص APIs استعمال ہوں۔
ڈیپینڈنسیز۔ Vault، PlaceholderAPI، ProtocolLib — ان کے ورژن بھی مماثل ہونے چاہئیں۔

api-version

پلگ ان کی plugin.yml میں درج ہوتا ہے:

api-version: 1.21

اگر یہ لائن بالکل موجود نہ ہو، تو سرور پلگ ان کو لیگیسی سمجھتا ہے اور کمپیٹیبلٹی موڈ آن کر دیتا ہے — لاگ میں ایک وارننگ ظاہر ہوتی ہے۔ یہ ایرر نہیں، بلکہ پرانے پلگ ان کی نشانی ہے۔

عام علامات

لاگ میں	مطلب
`Unsupported API version`	پلگ ان کسی نئے کور کے لیے بنایا گیا تھا
`NoSuchMethodError`	آپ کے ورژن میں یہ میتھڈ موجود نہیں — تفصیل
`NoClassDefFoundError`	ڈیپینڈنسی غائب ہے — تفصیل
`Invalid plugin.yml`	فائل خراب ہے یا یہ پلگ ان ہی نہیں — تفصیل

انسٹالیشن سے پہلے جانچ

پینل میں "Plugins and mods" کیٹلاگ آپ کے کور اور ورژن کے مطابق فلٹر کرتا ہے اور انسٹالیشن سے پہلے عدم مطابقت سے خبردار کرتا ہے — انسٹال کرنے کا طریقہ۔ دستی طور پر اپلوڈ کرتے وقت پلگ ان کا صفحہ دیکھیں: وہاں ہمیشہ سپورٹڈ ورژنز کی رینج درج ہوتی ہے۔

Minecraft ہوسٹنگآپ کے آف لائن ہونے پر بھی آپ کا سرور چلتا ہےسرور بنائیں