Kube Utils Mod cho Minecraft 1.20.1, 1.21.1

Kube Utils

Kube Utils là một addon đơn giản cho KubeJS, bổ sung chức năng mới cho các tính năng hiện có và tách nhánh để tạo ra các hệ thống mới cho phép viết code hiệu quả hơn, đơn giản hơn và ngắn gọn hơn.

Cách hoạt động

Kube Utils (từ đây gọi tắt là Ku) được thiết kế theo khái niệm API rõ ràng, ngắn gọn và nhất quán. Mọi thứ được thêm bởi mod này đều nằm trong đối tượng Ku toàn cục, nghĩa là nếu bạn muốn truy cập các api cấp độ, bạn sẽ truy cập qua Ku.Level, nếu bạn muốn làm gì đó với chất lỏng bạn sẽ dùng Ku.Fluids v.v.

Tính năng

Hiện tại, chúng tôi chỉ có một vài trợ giúp cho một số khu vực ít được hỗ trợ của KubeJS nhưng chúng tôi dự định mở rộng rất nhiều trong vòng đời phát triển của hệ thống. Nếu bạn có bất kỳ đề xuất nào, hãy gửi yêu cầu tính năng!

• Bổ sung cho Level như có thể lấy cấu trúc tại một vị trí khối, khả năng tạo cấu trúc, tìm thực thể và dọn sạch không gian, lấy vị trí ngẫu nhiên với một hộp giới hạn, v.v.
• Chất lỏng, cho phép bạn lấy danh sách chất lỏng dựa trên namespace của chúng, và có thể kiểm tra xem một chất lỏng có rỗng hay không.
• Bổ sung cho List như lấy các mục ngẫu nhiên dựa trên bảng trọng số
• Bổ sung các tiện ích chung như nullOrEmpty, cung cấp cho bạn cách rất đơn giản để luôn biết liệu một đối tượng có nullOrEmpty hay không, dù đó là item, block, itemstack, string, fluid hay itemEntity! (sẽ hỗ trợ thêm khi cần)
• Code được ghi tài liệu đầy đủ
• Đã được kiểm chứng trong môi trường production
• API rõ ràng và đơn giản

Mục tiêu của chúng tôi

• Chúng tôi hướng tới việc không bao giờ tạo ra thay đổi gây hỏng code trừ khi thực sự bị Minecraft, Forge hoặc Fabric buộc phải làm vậy. Khi chúng tôi cảm thấy cần tách nhánh và tạo thay đổi gây hỏng code, việc đó sẽ được thực hiện theo cách tùy chọn, không ảnh hưởng đến code hiện có.
• Không bao giờ làm cho các bổ sung trở nên quá phức tạp
• Luôn ghi tài liệu cho các bổ sung bằng tiếng Anh đơn giản

Tài liệu

Mục tiêu của chúng tôi là phát hành một website ghi tài liệu cho tất cả các bổ sung mới và cách sử dụng chúng.

Hiện tại, bạn có thể đọc về các tính năng chúng tôi thêm từ trong code. Lớp BaseBinding của chúng tôi cho bạn thấy những đối tượng nào bạn có thể dùng trong đối tượng Ku. Ví dụ BaseBindings chứa Streams như một field. Điều này nghĩa là bạn có thể dùng Ku.Steams.MethodName. Bạn có thể tìm các phương thức khả dụng từ trong file lớp của module liên quan. Nếu bạn thấy một field được bao quanh bởi ClassWrapper<?> điều này nghĩa là để dùng field đó trong KubeJS, bạn sẽ phải tạo đối tượng. Ví dụ, Level được bao bọc bởi ClassWrapper<LevelUtils> nghĩa là bạn sẽ cần dùng field như thế này new Ku.Level(player.level). Hơi phức tạp một chút nhưng khi website sẵn sàng, nó sẽ đơn giản hơn nhiều.

Tuyên bố miễn trừ

Tuyên bố miễn trừ, trong thời gian beta, hãy chờ đợi các thay đổi có thể gây hỏng code. Khi chúng tôi đạt bản phát hành ổn định, thông báo này sẽ được gỡ bỏ và từ đó trở đi, code sẽ không chứa các thay đổi gây hỏng code!

Vấn đề

Vui lòng báo cáo mọi vấn đề tới trình theo dõi vấn đề của chúng tôi kèm theo code ví dụ để chúng tôi có thể xác minh các vấn đề.