Kube Utils расширяет возможности KubeJS, предлагая удобный и единообразный API для работы с различными игровыми системами.

Kube Utils

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

Принцип работы

Все функции мода собраны внутри глобального объекта Ku. Для доступа к API уровня используется Ku.Level, для работы с жидкостями — Ku.Fluids и так далее.

Возможности

• Расширения для работы с игровым миром: поиск структур по координатам, создание структур, поиск сущностей, очистка пространства, выбор случайного места с учетом ограничений;
• Работа с жидкостями: получение списка жидкостей по пространствам имён, проверка на пустоту;
• Дополнения для списков, например, выбор случайного элемента с учётом весов;
• Общие утилиты, такие как nullOrEmpty — простая проверка на пустоту или отсутствие значения для предметов, блоков, строк, жидкостей и прочего;
• Полная документация кода и понятный API;
• Производственная проверка стабильности.

Цели проекта

• Избегать несовместимых изменений, кроме случаев крайней необходимости, и делать такие изменения опциональными;
• Сохранять простоту и понятность дополнений;
• Всегда предоставлять документацию на доступном английском языке.

Документация

Документация по функциям проекта в настоящее время доступна в исходном коде. Класс BaseBinding показывает, какие объекты доступны через Ku. Например, поле Streams позволяет использовать методы через Ku.Streams.MethodName. Для некоторых объектов требуется создавать экземпляры, например, для Level — new Ku.Level(player.level).

Установка и использование

1. Убедитесь, что KubeJS установлен в вашей версии Minecraft.
2. Скопируйте мод Kube Utils в папку с модами.
3. Запустите игру и используйте глобальный объект Ku для доступа к функциям мода.

Особенности бета-версии

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