S-Lib

S-Lib

S-Lib — это легковесная библиотека утилит и конфигов для моддинга Minecraft.

Пример мода: Загляните в репозиторий S-Lib Test Mod — там есть полные примеры использования конфигов и генерации GUI с помощью YACL.

Возможности

Конфиги на аннотациях

• Регистрируйте синхронизируемые или локальные конфиги одной строкой кода с помощью SLibConfig.syncedBuilder() или SLibConfig.localBuilder().

• Сетевые опции @Sync:

  • OVERRIDE_CLIENT: конфиг, авторитетный на сервере, синхронизируется с клиентом. Конфиг рассылается при входе и обновляется в реальном времени. Поддерживает настраиваемые проверки прав (например, только для OP).
  • INFORM_SERVER: локальный конфиг, уведомляет сервер об изменениях
  • NONE: локальный конфиг, без сетевой синхронизации
• Новые добавленные поля автоматически заполняются значениями по умолчанию, устаревшие ключи удаляются, а значения ограничиваются указанными диапазонами при использовании аннотаций @RangeInt, @RangeFloat и @RangeDouble.
• Вставляйте комментарии с помощью аннотации @Comment над полями прямо в классе конфига.
• Резервные копии создаются автоматически при обнаружении повреждения файла или неверного синтаксиса, сохраняя сломанный конфиг, если вы случайно допустили ошибку.
• Используйте аннотацию @Nest, чтобы задействовать вложенные классы для более сложных структур конфигов.
• Используйте аннотацию @Ignore, чтобы полностью игнорировать поле.
• Встроенные адаптеры типов, совместимые с сериализацией для классов AWT Color, Minecraft TextColor, Identifier, Pattern и UUID.

Кастомные контроллеры YACL

Кастомные контроллеры для YACL:

• Продвинутый контроллер цвета: Поддерживает hex-коды (#RRGGBBAA), названия цветов Minecraft и устаревшие коды форматирования (&a, &3).
• Контроллер предметов или тегов: Выпадающий список с автодополнением для точных предметов, тегов (#c:swords), пространств имён (minecraft:*) и regex-шаблонов.
• Простые выпадающие списки: Селекторы выпадающих списков для Enum и String.

Общие утилиты

• Движок сопоставления целей: Сопоставление предметов по точным ID, тегам, пространствам имён, шаблонам (*) и regex (regex:.*_sword).
• Помощники платформ: Абстракции для методов, специфичных для загрузчика, как в виде общей утилиты (PlatformHelper), так и для сетевых функций (NetworkHelper).
• Утилиты математики и цвета: Функции сглаживания (lerp, ease-out, clamp), генераторы текстовых градиентов, утилиты цвета и многое другое.