Kube Utils Mod untuk Minecraft 1.20.1, 1.21.1

Kube Utils

Kube Utils adalah addon sederhana untuk KubeJS yang menambahkan fungsionalitas baru ke fitur yang sudah ada dan bercabang untuk membuat sistem baru yang memungkinkan kode yang lebih performan, sederhana, dan ringkas.

Cara kerjanya

Kube Utils (selanjutnya disebut Ku) dirancang dengan konsep API yang jelas, ringkas, dan konsisten. Semua yang ditambahkan oleh mod ini berada di dalam objek global Ku, artinya jika kamu ingin mengakses level api, kamu akan mengaksesnya melalui Ku.Level, jika kamu ingin melakukan sesuatu dengan fluid kamu akan menggunakan Ku.Fluids, dan seterusnya.

Fitur

Saat ini, kami hanya memiliki beberapa helper untuk area KubeJS yang kurang didukung, tetapi kami berencana memperluasnya secara besar-besaran selama siklus pengembangan sistem ini. Jika kamu memiliki saran, silakan ajukan permintaan fitur!

• Tambahan Level seperti kemampuan mendapatkan struktur pada posisi block, kemampuan memunculkan struktur, menemukan entity dan membersihkan ruang, mendapatkan lokasi acak dengan bounding box, dll.
• Fluids, memungkinkan kamu mendapatkan daftar fluid berdasarkan namespace-nya, dan dapat memeriksa apakah suatu fluid kosong atau tidak.
• Tambahan List seperti mendapatkan entri acak berdasarkan tabel berbobot
• Penambahan utilitas umum seperti nullOrEmpty yang memberimu cara sangat sederhana untuk selalu mengetahui apakah suatu objek nullOrEmpty, baik itu item, block, itemstack, string, fluid, atau itemEntity! (dukungan lebih banyak akan datang sesuai kebutuhan)
• Kode yang terdokumentasi sepenuhnya
• Tervalidasi untuk produksi
• API yang jelas dan sederhana

Tujuan kami

• Kami berusaha untuk tidak pernah membuat perubahan yang merusak kecuali benar-benar dipaksa oleh Minecraft, Forge, atau Fabric. Pada saat kami merasa perlu bercabang dan membuat perubahan yang merusak, itu akan dilakukan dengan cara opsional yang tidak akan memengaruhi kode yang sudah ada.
• Tidak pernah membuat tambahan menjadi terlalu rumit
• Selalu mendokumentasikan tambahan dalam bahasa Inggris yang sederhana

Dokumentasi

Tujuan kami adalah merilis situs web yang mendokumentasikan semua tambahan baru dan cara menggunakannya.

Saat ini, kamu dapat membaca fitur yang kami tambahkan dari dalam kode. Kelas BaseBinding kami menunjukkan objek mana yang dapat kamu gunakan di objek Ku. Misalnya BaseBindings berisi Streams sebagai field. Ini berarti kamu dapat menggunakan Ku.Steams.MethodName. Kamu dapat menemukan metode yang tersedia di dalam file kelas modul terkait. Jika kamu melihat field yang dikelilingi oleh ClassWrapper<?> ini berarti untuk menggunakan field tersebut di KubeJS, kamu harus membuat objeknya. Misalnya, Level dibungkus dengan ClassWrapper<LevelUtils> yang berarti kamu perlu menggunakan field seperti ini new Ku.Level(player.level). Ini agak rumit tetapi setelah situs webnya siap, akan jauh lebih sederhana.

Penafian

Penafian, selama masih beta, perkirakan kemungkinan perubahan kode yang merusak. Setelah kami mencapai rilis stabil, pesan ini akan dihapus dan sejak saat itu, kode tidak akan mengandung perubahan yang merusak!

Masalah

Silakan laporkan masalah apa pun ke issue tracker kami beserta contoh kode agar kami dapat memvalidasi masalah tersebut.