Cave Engine में आपका स्वागत है!

Cave एक सरल, तेज़, 3D डेस्कटॉप गेम इंजन है जिसे टूल से जूझे बिना गेम बनाने के लिए बनाया गया है। एडिटर आपको एक कॉमर्शियल गेम इंजन के सामान्य बिल्डिंग ब्लॉक्स देता है, जैसे कि सीन, एंटिटीज, कॉम्पोनेंट्स, एसेट्स, फिजिक्स, एनिमेशन, UI, ऑडियो, टाइमलाइन, Python स्क्रिप्टिंग, और अधिक, लेकिन वर्कफ़्लो सीधा रहने के लिए डिज़ाइन किया गया है। आपको प्रयोग शुरू करने के लिए गेम कोड कंपाइल करने या शेडर कंपाइलेशन का इंतजार करने की जरूरत नहीं है।

इस Getting Started क्वेस्ट में, आप Cave को पहली बार खोलने से लेकर एक बेसिक गेम प्रोजेक्ट बनाने, परीक्षण करने, और एक्सपोर्ट करने तक जाएंगे। यह पहला लेसन केवल एडिटर को सही तरीके से इंस्टॉल करना और सुरक्षित रूप से लॉन्च करने के बारे में है।

आपको क्या चाहिए

शुरू करने से पहले, सुनिश्चित करें कि आपके पास:

• एक वैध Cave Engine लाइसेंस।
• अपडेटेड ग्राफिक्स ड्राइवर्स वाला कंप्यूटर: Cave को काम करने के लिए OpenGL 4.3 या उससे ऊपर के ड्राइवर चाहिए। यह ग्राफिक्स API 2012 में जारी हुई थी, इसलिए आपके कंप्यूटर में यह पहले से समर्थित हो सकती है।
• एक सामान्य लोकल फोल्डर जहाँ आप इंजन को एक्सट्रैक्ट कर सकें: Windows पर, C:\Cave Engine\ जैसा साधारण स्थान अच्छा विकल्प है। फोल्डर का नाम आपकी पसंद का हो सकता है, लेकिन यह छोटा, आसानी से खोजने वाला और किसी सिंक्ड क्लाउड फोल्डर के अंदर नहीं होना चाहिए।

Cave Engine इंस्टॉल करना

Cave Engine एक संकुचित फोल्डर (ZIP) के रूप में वितरित किया जाता है। हमारे सर्वर द्वारा आपके लिए एक यूनिक बिल्ड तैयार किया गया है यहाँ। यह केवल आपके लिए अनन्य है और इसे साझा या पुनर्वितरित करना हमारे एंड यूज़र लाइसेंस एग्रीमेंट के खिलाफ है, इसलिए यह प्रतिबंधित है।

इसे इंस्टॉल करने के लिए, पूरे इंजन पैकेज को एक समर्पित फोल्डर में एक्सट्रैक्ट करें।

महत्वपूर्ण:

• .zip फ़ाइल से सीधे Cave को न चलाएं।
• ऐसे फोल्डर में एक्सट्रैक्ट न करें जिसमें पहले से गैर-संबंधित फ़ाइलें हों।
• इंजन की फ़ाइलों को अलग-अलग जगहों पर न बांटें।

एक्सट्रैक्ट करने के बाद, इंजन फोल्डर में एडिटर executable, गेम/प्लेयर executable, और महत्वपूर्ण सपोर्ट फोल्डर जैसे कि Editor और Lib होने चाहिए। फ़ाइल नाम ऑपरेटिंग सिस्टम और इंजन बिल्ड के अनुसार थोड़े भिन्न हो सकते हैं, लेकिन नियम सरल है: एक्सट्रैक्टेड फोल्डर को साथ में रखें।

> Cave को अपनी फ़ाइलों को एक ही फोल्डर संरचना में होने की जरूरत है। यदि आप इंजन फोल्डर से रैंडम फाइलें हिलाते, नाम बदलते या हटाते हैं, तो एडिटर खुलने में असमर्थ हो सकता है।

इंस्टॉलेशन पाथ की समस्या निवारण

Cave शुरू होने पर कई आम इंस्टॉलेशन पाथ समस्याओं की जांच करता है। ये समस्याएं क्रैश, गायब फ़ाइलें, या विचित्र व्यवहार का कारण बन सकती हैं, खासकर Windows पर। निम्नलिखित नियमों का पालन करें:

• Cave को OneDrive, Dropbox, Google Drive, और इसी तरह के सिंक्ड फोल्डरों से बाहर रखें।
• इसे Desktop पर Extract करने से बचें, खासकर यदि आपका Desktop OneDrive से सिंक्ड है।
• फोल्डर पाथ में गैर-ASCII अक्षरों जैसे टाइल्डे, एक्सेंटेड अक्षर या अन्य विशेष भाषा वर्णों से बचें।
• पाथ को उचित रूप से छोटा रखें।
• ऐसे फोल्डर से बचें जो ऑफ़लाइन, वर्चुअल, या क्लाउड-ओनली के रूप में चिह्नित हों।

अच्छा उदाहरण:

C:\Cave Engine\

जोखिम भरे उदाहरण:

C:\Users\YourName\OneDrive\Desktop\Cave Engine\
C:\Users\YourName\Desktop With Accents\Cave Engine\
C:\Very\Long\Folder\Path\With\Many\Many\Nested\Folders\Cave Engine\

यदि Cave "Invalid Install Path" चेतावनी दिखाता है, तो पूरे एक्सट्रैक्ट किये गए इंजन फोल्डर को एक साफ लोकल पाथ पर ले जाएँ और फिर से खोलें।

एडिटर लॉन्च करना

Cave शुरू करने के लिए, इंजन फोल्डर के अंदर Cave Editor executable खोलें। Windows पर यह आमतौर पर .exe फ़ाइल जैसा दिखेगा। आप इसके लिए डेस्कटॉप शॉर्टकट बना सकते हैं या इसे टास्कबार पर पिन कर सकते हैं, लेकिन शॉर्टकट को executable की ओर बनाएं, न कि executable को इंजन फोल्डर से बाहर ले जाएं।

जब Cave सही तरीके से खुल जाए, तो आपको Project Manager विंडो दिखाई देगी। यह एडिटर की पहली स्क्रीन है। वहां से, आप नया प्रोजेक्ट बना सकते हैं, हाल ही के प्रोजेक्ट खोल सकते हैं, या किसी मौजूदा प्रोजेक्ट को ब्राउज़ कर सकते हैं:

बेसिक इंजन फाइलों को समझना

इंजन स्पेसिफिक में जाने से पहले, आइए इंजन फोल्डर के फाइलों को थोड़ा बेहतर समझते हैं। इंजन फोल्डर में कई प्रकार की फाइलें होती हैं क्योंकि Cave को उन टूल्स और रUNTIME में बांटा गया है जिनकी जरूरत गेम बनाने और एक्सपोर्ट किए गए गेम को चलाने के लिए होती है।

• एडिटर executable वह ऐप्लिकेशन है जिसका इस्तेमाल आप प्रोजेक्ट बनाने और संपादित करने के लिए करते हैं।
• गेम/प्लेयर executable एक्सपोर्ट किए गए प्रोजेक्ट्स द्वारा उपयोग किया जाता है। यह अंतिम गेम को खिलाड़ियों के लिए चलाता है।
• Editor फोल्डर में एडिटर के लिए आवश्यक डेटा जैसे आइकॉन्स, डिफ़ॉल्ट एसेट्स, फोंट, इंटरफ़ेस फ़ाइलें, और अन्य संसाधन होते हैं।
• Lib फोल्डर में आवश्यक रनटाइम लाइब्रेरीज़ होती हैं, जिनमें Python से जुड़ी फाइलें शामिल हैं जो Cave की स्क्रिप्टिंग प्रणाली उपयोग करती है।

फिलहाल, आपको फोल्डर की हर फाइल को समझने की जरूरत नहीं है। बस यह नियम याद रखें:

> एक्सट्रैक्ट किए गए Cave फोल्डर के अंदर से एडिटर खोलें, और फोल्डर की सभी सामग्री को एक साथ रखें।

समस्या निवारण: सामान्य प्रथम लॉन्च समस्याएँ

यदि Project Manager दिखाई नहीं देता, या एडिटर खुलते ही बंद हो जाता है, तो पहले इन बातों की जांच करें:

1. इंजन पूरी तरह से एक्सट्रैक्ट नहीं हुआ

यदि Cave को किसी आवश्यक फ़ाइल जैसे Editor/imgui.ini नहीं मिलती, तो संभव है कि इंजन सही तरीके से एक्सट्रैक्ट न हो या executable बाकी फाइलों से अलग कर दिया गया हो।

इसे ठीक करने के लिए पूरा पैकेज फिर से एक साफ फोल्डर में एक्सट्रैक्ट करें। फिर उसी फोल्डर से एडिटर लॉन्च करें।

2. इंजन समस्या वाली फोल्डर में है

यदि एडिटर इंस्टाल पाथ के बारे में चेतावनी देता है, तो Cave को एक सरल लोकल फोल्डर में ले जाएँ। क्लाउड फोल्डर, सिंक्ड Desktop फोल्डर, गैर-ASCII अक्षरों वाले फोल्डर, और बहुत लंबे रास्तों से बचें।

3. एंटीवायरस ने फाइलें हटा दीं या ब्लॉक कर दीं

कुछ एंटीवायरस टूल्स ताजा डाउनलोड किए गए सॉफ़्टवेयर से फाइलों को क्वारंटीन कर सकते हैं। यदि एक्सट्रैक्शन के बाद फाइलें गायब हैं, तो उन्हें एंटीवायरस क्वारंटीन से पुनः प्राप्त करें या Cave को फिर से डाउनलोड और एक्सट्रैक्ट करें।

संदेह होने पर, एक साफ फोल्डर में Cave को एक्सट्रैक्ट करें और पूरी पैकेज की फाइलें सही से मौजूद हैं यह जांच लें।

4. ग्राफिक्स ड्राइवर्स पुराने हैं

Cave एक डेस्कटॉप 3D रेंडरर का उपयोग करता है, इसलिए आपका ग्राफिक्स ड्राइवर महत्वपूर्ण है। यदि एडिटर स्टार्टअप के दौरान क्रैश होता है, खाली विंडो खोलता है, या रेंडरिंग त्रुटियां दिखाता है, तो अपने GPU निर्माता की वेबसाइट से GPU ड्राइवर अपडेट करें।

यह खासकर लैपटॉप, पुराने कंप्यूटर्स, या नए Windows इंस्टॉलेशन के लिए महत्वपूर्ण है।

5. आप गलत फाइल चला रहे हैं

प्रोजेक्ट बनाने के लिए एडिटर executable का उपयोग करें। गेम/प्लेयर executable एक्सपोर्ट किए गए गेम चलाने के लिए है, सोर्स प्रोजेक्ट संपादन के लिए नहीं। यदि आप गेम बनाना चाहते हैं, तो Cave Editor खोलें।

अब आगे क्या होगा

एक बार Project Manager खुलने के बाद, Cave आपके पहले प्रोजेक्ट के लिए तैयार है।

अगले लेसन में, आप नया प्रोजेक्ट बनाएंगे, एक स्टार्टर टेम्पलेट चुनेंगे, एडिटर ज़ूम समायोजित करेंगे यदि आवश्यक हो, और समझेंगे कि Cave आपके लिए क्या उत्पन्न करता है।