PotionRecipes Lib
PotionRecipes Lib — это компактная библиотека-API, созданная для того, чтобы упростить разработку модов, связанных с варкой зелий. Если вы когда-нибудь пытались вручную прописать логику получения нестандартного зелья из ингредиента, вы знаете, насколько это утомительно. PotionRecipes Lib берёт эту рутину на себя: достаточно одного вызова метода, чтобы зарегистрировать новый рецепт. Автор честно называет проект «навороченным инвокером» — и это точное описание. Ничего лишнего, только удобная обёртка над стандартным механизмом Brewing Stand.
Стоит сразу отметить важный нюанс: проект официально архивирован. Это значит, что новых обновлений ждать не стоит, но для множества существующих сборок и модов библиотека продолжает работать стабильно. Если вам нужна только регистрация рецептов варки — этого более чем достаточно. Если же требуются более сложные манипуляции с NBT-данными, стоит присмотреться к альтернативам вроде nbt-crafting api.
Для каких версий Minecraft и загрузчиков подходит библиотека
PotionRecipes Lib разрабатывалась в первую очередь под Forge. Она ориентирована на версии Minecraft эпохи 1.12–1.16, когда форджевые моды активно использовали систему BrewingRecipeRegister. Именно в этот период библиотека была востребована среди моддеров, создававших собственные алхимические системы, кастомные зелья и уникальные ингредиенты.
С выходом новых версий и переходом сообщества на Fabric и NeoForge актуальность оригинального API снизилась, однако старые проекты по-прежнему зависят от него. Если вы поддерживаете устаревший модпак или хотите разобраться в архитектуре старых модов, PotionRecipes Lib для Minecraft станет полезным примером грамотного и минималистичного API.
Как установить PotionRecipes Lib
Установка библиотеки не требует сложных манипуляций, но зависит от того, как вы планируете её использовать.
- Для игрока: скачайте PotionRecipes Lib и поместите файл в папку mods рядом с остальными модами. Убедитесь, что версия библиотеки совпадает с версией Minecraft и загрузчиком.
- Для разработчика: подключите библиотеку как зависимость в файле build.gradle вашего проекта. Подробности интеграции описаны на странице проекта в GitHub.
- Проверьте совместимость: если мод, который вы устанавливаете, требует PotionRecipes Lib, ставьте именно ту версию, которая указана в его требованиях.
Тем, кто предпочитает не возиться с ручным копированием файлов, стоит обратить внимание на лаунчер foxygame.net: в его каталоге дополнений PotionRecipes Lib устанавливается в один клик вместе со всеми зависимостями, а совместимость версий проверяется автоматически перед запуском сборки.
Как использовать API в разработке модов
Основная функция библиотеки максимально проста. Разработчику достаточно вызвать метод регистрации рецепта, передав в него три параметра:
- input — исходное зелье, от которого начинается варка. Обычно это Potions.AWKWARD или собственное зелье, созданное через YourPotions.POTION.
- item — ингредиент, который игрок должен положить в варочную стойку, чтобы получить результат.
- output — итоговое зелье, появляющееся после завершения процесса варки.
Такой подход позволяет буквально одной строкой кода добавить новый рецепт, не углубляясь в дебри внутренних механизмов Minecraft. Автор специально оставил API открытым и минималистичным, чтобы разработчики могли легко читать исходники и адаптировать их под свои задачи. Лицензия CC0 снимает почти все ограничения: вы можете свободно изучать код, копировать фрагменты и встраивать их в собственные проекты, включая коммерческие.
Преимущества и ограничения
К плюсам PotionRecipes Lib можно отнести простоту, лёгкий вес и понятную документацию. Библиотека не тянет за собой лишние зависимости и не конфликтует с большинством модов на варку. К минусам — статус архива и отсутствие поддержки современных версий. Тем не менее для обучения и работы с легаси-проектами это отличный инструмент.
Если вы только начинаете путь моддера и хотите разобраться, как устроена система зелий в Minecraft, PotionRecipes Lib станет хорошей отправной точкой. А если вам нужен готовый рабочий рецепт для существующей сборки — библиотека решит задачу без лишних усилий.
В итоге PotionRecipes Lib остаётся аккуратным и полезным примером того, как небольшая библиотека может упростить жизнь целому сообществу разработчиков. Скачать PotionRecipes Lib стоит хотя бы для того, чтобы изучить её исходный код и понять, насколько элегантно можно решать типовые задачи в моддинге Minecraft.