Burning

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

Для чего нужна библиотека

Burning позволяет получать доступ к запасу горящего топлива, управлять им и передавать его между печами и похожими блоками. Это основа для интеграций между модами: если сторонняя машина поддерживает нужный интерфейс, другим модам проще взаимодействовать с её топливом.

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

Техническая основа

Burning использует API Lookup и Transfer из Fabric. Архитектура во многом вдохновлена Energy API из TechReborn. Проект рассчитан прежде всего на разработчиков модов, которым нужен общий способ описать хранилище топлива и его передачу.

В версии 3.0 библиотека перешла на Storage<FuelVariant> из Fabric Transfer API. Старые API BurningStorage и BurningPropagator были удалены, поэтому модам, использующим прежние версии Burning, может потребоваться обновление интеграций.

В версии 3.1 для Minecraft 26.x добавлено логирование динамического разбора хранилищ, полезное при диагностике, а также исправлено ограничение, из-за которого проверка требуемой версии Minecraft могла блокировать будущие версии игры.

Совместимость и установка

Burning предназначена для Fabric и Minecraft Java Edition. Заявлена поддержка Minecraft 1.20.1-1.20.6, 1.21.x и 26.1.x. Это библиотечный мод: устанавливать его обычно нужно вместе с модификацией, которая использует Burning. Сам по себе он не добавляет заметного игрового контента.

Проект подходит для одиночной игры и серверов. Поскольку это API-библиотека, необходимость устанавливать её на клиент или сервер зависит от конкретного мода, который от неё зависит. Перед добавлением в сборку проверьте требования этой модификации и совпадение версии Burning с вашей версией Minecraft и Fabric.

Важно: между крупными версиями API менялось. Если после обновления перестала работать интеграция с печью или машиной, проверьте, не использует ли зависимый мод удалённые BurningStorage или BurningPropagator вместо Storage<FuelVariant>.