Paper और Spigot में प्लगइन plugins फ़ोल्डर में रखी एक अकेली JAR फ़ाइल (एक Java आर्काइव) होता है। अगर यह फ़ाइल खराब हो, खाली हो, दो बार मौजूद हो या असल में कोई मॉड या लाइब्रेरी हो, तो सर्वर प्लगइन लोड नहीं करता या स्टार्ट होते समय क्रैश हो जाता है। नीचे का हर सेक्शन इनमें से एक मैसेज के बारे में है। सर्वर हेल्थ में “और जानें” पर क्लिक करके तुम सीधे सही सेक्शन पर पहुँच जाओगे।

पूरा टेक्स्ट तुम्हें कंसोल में या फ़ाइलें के अंदर logs/latest.log में मिलेगा। आमतौर पर मैसेज के ठीक नीचे की लाइनें सबसे ज़रूरी होती हैं, क्योंकि असली वजह वहीं लिखी होती है। प्लगइन फ़ाइलें सिर्फ़ तभी बदलो जब सर्वर बंद हो। पहले बैकअप में एक बैकअप बना लो, खासकर तब जब वर्ल्ड या कॉन्फ़िगरेशन फ़ाइलों पर भी असर पड़ सकता हो।

“Error occurred while enabling …”: प्लगइन स्टार्ट नहीं हो रहा

मैसेज ऐसा दिखता है:

Error occurred while enabling <Plugin> v<Version> (Is it up to date?)
java.net.SocketTimeoutException: Read timed out
Error occurred while disabling DeluxeMenus v<Version>

इसके पीछे क्या है: एक्टिवेट होते समय प्लगइन क्रैश हो गया और उसे बंद कर दिया गया। सर्वर चलता रहता है, लेकिन प्लगइन के फ़ीचर काम नहीं करते; प्रोटेक्शन, परमिशन या लॉगिन प्लगइन के मामले में उनकी सुरक्षा भी नहीं रहती। ज़्यादातर मामलों में सर्वर और प्लगइन के वर्शन आपस में मेल नहीं खाते। किसी बाहरी सर्विस से जवाब न मिलने पर भी प्लगइन स्टार्ट नहीं हो पाता।

इसे ऐसे ठीक करो:

  1. प्लगइन के पेज पर देखो कि कौन-सा रिलीज़ तुम्हारे सर्वर वर्शन को सपोर्ट करता है, और सर्वर बंद करके अपडेट करो।
  2. NoSuchMethodError (कोई मेथड मौजूद नहीं) या NoClassDefFoundError (प्रोग्राम का कोई हिस्सा मौजूद नहीं) आने पर बताई गई डिपेंडेंसी और वर्शन जाँचो। Bukkit का ज़िक्र होने पर समस्या सर्वर इंटरफ़ेस से जुड़ी हो सकती है।
  3. SocketTimeoutException: Read timed out का मतलब है कि नेटवर्क डेटा के इंतज़ार का समय खत्म हो गया। दोबारा स्टार्ट करने से पहले इस्तेमाल की गई सर्विस और प्लगइन कॉन्फ़िगरेशन में उसका एड्रेस जाँचो।
  4. Communications link failure आने पर प्लगइन कॉन्फ़िगरेशन में और डेटाबेस के अंदर डेटाबेस के लॉगिन विवरण जाँचो।
  5. zip file closed आने पर सर्वर को पूरी तरह रीस्टार्ट करो। अगर एरर बना रहे, तो सर्वर बंद करके प्लगइन फ़ाइल को सही डाउनलोड से बदल दो।
  6. रीस्टार्ट के बाद कंसोल में देखो कि प्लगइन एक्टिवेट हो रहा है या नहीं।

जानने लायक बात: “Error occurred while disabling” प्लगइन के बंद होने से जुड़ा है। अगर इससे पहले एक्टिवेशन एरर आया हो, तो पहले उसे देखो। और जानकारी: प्लगइन सर्वर वर्शन से मेल नहीं खाता।

प्लगइन फ़ाइल छोड़ दी जाती है (“Could not load 'plugins/…jar'”)

मैसेज ऐसा दिखता है:

[ModernPluginLoadingStrategy] Could not load 'plugins/<Plugin>.jar' in 'plugins'
org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [ProtocolLib]. Please download and install these plugins to run '<Plugin>'.

इसके पीछे क्या है: सर्वर बताई गई JAR को प्लगइन के तौर पर लोड नहीं कर पाया और उसे छोड़ देता है। JAR (Java आर्काइव) वह फ़ाइल है जिसमें प्लगइन होता है। बाकी सर्वर चलता रह सकता है, लेकिन यह प्लगइन पूरी तरह गायब रहता है। इसकी वजह खराब या अमान्य फ़ाइल हो सकती है, या ऐसी JAR जिसमें पढ़ने लायक plugin.yml न हो, यानी वह डिस्क्रिप्शन फ़ाइल जिससे सर्वर प्लगइन को पहचानता है। “Failed to run bootstrapper” का मतलब है कि Paper प्लगइन स्टार्टअप के सबसे शुरुआती चरण में ही फ़ेल हो गया।

इसे ऐसे ठीक करो:

  1. मैसेज के नीचे की लाइन पढ़ो। अगर वहाँ UnknownDependencyException लिखा है, तो कोई दूसरा प्लगइन मौजूद नहीं है: स्क्वेयर ब्रैकेट में लिखा प्लगइन इंस्टॉल करो।
  2. नहीं तो सर्वर बंद करो और फ़ाइलें में plugins फ़ोल्डर से संबंधित JAR डिलीट करो।
  3. किसी भरोसेमंद सोर्स से ऐसा रिलीज़ डाउनलोड करो जो तुम्हारे सर्वर टाइप (Paper, Spigot) और Minecraft वर्शन से मेल खाता हो, और उसे अपलोड करो।
  4. सर्वर रीस्टार्ट करो।

जानने लायक बात: अगर पाथ plugins/.paper-remapped की ओर इशारा करता है, तो यह वह कॉपी है जो Paper, Spigot प्लगइन के लिए बनाता है। plugins में मौजूद ओरिजिनल JAR बदलो, कॉपी Paper अगले स्टार्ट पर खुद दोबारा बना लेगा। गायब प्लगइन के बारे में: प्लगइन को किसी दूसरे प्लगइन की ज़रूरत है।

“Error initializing plugin …”: प्लगइन स्टार्ट होते समय फ़ेल हो जाता है

मैसेज ऐसा दिखता है:

[<Plugin>] Error initializing plugin '<Plugin>-<Version>.jar' in folder '<Ordner>' (Is it up to date?)
java.lang.ExceptionInInitializerError
java.lang.IllegalStateException: English locale not found in Geyser.

इसके पीछे क्या है: प्लगइन तब क्रैश हो गया जब सर्वर उसे तैयार कर रहा था, यानी एक्टिवेट होने से भी पहले। वह डिसेबल ही रहता है, उसके कमांड और फ़ीचर काम नहीं करते, और सर्वर उसके बिना चलता रहता है। ज़्यादातर मामलों में प्लगइन का वर्शन सर्वर वर्शन से मेल नहीं खाता। नीचे की एरर लाइन में अक्सर वर्शन या कोई गायब क्लास बताई जाती है, यानी प्रोग्राम का वह हिस्सा जिसकी प्लगइन को सर्वर में उम्मीद होती है।

इसे ऐसे ठीक करो:

  1. सबसे पहले फ़ाइलें में logs/latest.log की अगली लाइनें पढ़ो, खासकर Caused by। उनमें असली वजह लिखी होती है।
  2. अपने सर्वर वर्शन के लिए सही प्लगइन वर्शन इंस्टॉल करो या प्लगइन अपडेट करो। प्लगइन के पेज पर सपोर्ट किए गए वर्शन लिखे होते हैं।
  3. अगर तुम्हारे सर्वर वर्शन के लिए अभी कोई सही रिलीज़ नहीं है, तो प्लगइन के अपडेट का इंतज़ार करो या फ़िलहाल वर्शन में किसी सपोर्ट किए गए वर्शन पर बने रहो।
  4. अगर इससे भी काम न बने, तो टेस्ट के तौर पर प्लगइन हटा दो और पूरे मैसेज के साथ प्लगइन के ऑथर को एरर की रिपोर्ट करो।
  5. सर्वर रीस्टार्ट करो।

जानने लायक बात: अगर Geyser “English locale not found” दिखाता है, तो फ़ाइल अधूरी है। Geyser को उसके ऑफ़िशियल प्रोजेक्ट पेज से दोबारा डाउनलोड करो। और जानकारी: प्लगइन सर्वर वर्शन से मेल नहीं खाता।

Paper कोई प्लगइन लोड नहीं कर रहा (“Could not load plugin … in folder”)

मैसेज ऐसा दिखता है:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>-<Version>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.ExceptionInInitializerError

इसके पीछे क्या है: Paper स्टार्ट होते समय बताए गए प्लगइन को लोड नहीं कर पाया। प्लगइन पूरी तरह गायब रहता है, जबकि बाकी सर्वर स्टार्ट हो जाता है। वजह ठीक नीचे की लाइन में लिखी होती है, आमतौर पर खराब plugin.yml, कोई गायब डिपेंडेंसी या किसी दूसरे सर्वर वर्शन के लिए बना बिल्ड। उदाहरण के लिए, “API version string” वाले मैसेज का मतलब है कि plugin.yml में वर्शन की जानकारी ऐसे फ़ॉर्मैट में है जिसे तुम्हारा सर्वर वर्शन नहीं समझता।

इसे ऐसे ठीक करो:

  1. मैसेज के ठीक नीचे की लाइन पढ़ो।
  2. अपने सर्वर वर्शन के हिसाब से प्लगइन दोबारा डाउनलोड करो।
  3. सर्वर बंद करो, फ़ाइलें में plugins से पुरानी JAR हटाओ और नई अपलोड करो।
  4. सर्वर रीस्टार्ट करो और कंसोल में देखो कि प्लगइन अब लोड हो रहा है या नहीं।

जानने लायक बात: अगर नीचे की लाइन में किसी गायब प्लगइन का नाम है, तो समस्या फ़ाइल में नहीं है। ऐसे में प्लगइन को किसी दूसरे प्लगइन की ज़रूरत है गाइड मदद करेगी।

“Ambiguous plugin name …”: प्लगइन दो बार इंस्टॉल है

मैसेज ऐसा दिखता है:

[ModernPluginLoadingStrategy] Ambiguous plugin name 'ViaVersion' for files 'plugins/ViaVersion.jar' and 'plugins/ViaVersion-<Version>.jar' in 'plugins'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'LPC' for files 'plugins/.paper-remapped/LPC-<Version>.jar' and 'plugins/.paper-remapped/LPC-<AndereVersion>.jar' in 'plugins/.paper-remapped'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'Slimefun' for files 'plugins/.paper-remapped/<Datei>.jar' and 'plugins/.paper-remapped/<AndereDatei>.jar' in 'plugins/.paper-remapped'

इसके पीछे क्या है: दो JAR फ़ाइलें एक ही इंटरनल प्लगइन नाम बता रही हैं, भले ही उनके फ़ाइल नाम अलग हों। आमतौर पर ये एक पुराना और एक नया वर्शन या एक ही प्लगइन के दो वेरिएंट होते हैं। सर्वर इनमें से सिर्फ़ एक को लोड करता है और हो सकता है कि वह अनचाहे वर्शन के साथ चले।

इसे ऐसे ठीक करो:

  1. सर्वर बंद करो और फ़ाइलें में जाकर plugins फ़ोल्डर खोलो।
  2. मैसेज में बताई गई दोनों फ़ाइलों का उनकी ओरिजिनल JAR से मिलान करो। plugins/.paper-remapped में Paper की बदली हुई कॉपियाँ होती हैं; अनचाही ओरिजिनल JAR को plugins से हटाओ, सिर्फ़ उसकी कॉपी को नहीं।
  3. सिर्फ़ एक ऐसा वर्शन रखो जो तुम्हारे सर्वर वर्शन से मेल खाता हो। प्लगइन के डेटा फ़ोल्डर मत हटाओ।
  4. सर्वर रीस्टार्ट करो। कंसोल में देखो कि मैसेज अब भी आ रहा है या नहीं; plugins कमांड लोड हुए प्लगइन दिखाती है।

जानने लायक बात: प्लगइन तभी अपडेट करो जब सर्वर बंद हो, और नई JAR अपलोड करने से पहले पुरानी JAR हटा दो।

“does not contain a paper-plugin.yml or plugin.yml”: फ़ाइल प्लगइन नहीं है

मैसेज ऐसा दिखता है:

Directory 'plugins/<Mod>-fabric-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!
Directory 'plugins/<Mod>-neoforge-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!

इसके पीछे की वजह: plugins फ़ोल्डर में एक ऐसी JAR है जिसमें न plugin.yml है और न paper-plugin.yml, यानी उसमें प्लगइन की जानकारी देने वाली कोई फ़ाइल नहीं है। ज़्यादातर यह Fabric, Forge या NeoForge का मॉड होता है; कभी-कभी यह डेटाबेस ड्राइवर जैसी कोई Java लाइब्रेरी होती है। Paper और उसके वैरिएंट इस फ़ाइल को प्लगइन की तरह लोड नहीं कर सकते और इसे छोड़ देते हैं। सर्वर चलता रहता है, लेकिन जिस फ़ीचर की तुम्हें उम्मीद थी वह नहीं मिलता।

इसे ऐसे ठीक करो:

  1. सर्वर बंद करो और फ़ाइलें में जाकर बताई गई फ़ाइल को plugins/ से हटा दो।
  2. प्रोजेक्ट के पेज पर Paper या Spigot के लिए ऐसा वर्शन ढूँढो जो तुम्हारे Minecraft वर्शन से मेल खाता हो।
  3. अगर सिर्फ़ मॉड उपलब्ध है, तो पहले जाँचो कि वह सर्वर पर चलाने के लिए है भी या नहीं। कुछ मॉड सिर्फ़ गेम क्लाइंट में चलते हैं।
  4. अगर तुम मॉड सर्वर पर जाना चाहते हो, तो पहले बैकअप में एक बैकअप बना लो। फिर सॉफ़्टवेयर / लोडर बदलें में ठीक वही लोडर चुनो जो मॉड को चाहिए। तुम्हारे Paper प्लगइन वहाँ नहीं चलेंगे।
  5. सर्वर रीस्टार्ट करो और कंसोल जाँचो।

सॉफ़्टवेयर बदलने का तरीका “पैनल में सर्वर सॉफ़्टवेयर और वर्शन बदलना” गाइड में बताया गया है।

“zip file closed”: सर्वर चलते समय प्लगइन फ़ाइल बदली गई

मैसेज ऐसा दिखता है:

java.lang.IllegalStateException: zip file closed
java.lang.IllegalStateException: The plugin classloader for <Plugin> has thrown a zip file error.
io.netty.handler.codec.EncoderException: java.lang.BootstrapMethodError: java.lang.IllegalStateException: zip file closed

इसके पीछे की वजह: प्लगइन की JAR, यानी उसकी प्रोग्राम फ़ाइल, सर्वर चलते समय ओवरराइट या डिलीट की गई, या किसी ने /reload इस्तेमाल किया। इसके बाद प्लगइन अपनी पहले से बंद हो चुकी फ़ाइल से प्रोग्राम के हिस्से लोड करने की कोशिश करता है और एरर देता है। सर्वर रीस्टार्ट होने तक प्लगइन के फ़ीचर काम करना बंद कर सकते हैं। यह मैसेज सर्वर बंद करते समय भी दिख सकता है।

इसे ऐसे ठीक करो:

  1. सर्वर को पूरी तरह रीस्टार्ट करो। अगर संबंधित प्लगइन JAR गायब है, तो रीस्टार्ट से पहले सर्वर बंद करके उसे फ़ाइलें में वापस रखो।
  2. आगे से प्लगइन फ़ाइलें सिर्फ़ सर्वर बंद होने पर बदलो: सर्वर बंद करो, फ़ाइलें में JAR बदलो, फिर सर्वर चालू करो।
  3. /reload का इस्तेमाल मत करो। यह कमांड सर्वर चलते हुए प्लगइन दोबारा लोड करती है, और कई प्लगइन इसे ठीक से नहीं सँभाल पाते।
  4. अगर बिना फ़ाइल बदले भी यह मैसेज आता है, तो कंसोल में उससे पहले की लाइनें पढ़ो। उनसे तुम्हें संबंधित प्लगइन का पता लगाने में मदद मिलेगी।

जानने लायक बात: एरर के दौरान प्लगइन ने जो बदलाव सेव नहीं किए हैं, वे खो सकते हैं।

“duplicate plugin identifier”: दो प्लगइन फ़ाइलें एक ही नाम का दावा कर रही हैं

मैसेज ऐसा दिखता है:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
java.lang.IllegalStateException: … attempted to add duplicate plugin identifier <Plugin> …

इसके पीछे की वजह: दो JAR फ़ाइलें एक ही प्लगइन नाम इस्तेमाल कर रही हैं; Paper उनमें से सिर्फ़ एक को लोड करता है और दूसरी को रिजेक्ट कर देता है। ज़्यादातर मामलों में plugins फ़ोल्डर में किसी प्लगइन का पुराना और नया वर्शन साथ-साथ पड़ा होता है। या फिर दो प्लगइन एक ही नाम का दावा करते हैं: FastAsyncWorldEdit (संक्षेप में FAWE) में WorldEdit पहले से शामिल है, इसलिए अलग से रखी WorldEdit JAR उससे टकराती है। सर्वर चलता रहता है, लेकिन Paper आगे होने वाली गड़बड़ियों की साफ़ चेतावनी देता है।

इसे ऐसे ठीक करो:

  1. सर्वर बंद करो।
  2. फ़ाइलें में plugins फ़ोल्डर से पुरानी या फ़ालतू JAR हटा दो। FAWE के मामले में यह अलग से रखी worldedit-bukkit JAR है।
  3. अगर मैसेज में plugins/.paper-remapped लिखा है, तो पहले plugins फ़ोल्डर की ओरिजिनल JAR फ़ाइलों में डुप्लिकेट वर्शन जाँचो।
  4. सर्वर चालू करो और कंसोल में देखो कि चेतावनी गायब हो गई है और मनचाहा प्लगइन लोड हो रहा है।

जानने लायक बात: WorldEdit की जानी-पहचानी कमांड FAWE के साथ भी काम करती रहती हैं। इससे बिल्डिंग करने और गलतियाँ पलटने का तरीका WorldEdit: एरिया चुनना, बिल्ड करना और बदलाव पलटना गाइड में देखो।

ProtocolLib प्लगइन रीलोडर के बारे में चेतावनी देता है

मैसेज ऐसा दिखता है:

*** ProtocolLib does not support plugin reloaders! ***
*** Please use the built-in reload command!        ***

इसके पीछे की वजह: ProtocolLib सर्वर और खिलाड़ियों के बीच के नेटवर्क कनेक्शन में गहराई से दखल देता है। प्लगइन रीलोडर PlugMan या PlugManX जैसे प्लगइन होते हैं, जो सर्वर चलते समय अलग-अलग प्लगइन लोड या अनलोड करते हैं। ProtocolLib इसे सपोर्ट नहीं करता और असंगत स्थिति की चेतावनी देता है। ऐसे में ProtocolLib और उस पर निर्भर सभी प्लगइन, जैसे एंटी-चीट या डिस्प्ले प्लगइन, गलत तरीके से काम कर सकते हैं।

इसे ऐसे ठीक करो:

  1. ProtocolLib और उसका इस्तेमाल करने वाले प्लगइन को प्लगइन रीलोडर से दोबारा लोड मत करो।
  2. प्लगइन में बदलाव करने के बाद पूरे सर्वर को पूरी तरह रीस्टार्ट करो।
  3. अगर तुम्हें रीलोडर की ज़रूरत नहीं है, तो उसे फ़ाइलें में जाकर plugins फ़ोल्डर से हटा दो, ताकि गलती से उसका इस्तेमाल न हो।
  4. अगर तुमने अभी-अभी रीलोडर इस्तेमाल किया है, तो अब एक बार पूरा रीस्टार्ट करो, ताकि सब कुछ फिर से सही तरह लोड हो जाए।

जानने लायक बात: मैसेज बिल्ट-इन रीलोड कमांड इस्तेमाल करने की सलाह देता है। लेकिन वह भी सर्वर चलते समय सभी प्लगइन दोबारा लोड करती है। सबसे सुरक्षित तरीका पूरा रीस्टार्ट ही है।

“Error loading plugin”: प्लगइन फ़ाइल या प्लगइन का नाम अमान्य है

मैसेज ऐसा दिखता है:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/<Datei>.jar' failed to update!
[DirectoryProviderSource] Error loading plugin: Directory 'plugins/<Datei>.jar' failed to load!
[DirectoryProviderSource] Error loading plugin: Restricted name, cannot use 0x20 (space character) in a plugin name.

इसके पीछे की वजह: plugins फ़ोल्डर की कोई फ़ाइल लोड नहीं हो पा रही है, इसलिए प्लगइन शुरू नहीं होता। अक्सर वहाँ सोर्स कोड (-sources.jar), डॉक्यूमेंटेशन (-javadoc.jar), अधूरा डाउनलोड या किसी दूसरे प्लेटफ़ॉर्म का वर्शन पड़ा होता है। “Invalid plugin.yml” और “only DEFLATED entries can have EXT descriptor” भी गलत फ़ाइल की ओर इशारा करते हैं। “0x20” के साथ “Restricted name” का मतलब है कि plugin.yml में दर्ज प्लगइन के नाम में स्पेस है।

इसे ऐसे ठीक करो:

  1. सर्वर बंद करो और फ़ाइलें में जाकर बताई गई JAR को plugins से हटा दो।
  2. असली प्लगइन JAR आधिकारिक पेज से डाउनलोड करो, जो Paper या Spigot के लिए सही हो। Fabric या Forge के मॉड इनके plugins फ़ोल्डर में नहीं रखे जाते।
  3. अगर डाउनलोड ZIP के रूप में मिले, तो उसे अपने कंप्यूटर पर एक्सट्रैक्ट करो और सही JAR अपलोड करो।
  4. “Restricted name” आने पर डेवलपर का ठीक किया हुआ वर्शन इस्तेमाल करो। दर्ज प्लगइन नाम को ठीक करना ज़रूरी है; फ़ाइल का नाम बदलने से यह एरर ठीक नहीं होता।
  5. सर्वर रीस्टार्ट करो और कंसोल जाँचो।

जानने लायक बात: JAR बदलते समय प्लगइन का मौजूदा डेटा और कॉन्फ़िगरेशन सँभालकर रखो।

Java लाइब्रेरी plugins फ़ोल्डर में प्लगइन की तरह रखी है

मैसेज ऐसा दिखता है:

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/asm-util-<Version>.jar' failed to update!

इसके पीछे की वजह: ASM या Nashorn जैसी कोई Java लाइब्रेरी plugins फ़ोल्डर में अलग फ़ाइल के रूप में रखी है। लाइब्रेरी ऐसे घटक होते हैं जिन्हें प्लगइन अंदरूनी तौर पर इस्तेमाल करते हैं, वे खुद प्लगइन नहीं होते। Paper इस JAR को न तो प्लगइन के रूप में लोड कर सकता है और न ही अपडेट कर सकता है, इसलिए वह इसे छोड़ देता है। सर्वर चलता रहता है। ऐसी फ़ाइलें वहाँ तब पहुँच सकती हैं, जब उदाहरण के लिए कई फ़ाइलों वाला पूरा आर्काइव अपलोड कर दिया गया हो।

इसे ऐसे ठीक करो:

  1. फ़ाइलें में जाकर बताई गई लाइब्रेरी JAR को plugins से डिलीट करो।
  2. सिर्फ़ असली प्लगइन इंस्टॉल करो। उसकी लाइब्रेरी या तो उसी के साथ आती हैं या वह उन्हें स्टार्ट होते समय डाउनलोड कर लेता है।
  3. सर्वर रीस्टार्ट करो और कंसोल चेक करो।
  4. अगर इसके बाद कोई प्लगइन बताए कि उसे कुछ चाहिए, तो लाइब्रेरी हाथ से जोड़ने के बजाय उसकी इंस्टॉलेशन गाइड पढ़ो।

काम की बात: अगर किसी प्लगइन को सच में दूसरे प्लगइन की ज़रूरत होती है, तो वह उसका नाम साफ़ बताता है। इसे पहचानने का तरीका यहाँ देखो: प्लगइन को किसी दूसरे प्लगइन की ज़रूरत है।

प्लगइन फ़ाइल खाली है (“zip file is empty”)

मैसेज ऐसा दिखता है:

[DirectoryProviderSource] Error loading plugin: zip file is empty

इसके पीछे की वजह: plugins फ़ोल्डर की कोई फ़ाइल 0 बाइट की है या उसका अपलोड बीच में रुक गया था। Paper उसे खोल नहीं पाता और छोड़ देता है। प्लगइन उपलब्ध नहीं होता, लेकिन सर्वर चलता रहता है। अक्सर ऐसा तब होता है जब अपलोड के दौरान कनेक्शन टूट जाए या तुम्हारे अपने कंप्यूटर पर डाउनलोड ही अधूरा रहा हो।

इसे ऐसे ठीक करो:

  1. फ़ाइलें में plugins फ़ोल्डर खोलो और 0 बाइट वाली या असामान्य रूप से छोटी फ़ाइल ढूँढो।
  2. उसे डिलीट करो।
  3. प्लगइन को किसी भरोसेमंद सोर्स से दोबारा डाउनलोड करो और सर्वर बंद रखकर अपलोड करो। अपलोड पूरी तरह खत्म होने तक इंतज़ार करो।
  4. सर्वर रीस्टार्ट करो और कंसोल में देखो कि प्लगइन लोड हो रहा है या नहीं।

काम की बात: बड़ी या बहुत सारी फ़ाइलों के लिए SFTP अक्सर ब्राउज़र अपलोड से ज़्यादा भरोसेमंद होता है, इसके लिए पैनल में सर्वर फ़ाइलें एडिट करना और SFTP से कनेक्ट करना देखो।

PlaceholderAPI: एक्सपैंशन फ़ाइल में लोड करने लायक एक्सपैंशन क्लास नहीं है

मैसेज ऐसा दिखता है:

[PlaceholderAPI] Failed to load expansion <Datei>.jar, as it does not have a class which extends PlaceholderExpansion

इसके पीछे की वजह: PlaceholderAPI एक्सपैंशन अतिरिक्त टेक्स्ट प्लेसहोल्डर देता है। JAR फ़ाइल की जाँच होती है, लेकिन ज़रूरी एक्सपैंशन क्लास न तो मिलती है और न ही लोड हो पाती है। यह एक्सपैंशन निष्क्रिय रहता है। सर्वर चलता रहता है, लेकिन इसके प्लेसहोल्डर सही वैल्यू नहीं दिखाते।

इसे ऐसे ठीक करो:

  1. कंसोल में इस एरर से पहले के मैसेज पढ़ो। दूसरे लोडिंग एरर किसी गायब डिपेंडेंसी का नाम बता सकते हैं।
  2. फ़ाइलें में जाकर चेक करो कि बताई गई फ़ाइल सच में वही PlaceholderAPI एक्सपैंशन है जो तुम्हें चाहिए। बदलने से पहले उसका बैकअप ले लो।
  3. अपने इंस्टॉल किए गए PlaceholderAPI वर्शन से मेल खाने वाला एक्सपैंशन उसके आधिकारिक सोर्स से दोबारा डाउनलोड करो। प्रभावित फ़ाइल को बदलो और उसी एक्सपैंशन की डुप्लिकेट कॉपी हटा दो।
  4. सर्वर को पूरी तरह रीस्टार्ट करो। इसके बाद स्टार्ट मैसेज और एक्सपैंशन का कोई एक प्लेसहोल्डर चेक करो।

Velocity: Spigot या BungeeCord प्लगइन की जगह Velocity वर्शन लगाओ

मैसेज ऐसा दिखता है:

Unable to load plugin plugins/<Plugin>.jar:
The plugin file <Plugin>.jar appears to be a Paper, Bukkit or BungeeCord plugin.
Velocity does not support plugins from these platforms.

इसके पीछे की वजह: Velocity एक प्रॉक्सी है, जिसका अपना प्लगइन इंटरफ़ेस है। Paper, Bukkit या BungeeCord के लिए बनी फ़ाइल इसके साथ काम नहीं करती और अस्वीकार कर दी जाती है। उस प्लगइन की सुविधा प्रॉक्सी पर उपलब्ध नहीं रहती, जबकि सही तरह से लोड हुए दूसरे प्लगइन काम करते रह सकते हैं।

इसे ऐसे ठीक करो:

  1. कंसोल से अस्वीकार की गई फ़ाइल का नाम नोट करो।
  2. प्रॉक्सी बंद करो और फ़ाइलें में जाकर उससे जुड़े कॉन्फ़िगरेशन का बैकअप ले लो।
  3. अनुपयुक्त फ़ाइल को प्लगइन फ़ोल्डर से हटाओ और प्लगइन में जाकर आधिकारिक Velocity वर्शन इंस्टॉल करो। Geyser और Floodgate के लिए उनका Velocity वेरिएंट चुनो।
  4. प्रॉक्सी रीस्टार्ट करो और लोडिंग मैसेज चेक करो। आगे के सेटअप के लिए संबंधित Velocity वर्शन का डॉक्यूमेंटेशन देखो।

तुम्हारा मैसेज इस लिस्ट में नहीं है?

कंसोल में या logs/latest.log में पूरा मैसेज पढ़ो, उससे पहले और बाद की लाइनें भी। प्लगइन फ़ाइल का नाम तुम्हें मैसेज में ही या स्टैकट्रेस में मिलेगा, यानी इंडेंट की हुई at लाइनों की लिस्ट में: वहाँ JAR का नाम डबल स्लैश से पहले लिखा होता है, जैसे <Plugin>.jar//। plugins/<Plugin>/ जैसे फ़ोल्डर नाम से भी पता चलता है कि कौन-सा प्लगइन प्रभावित है। फ़ाइलें बदलने से पहले बैकअप बना लो। अगर फिर भी बात न बने, तो टिकट खोलो और मैसेज का समय बताओ।