Kube Utils مود لماينكرافت 1.20.1, 1.21.1
يضيف أدوات مساعدة وميزات جديدة إلى KubeJS بتصميم واجهة برمجية نظيف وموجز ومتسق
NeoForge
ForgeKube Utils
Kube Utils هو إضافة بسيطة لـ KubeJS تضيف وظائف جديدة إلى الميزات الموجودة وتتفرع لإنشاء أنظمة جديدة تسمح بكود أكثر كفاءة وتبسيطًا وإيجازًا.
كيف يعمل
تم تصميم Kube Utils (سيُشار إليه بـ Ku من الآن فصاعدًا) بمفهوم واجهة برمجية واضحة وموجزة ومتسقة. كل ما يضيفه هذا المود محتوى داخل كائن Ku العام، مما يعني أنه إذا أردت الوصول إلى واجهات المستوى، ستصل إليها عبر Ku.Level، وإذا أردت فعل شيء ما مع السوائل ستستخدم Ku.Fluids وهكذا.
الميزات
حاليًا، لدينا فقط بعض الأدوات المساعدة لبعض المجالات الأقل دعمًا في KubeJS، لكننا نخطط لتوسيع ذلك بشكل كبير خلال دورة حياة تطوير الأنظمة. إذا كانت لديك أي اقتراحات، فيرجى تقديم طلب ميزة!
- إضافات المستوى مثل القدرة على الحصول على الهياكل عند موضع كتلة، والقدرة على إنشاء الهياكل، والعثور على الكيانات وتفريغ المساحات، والحصول على موقع عشوائي مع صندوق محيط، إلخ.
- السوائل، تتيح لك الحصول على قائمة بالسوائل بناءً على مساحة الأسماء الخاصة بها، والقدرة على التحقق مما إذا كان السائل فارغًا أم لا.
- إضافات القوائم مثل الحصول على مدخلات عشوائية بناءً على جدول مرجح
- إضافة أدوات مساعدة عامة مثل nullOrEmpty التي تمنحك طريقة بسيطة جدًا لمعرفة دائمًا ما إذا كان الكائن nullOrEmpty سواء كان عنصرًا أو كتلة أو itemstack أو سلسلة أو سائلًا أو itemEntity! (المزيد من الدعم سيأتي حسب الحاجة)
- كود موثق بالكامل
- تم التحقق منه للإنتاج
- واجهة برمجية واضحة وبسيطة
أهدافنا
- نهدف إلى عدم إجراء تغييرات كاسرة أبدًا إلا إذا اضطررنا لذلك تمامًا بسبب Minecraft أو Forge أو Fabric. في اللحظة التي نشعر فيها بأننا بحاجة إلى التفرع وإجراء تغييرات كاسرة، سيتم ذلك بطريقة اختيارية لا تؤثر على الكود الموجود.
- ألا نجعل الإضافات معقدة بشكل مفرط
- دائمًا توثيق الإضافات بلغة إنجليزية بسيطة
التوثيق
هدفنا هو إصدار موقع ويب يوثق جميع الإضافات الجديدة وكيفية استخدامها.
في الوقت الحالي، يمكنك قراءة الميزات التي نضيفها من داخل الكود. تُظهر لك فئة BaseBinding الخاصة بنا الكائنات التي يمكنك استخدامها في كائن Ku. على سبيل المثال، تحتوي BaseBindings على Streams كحقل. هذا يعني أنه يمكنك استخدام Ku.Steams.MethodName. يمكنك العثور على الطرق المتاحة من داخل ملف فئة الوحدة النمطية ذات الصلة. إذا رأيت حقلًا محاطًا بـ ClassWrapper<?> فهذا يعني أنه لاستخدام الحقل في KubeJS، سيتعين عليك إنشاء الكائن. على سبيل المثال، Level مغلف بـ ClassWrapper<LevelUtils> مما يعني أنك ستحتاج إلى استخدام الحقل بهذه الطريقة new Ku.Level(player.level). الأمر معقد قليلًا لكن بمجرد أن يصبح الموقع جاهزًا، سيكون الأمر أبسط بكثير.
إخلاء المسؤولية
إخلاء المسؤولية، أثناء وجوده في المرحلة التجريبية، توقع تغييرات محتملة كاسرة للكود. بمجرد أن نصل إلى إصدار مستقر، ستتم إزالة هذه الرسالة ومن تلك النقطة فصاعدًا، لن يحتوي الكود على تغييرات كاسرة!
المشكلات
يرجى الإبلاغ عن أي مشكلات إلى متتبع المشكلات الخاص بنا مع كود مثال حتى نتمكن من التحقق من المشكلات.
كيفية تثبيت Kube Utils
With Millida Launcher
Install Millida Launcher
The launcher is free: download it at millida.net/launcher and sign in with any nickname.
Click “Install” on this page
The launcher opens and installs the mod for Minecraft 1.18.2–1.21.1 on Forge or NeoForge automatically.
Launch the game
A profile with it appears in the launcher: click “Play”.
Manually
Install Forge or NeoForge
The loader must match the game version of the mod file, for example Minecraft 1.21.1. After installing it, a separate profile appears in your launcher.
Download the file for your version
In the version list above, pick the file kube-utils-21.1.3.jar (24 KB) for your game version and loader.
Put it in the mods folder
The folder is inside .minecraft (Windows: %appdata%\.minecraft\mods). If it does not exist, create it.
Launch the loader profile
Open “Mods” in the main menu: Kube Utils should be in the list.
Minecraft 1.21.1 runs on Java 21: with a different Java version the game may close right after launch.
الإصدارات
مع المتطلبات
| Minecraft | المشغّل | الملف | التاريخ | الإجراءات |
|---|---|---|---|---|
| 1.21.1 | NeoForge | [1.21.1] KubeUtils 21.1.324.2 KB 1 | ||
| 1.20.1 | Forge | [1.20.1] KubeUtils 20.1.123 KB | ||
| 1.18.2 | Forge | kube-utils-forge-0.1.3+mc1.18.2.jar14.3 KB |
التقييمات
كن أول من يقيّم Kube Utils
