Kube Utils
Kube Utils — это аддон для KubeJS, добавляющий новую функциональность к существующим возможностям и создающий новые системы для написания более производительного, простого и лаконичного кода.
Принцип работы
Kube Utils (сокращённо Ku) разработан с концепцией чёткого, последовательного API. Все добавленные функции содержатся в глобальном объекте Ku. Например, для доступа к API уровня используйте Ku.Level, для работы с жидкостями — Ku.Fluids и т.д.
Возможности
- Дополнения для уровня: получение структур по позиции блока, генерация структур, поиск сущностей, очистка областей, получение случайных локаций в пределах bounding box
- Работа с жидкостями: фильтрация по namespace, проверка на пустоту
- Расширения для списков: выбор случайных элементов на основе взвешенной таблицы
- Утилиты общего назначения:
nullOrEmptyдля проверки объектов (предметов, блоков, строк, жидкостей) на null/пустоту - Полная документация кода
- Проверка в production-среде
- Понятный API
Цели разработки
- Избегать breaking changes без крайней необходимости
- Минимизировать сложность реализаций
- Обеспечивать документацию на понятном языке
Документация
Планируется выпуск веб-сайта с полной документацией. Временно можно изучать методы через исходный код: например, класс BaseBinding содержит доступные объекты (например Streams), а классы-обёртки (например ClassWrapper<LevelUtils>) требуют создания экземпляров через new Ku.Level(player.level).
Дисклеймер
В течение бета-тестирования возможны изменения, нарушающие обратную совместимость. После стабильного релиза breaking changes не планируются.
Сообщение об ошибках
Пожалуйста, отправляйте отчёты в трекер проблем с примером кода для воспроизведения.
