Kube Utils

Kube Utils — это вспомогательный аддон для KubeJS, который предоставляет новые системы и функции для создания более чистого и производительного кода.

Kube Utils (Ku) спроектирован с концепцией четкого, лаконичного и последовательного дизайна API. Все добавленные функции объединены в глобальный объект Ku, что позволяет обращаться к различным системам через единую структуру. Например, для доступа к API уровней используется Ku.Level, а для работы с жидкостями — Ku.Fluids.

На данный момент проект предоставляет ряд помощников для областей, которые получают меньшую поддержку в стандартном KubeJS, с планами на значительное расширение в будущем.

• Дополнения для уровней: получение структур по координатам блока, возможность спавна структур, поиск сущностей, очистка пространства, получение случайной точки в пределах ограничивающего бокса.
• Работа с жидкостями: получение списка жидкостей на основе их пространств имен (namespaces) и проверка на наличие содержимого.
• Улучшения списков: получение случайных записей на основе взвешенной таблицы.
• Общие утилиты: функция nullOrEmpty позволяет простым способом проверять объекты на пустоту или значение null (поддерживает предметы, блоки, ItemStack, строки, жидкости и сущности предметов).

• Минимизация критических изменений: разработчики стремятся избегать ломающих изменений кода, если это не продиктовано обновлениями Minecraft, Forge или Fabric.
• Опциональность обновлений: если ломающие изменения неизбежны, они будут внедряться опционально, чтобы не затрагивать существующий код.
• Простота: стремление избегать излишнего усложнения добавляемых функций.
• Документация: все дополнения сопровождаются описанием на понятном английском языке.

Проект находится в стадии бета-тестирования, поэтому возможны ломающие изменения кода. После выхода стабильной версии подобные изменения будут прекращены.

Для сообщений об ошибках рекомендуется использовать официальный трекер, прикладывая примеры кода для валидации проблемы.

Подробная документация по использованию API доступна по адресу: https://nanite.github.io/KubeUtils/

Требования проверенного файла

• По манифесту для файла kube-utils-21.1.3.jar (Minecraft 1.21.1; NeoForge) требуется kubejs. Встроенных JAR-библиотек в проверенном файле нет.