Ornithe Standard Libraries

Ornithe Standard Libraries (OSL) - это набор библиотек, который делает моддинг Minecraft на загрузчике Ornithe удобным и структурированным. По сути, это аналог Fabric API, только для Ornithe. Без таких библиотек разработчикам пришлось бы писать всё с нуля, а игроки получали бы меньше совместимости между модами. С OSL стандартизируются базовые вещи, и каждый мод может спокойно работать рядом с другими.

Что входит в состав OSL

Набор разбит на логические модули, и каждый решает свою задачу:

Core API

Базовый модуль, который даёт общие утилиты для других частей: система событий (events) и реестры (registries). Это фундамент, на котором всё держится.

Branding API

Патчит экран загрузки (title screen) для версий Minecraft 16w05a и ниже. Вместо пустоты показывает информацию о загрузчике модов, как это сделано по умолчанию в более новых версиях. Смотрит в аргументы запуска на параметр versionType. Мелочь, но приятно.

Config API

Фреймворк для создания и хранения конфигурации модов. Вместо ручного парсинга файлов разработчик использует готовые инструменты. Игроку проще - конфиги в одном стиле, не надо разбираться с форматами каждого мода отдельно.

Entrypoints API

Позволяет мододелам объявлять точки входа (entrypoints), которые вызываются до инициализации игры. Это значит, что твой мод может подготовить окружение до того, как Minecraft начнёт загружать свои компоненты. Правильная последовательность - залог стабильной работы.

Keybinds API

События для регистрации клавиш. Вместо того чтобы каждый мод вручную слушал нажатия, OSL даёт стандартный механизм. Можно привязать действие к кнопке, и всё будет работать на любом клиенте.

Lifecycle Events API

События жизненного цикла клиента и сервера Minecraft. Когда игра стартует, когда выходит, когда загружается мир - на каждый этап можно повесить свою логику. Для серверных модов это особенно критично.

Networking API

Инструменты для общения клиента и сервера. Всё, что нужно для передачи пакетов, синхронизации данных, кастомных команд - это здесь. Без этого API многопользовательские моды вообще не взлетели бы.

Resource Loader API

Позволяет модам загружать свои собственные ресурсы: текстуры, модели, звуки, локализации. То есть мод приносит всё своё, не полагаясь на ванильный ресурспак. Если мод добавляет новый блок или существо - без этого модуля никуда.

Для разработчиков

Если ты пишешь мод под Ornithe, то добавить OSL в проект проще простого. Используй плагин Ploceus gradle:

dependencies {
    ...
    ploceus.dependOsl('0.20.1')
}

Можно подключать не всё сразу, а только нужные модули:

dependencies {
    ...
    ploceus.dependOslModule('0.20.1', 'core')
    ploceus.dependOslModule('0.20.1', 'entrypoints')
}

Итог

Ornithe Standard Libraries - стандартная база для любого мода на Ornithe. Если ты собираешься играть с модами на этом загрузчике - OSL будет стоять почти у каждого. Разработчикам это упрощает жизнь, игрокам даёт совместимость. Скачать Ornithe Standard Libraries можно и для ознакомления, и для сборки модов.