Minecraft 1.20.1, 1.21.1 के लिए Kube Utils मॉड

Kube Utils

Kube Utils, KubeJS के लिए एक सरल addon है जो मौजूदा सुविधाओं में नई कार्यक्षमता जोड़ता है और नई प्रणालियाँ बनाने की दिशा में शाखाएँ बनाता है जो अधिक प्रदर्शनकारी, सरलीकृत और संक्षिप्त कोड की अनुमति देती हैं।

यह कैसे काम करता है

Kube Utils (अब से Ku) को एक स्पष्ट, संक्षिप्त और सुसंगत API जैसे डिज़ाइन की अवधारणा के साथ डिज़ाइन किया गया है। इस mod द्वारा जोड़ी गई हर चीज़ वैश्विक Ku ऑब्जेक्ट के भीतर रखी गई है, जिसका अर्थ है कि यदि आप level apis का उपयोग करना चाहते हैं, तो आप इसे Ku.Level के माध्यम से उपयोग करेंगे, यदि आप fluids के साथ कुछ करना चाहते हैं तो आप Ku.Fluids आदि का उपयोग करेंगे।

विशेषताएँ

वर्तमान में, हमारे पास KubeJS के कुछ कम समर्थित क्षेत्रों के लिए केवल कुछ helpers हैं, लेकिन हम सिस्टम के विकास के जीवन चक्र में इसे बहुत विस्तारित करने की योजना बनाते हैं। यदि आपके पास कोई सुझाव है, तो कृपया एक feature request बनाएँ!

• Level जोड़ जैसे कि किसी block pos पर structures प्राप्त करना, structures spawn करने की क्षमता, entities खोजना और खाली स्थान साफ़ करना, bounding box के साथ एक यादृच्छिक स्थान प्राप्त करना, आदि।
• Fluids, आपको उनके namespace(s) के आधार पर fluids की सूची प्राप्त करने की अनुमति देते हैं, और यह जाँचने की क्षमता कि कोई fluid खाली है या नहीं।
• List जोड़ जैसे कि weighted table के आधार पर यादृच्छिक entries प्राप्त करना
• सामान्य utilities का जोड़ जैसे nullOrEmpty जो आपको एक बहुत ही सरल तरीका देता है कि आप हमेशा जान सकें कि कोई ऑब्जेक्ट nullOrEmpty है या नहीं, चाहे वह item, block, itemstack, string, fluid या itemEntity हो! (आवश्यकतानुसार अधिक समर्थन आएगा)
• पूरी तरह से प्रलेखित कोड
• Production validated
• स्पष्ट और सरल API

हमारे लक्ष्य

• हमारा उद्देश्य है कि जब तक Minecraft, Forge या Fabric द्वारा बिल्कुल मजबूर न किया जाए, कभी भी breaking changes न करें। जिस बिंदु पर हमें लगे कि हमें शाखा बनाकर breaking changes करने की आवश्यकता है, यह एक वैकल्पिक तरीके से किया जाएगा जो मौजूदा कोड को प्रभावित नहीं करेगा।
• जोड़ों को कभी भी अत्यधिक जटिल न बनाना
• जोड़ों को हमेशा सरल अंग्रेज़ी में प्रलेखित करना

प्रलेखन

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

अभी, आप हमारे द्वारा जोड़ी गई विशेषताओं के बारे में कोड के भीतर से पढ़ सकते हैं। हमारी BaseBinding क्लास आपको दिखाती है कि आप Ku ऑब्जेक्ट में कौन से ऑब्जेक्ट उपयोग कर सकते हैं। उदाहरण के लिए BaseBindings में Streams एक field के रूप में है। इसका अर्थ है कि आप Ku.Steams.MethodName का उपयोग कर सकते हैं। आप संबंधित modules क्लास फ़ाइल के भीतर उपलब्ध methods पा सकते हैं। यदि आप ClassWrapper<?> से घिरा एक field देखते हैं, तो इसका अर्थ है कि KubeJS में field का उपयोग करने के लिए, आपको ऑब्जेक्ट बनाना होगा। उदाहरण के लिए, Level ClassWrapper<LevelUtils> से wrapped है, जिसका अर्थ है कि आपको field का उपयोग इस तरह करना होगा new Ku.Level(player.level)। यह थोड़ा जटिल है, लेकिन एक बार वेबसाइट तैयार हो जाने पर, यह बहुत आसान हो जाएगा।

अस्वीकरण

अस्वीकरण, beta में होने के कारण, संभावित कोड breaking changes की अपेक्षा करें। एक बार जब हम stable release पर पहुँच जाएँगे, यह संदेश हटा दिया जाएगा और उसके बाद, कोड में breaking changes नहीं होंगे!

समस्याएँ

कृपया किसी भी समस्या की रिपोर्ट हमारे issue tracker पर उदाहरण कोड के साथ करें ताकि हम समस्याओं को मान्य कर सकें।