जब कुछ टूट जाए

हर ऐड-ऑन बनाने वाले से कभी न कभी पैक टूटता है। अच्छी बात यह है कि Minecraft बताता है कि क्या गड़बड़ हुई, बस आपको पता होना चाहिए कि कहाँ देखना है। यह पेज बताता है कि errors कैसे ढूँढें और सबसे आम errors कैसे ठीक करें।

Step 1: content log चालू करें

Content log उन समस्याओं की list है जो Minecraft को आपके पैक लोड करते समय मिलीं। इसे एक बार चालू करें और बनाते समय चालू ही रखें।

1. Minecraft खोलें और Settings पर जाएँ।
2. Creator सेक्शन खोलें।
3. Enable Content Log GUI चालू करें।
4. अगर आप errors को एक फ़ाइल में भी सेव करना चाहते हैं तो Enable Content Log File चालू करें।

अब जब आप किसी टूटे पैक वाला world लोड करेंगे, तो errors स्क्रीन पर दिखेंगे। पूरी list आप कभी भी pause menu से, या keyboard पर Ctrl + H से खोल सकते हैं।

Error कैसे पढ़ें

Content log की एक लाइन आमतौर पर ऐसी दिखती है:

[Item][error]-demo:ruby | items/ruby.json | minecraft:item | components | minecraft:max_stack_size | ...

इसे बाएँ से दाएँ पढ़ें:

• [Item]: किस सिस्टम ने शिकायत की (Item, Blocks, Entity, Json, Texture...)।
• [error] या [warning]: errors आमतौर पर कुछ तोड़ते हैं, warnings शायद नहीं।
• Path: फ़ाइल, और फिर उसके अंदर की सटीक जगह। इससे पता चलता है कि कहाँ देखना है।

पैक दिखता ही नहीं

अगर आपका पैक world settings की list में नहीं है, तो Minecraft उसका manifest नहीं पढ़ पाया।

• manifest.json में टूटा JSON। छूटे commas, फ़ालतू commas और गलत quotes जाँचें। देखें 5 मिनट में JSON।
• Manifest गलत जगह पर। यह सीधे पैक फ़ोल्डर में होना चाहिए, जैसे development_behavior_packs/MyPack/manifest.json। एक फ़ोल्डर भी ज़्यादा गहराई में हो, तो पैक दिखता नहीं।
• गलत module type। बिहेवियर पैक "type": "data" इस्तेमाल करता है, रिसोर्स पैक "type": "resources"। रिसोर्स पैक फ़ोल्डर में रखा BP (या उल्टा) नहीं दिखेगा।
• Import fail हुआ। अगर कोई .mcpack "Import failed" दिखाता है, तो शायद manifest ZIP में किसी subfolder के अंदर है। पैक फ़ोल्डर को नहीं, उसके अंदर की चीज़ों को zip करें। देखें एक्सपोर्ट करें और खेलें।

Duplicate UUIDs

हर पैक header और हर module का अपना UUID होना चाहिए। समस्याएँ तब होती हैं जब:

• आपने किसी tutorial या दूसरे पैक से manifest कॉपी किया और उसके UUIDs वैसे ही रखे
• आपने RP बनाने के लिए अपना BP manifest कॉपी किया और उन्हें बदलना भूल गए
• उसी पैक की कोई पुरानी कॉपी अब भी इंस्टॉल है

लक्षण: पैक इम्पोर्ट होने से मना करता है, गलत पैक लोड होता है, या आपके बदलाव कभी नहीं दिखते। हल: चार नए UUIDs बनाएँ और जाँचें कि BP की dependencies entry RP के नए header UUID की ओर इशारा करती है। फिर behavior_packs और resource_packs से पैक की पुरानी कॉपियाँ डिलीट करें।

बदलाव नहीं दिखते

आपने फ़ाइल एडिट की लेकिन गेम में कुछ नहीं बदला।

1. क्या फ़ाइल सेव हुई? अपने editor में Auto Save चालू करें।
2. क्या आप सही कॉपी एडिट कर रहे हैं? अगर आपने पैक को .mcpack के रूप में इम्पोर्ट किया है, तो गेम behavior_packs वाली इम्पोर्ट की गई कॉपी इस्तेमाल करता है, आपका project फ़ोल्डर नहीं। इसकी जगह development फ़ोल्डरों में काम करें।
3. क्या आपने version बढ़ाया? जब आप अपडेट की गई .mcpack इम्पोर्ट करते हैं, तो manifest header में version बढ़ाएँ, नहीं तो Minecraft पुराना ही रख सकता है।
4. क्या आपने reload किया? World से निकलें और उसे फिर से खोलें। ज़िद्दी मामलों में Minecraft पूरी तरह बंद करें।

पैक चालू है, पर कुछ काम नहीं करता

• सिर्फ़ एक पैक चालू है। World settings खोलें और पक्का करें कि बिहेवियर पैक और रिसोर्स पैक दोनों Active के नीचे हैं। BP से RP पर dependency जोड़ने से यह अपने आप हो जाता है।
• Experiment की ज़रूरत है। अगर आपने कोई experimental feature इस्तेमाल किया है, तो world की Experiments settings में उसका toggle चालू होना चाहिए।
• गलत format_version। अगर किसी फ़ाइल में "format_version": "1.10" लिखा है लेकिन नए कंपोनेंट इस्तेमाल हुए हैं, तो गेम उसे पुराने नियमों से पढ़ता है और जो नहीं जानता उसे अनदेखा या reject कर देता है। मौजूदा version इस्तेमाल करें, जैसे आइटम के लिए "1.26.30", और इस wiki के उदाहरणों से मिलाएँ।

आइटम creative menu में नहीं है

आपका आइटम मौजूद है, लेकिन आप उसे creative inventory में नहीं ढूँढ पा रहे।

कोई menu category नहीं

menu_category के बिना category default रूप से none होती है, जो आइटम को creative menu से छिपा देती है। इसे आइटम के description में जोड़ें:

"description": {
  "identifier": "demo:ruby",
  "menu_category": {
    "category": "items"
  }
}

जिन categories में आप आइटम दिखा सकते हैं, वे हैं construction, equipment, items और nature।

दूसरे कारण

• फ़ाइल लोड नहीं हुई। Content log में अपने आइटम के नाम वाले errors देखें।
• कमांड आज़माएँ। /give @s demo:ruby टाइप करें। अगर यह कहे कि आइटम मौजूद नहीं है, तो बिहेवियर पैक फ़ाइल लोड नहीं कर रहा। अगर आपको आइटम मिल जाए, तो सिर्फ़ menu वाली setting गलत है।

यह जाँचने के लिए कि हर कंपोनेंट का नाम सही लिखा है, आइटम कंपोनेंट reference भी देखें।

गायब या टूटे textures

काले और बैंगनी चौकोर

बैंगनी और काले चेकर वाला texture मतलब Minecraft को वह इमेज नहीं मिली जो इस्तेमाल करने को कहा गया था।

• गलत path। Texture paths .png के बिना लिखे जाते हैं और पैक के root से शुरू होते हैं, जैसे textures/items/ruby। हर अक्षर जाँचें।
• गलत case। कुछ प्लेटफ़ॉर्म, जैसे Android, Ruby.png और ruby.png को अलग फ़ाइलें मानते हैं। हर जगह lowercase इस्तेमाल करें।
• गलत format। असली PNG के रूप में सेव करें। .png नाम दी गई JPG लोड नहीं होगी।
• RP चालू नहीं है। अगर रिसोर्स पैक बंद है, तो हर कस्टम texture गायब होता है।

बिना icon वाले आइटम

अगर आपका आइटम अदृश्य दिखता है या उसका icon गायब है:

1. जाँचें कि BP में minecraft:icon एक छोटा नाम इस्तेमाल करता है, जैसे "ruby"।
2. जाँचें कि वही छोटा नाम RP/textures/item_texture.json में registered है।
3. जाँचें कि उस फ़ाइल का path आपके PNG की ओर इशारा करता है।

{
  "resource_pack_name": "my_first_addon",
  "texture_name": "atlas.items",
  "texture_data": {
    "ruby": {
      "textures": "textures/items/ruby"
    }
  }
}

अजीब आइटम नाम

अगर आइटम का नाम "Ruby" की जगह item.demo:ruby.name जैसा कुछ दिखता है, तो language फ़ाइल में वह लाइन नहीं है। इसे RP/texts/en_US.lang में जोड़ें:

item.demo:ruby.name=Ruby

एक छोटी checklist

जब कुछ टूटे और आपको पता न हो कि क्यों, तो इस list को क्रम से देखें:

1. Content log चालू है? पहला error पढ़ें।
2. सारा JSON valid है?
3. Manifests सही जगह पर हैं, अनोखे UUIDs के साथ?
4. World में दोनों पैक चालू हैं?
5. Identifiers हर जगह एक जैसे लिखे हैं, सब lowercase में?
6. Texture paths सही हैं, .png के बिना?
7. World reload किया, या Minecraft restart किया?

Errors से शुरू से ही बचना

इनमें से ज़्यादातर समस्याएँ हाथ से टाइप करने से आती हैं: यहाँ एक comma, वहाँ बेमेल UUID, एक गलत अक्षर वाला texture path। GodCraft ये सारी फ़ाइलें आपके लिए लिखता है, इसलिए manifests, UUIDs, texture paths और language lines हमेशा मेल खाते हैं। अगर आप बार-बार अटकते हैं, तो वही चीज़ GodCraft Workshop में बनाकर देखें और तुलना करें।