Minecraft 1.12.2 के लिए TESLA मॉड

टेस्ला

टेस्ला एक पावर API है जिसे क्रॉस मॉड कम्युनिकेशन के लिए डिज़ाइन किया गया है। यह विभिन्न मॉड्स के आइटम्स, ब्लॉक्स और एंटिटीज़ को टेस्ला पावर नेटवर्क के ज़रिए एक-दूसरे के साथ इंटरैक्ट करने की सुविधा देता है।

चेतावनी: अल्फा और बीटा रिलीज़ मॉड लेखकों और टेस्टर्स के लिए हैं। टेस्ला को सपोर्ट करने वाले मॉड्स को केवल पूर्ण रिलीज़ को ही टारगेट करना चाहिए! अल्फा बिल्ड का उपयोग करने से उन मॉड्स में क्रैश हो सकता है जिन्हें इसकी आवश्यकता होती है!

यह प्रोजेक्ट Nodecraft द्वारा प्रायोजित है। अपनी सेवा के पहले महीने पर 30% छूट के लिए कोड Darkhax का उपयोग करें!

शुरुआत कैसे करें

टेस्ला API का उपयोग करने का सबसे अच्छा तरीका Forge की Capability सिस्टम के माध्यम से है। विचार बहुत सरल है, capabilities एक इंटरफ़ेस के इम्प्लीमेंटेशन होते हैं जो एक निश्चित प्रकार के टेस्ला संबंधित लॉजिक को संभालते हैं। इन capabilities को फिर सपोर्टेड चीज़ों (Tile Entity, ItemStack और Entity) से अटैच किया जा सकता है। जब कोई capability अटैच होती है, तो उस चीज़ को दिए गए टेस्ला लॉजिक तक पहुंच मिल जाती है, और यह अन्य टेस्ला-सक्षम चीज़ों को दिखाई देगी। आप यहां एक बुनियादी capability इम्प्लीमेंटेशन देख सकते हैं और यहां एक tile entity उदाहरण देख सकते हैं। यहां एक आइटम उदाहरण भी है।

अक्सर पूछे जाने वाले प्रश्न

लोग टेस्ला API पर चर्चा करने कहां जा सकते हैं?

एक सार्वजनिक discord सर्वर है जिसे यहां पाया जा सकता है।

टेस्ला को अन्य पावर API से अलग क्या बनाता है?

टेस्ला API अन्य पावर API की तरह ही काम करता है, हालांकि कुछ डिज़ाइन विकल्पों ने API को बहुत अधिक लचीला बना दिया है। इनमें से एक विकल्प Forge की capability सिस्टम का उपयोग करने का निर्णय था, जो लगभग किसी भी चीज़ में टेस्ला सपोर्ट जोड़ने की अनुमति देता है। इस सिस्टम के साथ किसी मॉड के लिए बिना किसी गंदे हैक के vanilla furnace में टेस्ला सपोर्ट जोड़ना संभव होगा। एक अन्य निर्णय integers के बजाय longs का उपयोग करना था। यह बदलाव मॉड्स को बड़ी पावर संख्याओं के साथ आसानी से काम करने की अनुमति देता है।

आपने यह API क्यों बनाया?

यह API मूल रूप से एक मज़ेदार साइड प्रोजेक्ट के रूप में बनाया गया था, लेकिन अन्य डेवलपर्स से बहुत अप्रत्याशित ध्यान मिला। इसे अन्य पावर API को खत्म करने के किसी अभियान के रूप में नहीं बनाया गया था।

क्या टेस्ला के लिए कोई मानक हैं?

यह API किसी मानक को लागू नहीं करता, हालांकि कुछ चीज़ें हैं जिनका पालन करने के लिए मॉड लेखकों को प्रोत्साहित किया जाता है। एक टेस्ला 1 RF के बराबर होना चाहिए, tile entities को सीधे capability इंटरफ़ेस इम्प्लीमेंट नहीं करना चाहिए, और sided लॉजिक को capability मेथड्स के माध्यम से संभाला जाना चाहिए।

क्या टेस्ला API को अन्य मॉड्स के साथ बंडल किया जाना चाहिए?

हालांकि API को बंडल करना अक्सर किया जाता है, और Forge द्वारा सपोर्टेड है, यह एक बहुत बुरी प्रथा है। हालांकि अन्य मॉड्स को API को बंडल करने से रोकने वाला कुछ नहीं है, यह अत्यधिक हतोत्साहित किया जाता है और आधिकारिक रूप से सपोर्टेड नहीं होगा।

अगर मैं API को बंडल नहीं कर सकता तो soft dependency कैसे काम करती है?

Forge कई टूल्स प्रदान करता है जो soft dependency को वास्तव में सरल बनाते हैं। पहला है Optional annotation। यह annotation किसी भी क्लास पर जोड़ा जा सकता है जो एक इंटरफ़ेस इम्प्लीमेंट करती है, और अगर एक निश्चित मॉड ID का पता नहीं चलता, तो इंटरफ़ेस को क्लास से हटाया जा सकता है। यह मौजूदा कंटेनर ऑब्जेक्ट्स को बिना किसी hard dependency के टेस्ला के इंटरफ़ेस इम्प्लीमेंट करने की अनुमति देता है। CapabilityInject annotation भी soft dependency के लिए बेहद उपयोगी है। आप इस annotation का उपयोग किसी फ़ील्ड पर कर सकते हैं ताकि जब उक्त capability इनिशियलाइज़ हो तो इसे एक विशिष्ट capability के साथ इनिशियलाइज़ किया जाए। आप इस annotation को मेथड्स पर भी लगा सकते हैं ताकि capability इनिशियलाइज़ होने पर उन्हें कॉल किया जाए। एक चीज़ जो आप देख सकते हैं वह यह है कि annotation टेस्ला से capability क्लास का एक रेफ़रेंस लेता है, जो soft dependency के तहत गायब होगा। annotations और JVM के काम करने के तरीके के कारण, annotation में यह रेफ़रेंस बनाना सुरक्षित है। यह आपको Class Definition exception नहीं देगा।

मॉडपैक नीति

हां, आप इसे मॉड पैक में उपयोग कर सकते हैं। कृपया मुझे अपने मॉड पैक में इसका उपयोग करने की अनुमति मांगने के लिए संदेश न भेजें। मैं ऐसे संदेशों का जवाब नहीं दूंगा।