Minecraft 1.20.1, 1.21.1-এর জন্য Kube Utils মড

Kube Utils

Kube Utils হলো KubeJS-এর একটি সহজ অ্যাডঅন যা বিদ্যমান ফিচারগুলোতে নতুন কার্যকারিতা যোগ করে এবং নতুন সিস্টেম তৈরি করে যা আরও পারফরম্যান্ট, সরল এবং সংক্ষিপ্ত কোড লেখার সুযোগ দেয়।

এটি কীভাবে কাজ করে

Kube Utils (এখন থেকে Ku) একটি স্পষ্ট, সংক্ষিপ্ত এবং সামঞ্জস্যপূর্ণ API-এর মতো ডিজাইনের ধারণা নিয়ে তৈরি করা হয়েছে। এই মড দ্বারা যোগ করা সবকিছু গ্লোবাল Ku অবজেক্টের মধ্যে থাকে, অর্থাৎ আপনি যদি লেভেল API অ্যাক্সেস করতে চান, তাহলে Ku.Level-এর মাধ্যমে অ্যাক্সেস করবেন, যদি ফ্লুইড নিয়ে কিছু করতে চান তাহলে Ku.Fluids ইত্যাদি ব্যবহার করবেন।

ফিচারসমূহ

বর্তমানে, KubeJS-এর তুলনামূলক কম সমর্থিত কিছু ক্ষেত্রের জন্য আমাদের কাছে মাত্র কয়েকটি হেল্পার আছে, তবে সিস্টেম ডেভেলপমেন্টের জীবনচক্রে আমরা এটিকে অনেক বড় পরিসরে সম্প্রসারণ করার পরিকল্পনা করছি। আপনার কোনো পরামর্শ থাকলে, অনুগ্রহ করে একটি ফিচার রিকোয়েস্ট করুন!

• লেভেল সংযোজন যেমন একটি ব্লক পজে স্ট্রাকচার পাওয়া, স্ট্রাকচার স্পন করার ক্ষমতা, এনটিটি খোঁজা এবং জায়গা পরিষ্কার করা, একটি বাউন্ডিং বক্সসহ র্যান্ডম লোকেশন পাওয়া ইত্যাদি।
• ফ্লুইড, যা আপনাকে তাদের নেমস্পেসের ভিত্তিতে ফ্লুইডের একটি তালিকা পেতে দেয়, এবং একটি ফ্লুইড খালি কি না তা যাচাই করার সুযোগ দেয়।
• লিস্ট সংযোজন যেমন একটি ওয়েটেড টেবিলের ভিত্তিতে র্যান্ডম এন্ট্রি পাওয়া
• সাধারণ ইউটিলিটির সংযোজন যেমন nullOrEmpty যা আপনাকে খুব সহজভাবে সবসময় জানতে দেয় কোনো অবজেক্ট nullOrEmpty কি না, তা সেটি আইটেম, ব্লক, itemstack, স্ট্রিং, ফ্লুইড বা itemEntity যাই হোক! (প্রয়োজন অনুযায়ী আরও সমর্থন আসবে)
• সম্পূর্ণভাবে ডকুমেন্টেড কোড
• প্রোডাকশনে যাচাইকৃত
• স্পষ্ট এবং সরল API

আমাদের লক্ষ্য

• Minecraft, Forge বা Fabric দ্বারা একেবারে বাধ্য না হলে আমরা কখনো ব্রেকিং চেঞ্জ করব না। যখন আমরা মনে করব যে আমাদের শাখা বিভক্ত করে ব্রেকিং চেঞ্জ করা প্রয়োজন, তখন তা একটি ঐচ্ছিক উপায়ে করা হবে যা বিদ্যমান কোডকে প্রভাবিত করবে না।
• সংযোজনগুলোকে কখনো অতিরিক্ত জটিল করা নয়
• সংযোজনগুলো সর্বদা সহজ ইংরেজিতে ডকুমেন্ট করা

ডকুমেন্টেশন

আমাদের লক্ষ্য হলো একটি ওয়েবসাইট প্রকাশ করা যা সমস্ত নতুন সংযোজন এবং সেগুলো কীভাবে ব্যবহার করতে হয় তা ডকুমেন্ট করে।

এই মুহূর্তে, আপনি কোডের ভেতর থেকেই আমরা যে ফিচারগুলো যোগ করি সেগুলো সম্পর্কে পড়তে পারেন। আমাদের BaseBinding ক্লাস দেখায় যে Ku অবজেক্টে আপনি কোন অবজেক্টগুলো ব্যবহার করতে পারেন। উদাহরণস্বরূপ BaseBindings-এ Streams একটি ফিল্ড হিসেবে আছে। এর মানে আপনি Ku.Steams.MethodName ব্যবহার করতে পারেন। সম্পর্কিত মডিউল ক্লাস ফাইলের ভেতরে উপলব্ধ মেথডগুলো খুঁজে পাবেন। যদি আপনি ClassWrapper<?> দ্বারা ঘেরা কোনো ফিল্ড দেখেন, এর মানে KubeJS-এ ফিল্ডটি ব্যবহার করতে হলে আপনাকে অবজেক্টটি তৈরি করতে হবে। উদাহরণস্বরূপ, Level হলো ClassWrapper<LevelUtils> দ্বারা মোড়ানো, অর্থাৎ আপনাকে ফিল্ডটি এভাবে ব্যবহার করতে হবে new Ku.Level(player.level)। এটি একটু জটিল, কিন্তু ওয়েবসাইট প্রস্তুত হয়ে গেলে এটি অনেক সহজ হয়ে যাবে।

দাবিত্যাগ

দাবিত্যাগ, বিটা অবস্থায় থাকাকালীন সম্ভাব্য কোড ব্রেকিং চেঞ্জের জন্য প্রস্তুত থাকুন। একবার আমরা স্থিতিশীল রিলিজে পৌঁছে গেলে, এই বার্তাটি সরিয়ে ফেলা হবে এবং সেই সময় থেকে কোডে আর ব্রেকিং চেঞ্জ থাকবে না!

সমস্যা

অনুগ্রহ করে যেকোনো সমস্যা আমাদের ইস্যু ট্র্যাকারে রিপোর্ট করুন এবং সমস্যাগুলো যাচাই করার জন্য উদাহরণ কোডও দিন।