Minecraft 1.20.1, 1.21.1 کے لیے Kube Utils موڈ

Kube Utils

Kube Utils، KubeJS کے لیے ایک سادہ ایڈآن ہے جو موجودہ خصوصیات میں نئی فعالیت شامل کرتا ہے اور نئے سسٹمز بنانے کی طرف بڑھتا ہے تاکہ زیادہ کارکردگی، آسان اور مختصر کوڈ ممکن ہو سکے۔

یہ کیسے کام کرتا ہے

Kube Utils (آگے سے Ku) کو ایک واضح، مختصر اور مستقل API نما ڈیزائن کے تصور کے ساتھ ڈیزائن کیا گیا ہے۔ اس موڈ کی طرف سے شامل کردہ ہر چیز عالمی Ku آبجیکٹ کے اندر رکھی گئی ہے، یعنی اگر آپ لیول APIs تک رسائی چاہتے ہیں تو آپ اسے Ku.Level کے ذریعے حاصل کریں گے، اگر آپ فلوئڈز کے ساتھ کچھ کرنا چاہتے ہیں تو آپ Ku.Fluids وغیرہ استعمال کریں گے۔

خصوصیات

فی الحال، ہمارے پاس KubeJS کے کم معاون علاقوں میں سے کچھ کے لیے صرف چند مددگار ہیں لیکن ہم سسٹمز کی ترقی کے دوران اسے بہت زیادہ بڑھانے کا ارادہ رکھتے ہیں۔ اگر آپ کے پاس کوئی تجاویز ہیں تو براہ کرم فیچر ریکویسٹ بنائیں!

• لیول کے اضافے جیسے کسی بلاک پوزیشن پر اسٹرکچرز حاصل کرنا، اسٹرکچرز اسپان کرنے کی صلاحیت، اینٹٹیز تلاش کرنا اور خالی جگہیں صاف کرنا، باؤنڈنگ باکس کے ساتھ بے ترتیب مقام حاصل کرنا، وغیرہ۔
• فلوئڈز، آپ کو ان کے namespace(s) کی بنیاد پر فلوئڈز کی فہرست حاصل کرنے کی اجازت دیتے ہیں، اور یہ چیک کرنے کی صلاحیت کہ کوئی فلوئڈ خالی ہے یا نہیں۔
• لسٹ کے اضافے جیسے ویٹڈ ٹیبل کی بنیاد پر بے ترتیب اندراجات حاصل کرنا
• عمومی یوٹیلیٹیز کا اضافہ جیسے nullOrEmpty جو آپ کو ایک بہت آسان طریقہ دیتا ہے کہ ہمیشہ جان سکیں کہ کوئی آبجیکٹ nullOrEmpty ہے یا نہیں، چاہے وہ آئٹم، بلاک، itemstack، string، fluid یا itemEntity ہو! (ضرورت کے مطابق مزید سپورٹ آئے گی)
• مکمل طور پر دستاویزی کوڈ
• پروڈکشن سے تصدیق شدہ
• واضح اور سادہ API

ہمارے اہداف

• ہمارا مقصد کبھی بریکنگ چینجز نہ کرنا ہے جب تک کہ Minecraft، Forge یا Fabric کی طرف سے بالکل مجبور نہ ہوں۔ جس مقام پر ہمیں لگے کہ ہمیں الگ ہو کر بریکنگ چینجز کرنے کی ضرورت ہے، یہ ایک اختیاری طریقے سے کیا جائے گا جو موجودہ کوڈ کو متاثر نہیں کرے گا۔
• اضافوں کو کبھی حد سے زیادہ پیچیدہ نہ بنانا
• اضافوں کو ہمیشہ سادہ انگریزی میں دستاویز کرنا

دستاویزات

ہمارا مقصد ایک ویب سائٹ جاری کرنا ہے جو تمام نئے اضافوں اور ان کے استعمال کے طریقے کو دستاویز کرے۔

اس وقت، آپ کوڈ کے اندر سے ہماری شامل کردہ خصوصیات کے بارے میں پڑھ سکتے ہیں۔ ہماری BaseBinding کلاس آپ کو دکھاتی ہے کہ آپ Ku آبجیکٹ میں کون سی آبجیکٹس استعمال کر سکتے ہیں۔ مثال کے طور پر BaseBindings میں Streams ایک فیلڈ کے طور پر موجود ہے۔ اس کا مطلب ہے کہ آپ Ku.Steams.MethodName استعمال کر سکتے ہیں۔ آپ دستیاب میتھڈز متعلقہ ماڈیولز کی کلاس فائل کے اندر سے تلاش کر سکتے ہیں۔ اگر آپ کوئی فیلڈ ClassWrapper<?> سے گھری ہوئی دیکھیں تو اس کا مطلب ہے کہ KubeJS میں اس فیلڈ کو استعمال کرنے کے لیے آپ کو آبجیکٹ بنانا ہوگا۔ مثال کے طور پر، Level ClassWrapper<LevelUtils> سے لپیٹا ہوا ہے یعنی آپ کو فیلڈ اس طرح استعمال کرنا ہوگا new Ku.Level(player.level)۔ یہ تھوڑا پیچیدہ ہے لیکن جب ویب سائٹ تیار ہو جائے گی تو یہ بہت آسان ہو جائے گا۔

ڈس کلیمر

ڈس کلیمر، بیٹا میں ہونے کے دوران، ممکنہ کوڈ بریکنگ چینجز کی توقع رکھیں۔ جب ہم اسٹیبل ریلیز تک پہنچ جائیں گے تو یہ پیغام ہٹا دیا جائے گا اور اس کے بعد، کوڈ میں بریکنگ چینجز نہیں ہوں گے!

مسائل

براہ کرم کسی بھی مسئلے کی اطلاع ہمارے ایشو ٹریکر کو دیں اور ساتھ مثال کوڈ بھی شامل کریں تاکہ ہم مسائل کی تصدیق کر سکیں۔