Kube Utils Мод для Minecraft 1.20.1, 1.21.1

Kube Utils

Kube Utils — це простий аддон до KubeJS, який додає нову функціональність до наявних можливостей і відгалужується для створення нових систем, що дозволяють писати більш продуктивний, спрощений і лаконічний код.

Як це працює

Kube Utils (далі Ku) розроблено з концепцією чіткого, лаконічного та послідовного API-подібного дизайну. Усе, що додає цей мод, міститься в глобальному об'єкті Ku, тобто якщо ви хочете отримати доступ до level apis, ви звертаєтеся до нього через Ku.Level, якщо ви хочете щось зробити з рідинами, ви використовуєте Ku.Fluids тощо.

Можливості

Наразі ми маємо лише кілька помічників для деяких менш підтримуваних областей KubeJS, але ми плануємо значно розширити це протягом життєвого циклу розробки систем. Якщо у вас є якісь пропозиції, будь ласка, створіть запит на функцію!

• Доповнення для Level, як-от можливість отримувати структури за позицією блоку, здатність спавнити структури, знаходити сутності та очищати простори, отримувати випадкову локацію з обмежувальною рамкою тощо.
• Рідини, які дозволяють отримати список рідин на основі їхнього простору імен, а також перевірити, чи рідина порожня.
• Доповнення для списків, як-от отримання випадкових записів на основі зваженої таблиці
• Додавання загальних утиліт, як-от nullOrEmpty, що дає вам дуже простий спосіб завжди знати, чи об'єкт є nullOrEmpty, чи це предмет, блок, itemstack, рядок, рідина чи itemEntity! (більше підтримки буде додано за потреби)
• Повністю задокументований код
• Перевірено у продакшені
• Чіткий і простий API

Наші цілі

• Ми прагнемо ніколи не робити змін, що ламають сумісність, якщо тільки Minecraft, Forge або Fabric не змусять нас до цього. Коли ми відчуємо потребу відгалузитися й зробити зміни, що ламають сумісність, це буде зроблено в необов'язковий спосіб, який не вплине на наявний код.
• Ніколи не робити доповнення надмірно складними
• Завжди документувати доповнення простою мовою

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

Наша мета — випустити вебсайт, який документує всі нові доповнення та те, як ними користуватися.

Наразі ви можете ознайомитися з функціями, які ми додаємо, безпосередньо в коді. Наш клас BaseBinding показує, які об'єкти ви можете використовувати в об'єкті Ku. Наприклад, BaseBindings містить Streams як поле. Це означає, що ви можете використовувати Ku.Steams.MethodName. Доступні методи можна знайти у файлі класу відповідного модуля. Якщо ви бачите поле, оточене ClassWrapper<?>, це означає, що для використання поля в KubeJS вам доведеться створити об'єкт. Наприклад, Level обгорнуто в ClassWrapper<LevelUtils>, тобто вам потрібно використовувати поле так: new Ku.Level(player.level). Це трохи складно, але коли вебсайт буде готовий, усе стане набагато простіше.

Застереження

Застереження: поки мод у бета-версії, очікуйте можливих змін, що ламають код. Коли ми досягнемо стабільного релізу, це повідомлення буде видалено, і з того моменту код не міститиме змін, що ламають сумісність!

Проблеми

Будь ласка, повідомляйте про будь-які проблеми в нашому трекері проблем разом із прикладом коду, щоб ми могли перевірити ці проблеми.