ప్లగిన్ మరియు 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” కేటలాగ్ మీ కోర్ మరియు వెర్షన్ ప్రకారం ఫిల్టర్ చేసి, ఇన్స్టాల్ చేయడానికి ముందే అనుకూలత లేకపోవడం గురించి హెచ్చరిస్తుంది — ఎలా ఇన్స్టాల్ చేయాలి. మాన్యువల్గా అప్లోడ్ చేసేటప్పుడు ప్లగిన్ పేజీని చూడండి: అందులో సపోర్ట్ చేసే వెర్షన్ల పరిధి ఎప్పుడూ ఉంటుంది.
