Jauml

Общая библиотека модов NightBeam

Jauml (Just Another Utility Minecraft Library) содержит код, который используют наши моды: типизированные JSON-конфиги с комментариями, серверные события с планировщиком тиков и единый платформенный API для Fabric, NeoForge и Forge.

Версия 3.0 доступна для Fabric, NeoForge и Forge на 1.20.1, 1.21.1, 26.2 и 26.3. Моды, собранные под Jauml 2.x, продолжают работать с ней.

• Безопасная загрузка. Отсутствующие параметры получают значения по умолчанию, значения неверного типа преобразуются или сбрасываются, а числа вне диапазона ограничиваются, и каждый случай сопровождается предупреждением в логе.

• Вложенные секции из вложенных классов, а также списки и карты. Записи карты, удалённые игроком, остаются удалёнными.

• Миграции выполняются до привязки, поэтому переименованные или перемещённые параметры переносятся.

API конфигов 2.x полностью сохранён:

| Minecraft | Загрузчики | Java | Также установите |
|: |: |: |: |
| 1.20.1 | Fabric, Forge | 17 | Fabric API (Fabric, рекомендуется) |
| 1.21.1 | Fabric, NeoForge | 21 | Fabric API (Fabric, рекомендуется) |
| 26.2 · 26.3 | Fabric, NeoForge | 25 | Fabric API (Fabric, рекомендуется) |

• Устанавливайте её туда же, куда установлен нуждающийся в ней мод: на клиент, на сервер или на оба.

• В Fabric конфиги работают без Fabric API; серверные события и планировщик требуют его, и Jauml пишет предупреждение в лог при его отсутствии. Fabric на 1.20.1 требует Fabric Loader 0.16.10 или новее.

• При обновлении с 2.x: замените старый jar. Ваши файлы конфигов и использующие их моды продолжат работать как раньше.

• Minecraft 1.21.11 или 26.1.2? Оставьте Jauml 2.3.1; 3.0 не собрана для этих версий.

Jauml доступна в Modrinth Maven. Используйте номер версии со вкладки Versions, который оканчивается на ваш загрузчик и версию Minecraft:

Делает ли Jauml что-то сама по себе? Нет. Это библиотека: она загружается, записывает один небольшой демонстрационный конфиг только в среде разработки и ожидает моды, которые её используют.

Нужна ли она на сервере и на клиенте? Устанавливайте её туда же, куда установлен требующий её мод. Сама Jauml ничего не передаёт по сети.

Будут ли работать мои моды, собранные под Jauml 2.x? Да. 3.0 ничего не удаляет из 2.x и не меняет сигнатуры; тест в сборке фиксирует каждый метод, который вызывают выпущенные моды.

Где документация? Исходный код и README · Руководство по миграции · Список изменений · План развития · Проблемы

Где можно с вами связаться? Discord · YouTube · Другие моды NightBeam на Modrinth и CurseForge · Поддержать нас

Jauml распространяется по лицензии Apache-2.0. Сделано NightBeam Studio.