[Let's Do] API

[Let's Do] API - служебный мод-библиотека для Minecraft, который нужен другим проектам экосистемы [Let's Do]. Он не добавляет самостоятельный контент вроде новых биомов или измерений, а предоставляет готовые инструменты для разработчиков. В первую очередь API используется такими модами, как Vinery, Meadow, Beachparty и Bakery.

Проще говоря, это общая зависимость. Если один из модов серии [Let's Do] требует [Let's Do] API, библиотеку нужно установить вместе с ним. Сам проект рассчитан на работу и на клиенте, и на сервере, поэтому для сетевой игры одинаковый набор зависимостей должен быть у сервера и подключающихся игроков.

Что делает [Let's Do] API

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

Для игрока это обычно незаметная, но важная часть сборки. [Let's Do] API не меняет игровой процесс напрямую, зато позволяет другим модам корректно регистрировать предметы, рецепты, блоки и визуальные элементы без дублирования одинакового кода.

Wood API - лодки и таблички

Wood API - легковесный набор инструментов для работы с древесными материалами. Он упрощает регистрацию лодок и табличек, включая контент, который добавляют сторонние моды.

Это особенно полезно для проектов с собственными породами дерева. Разработчику не приходится заново собирать каждую связанную механику вручную, а игрок получает более цельный набор предметов в Minecraft: древесный материал может использоваться не только для блоков и мебели, но и для транспорта с табличками.

Книга рецептов в стиле vanilla

[Let's Do] API позволяет создавать книги рецептов, визуально близкие к ванильному интерфейсу. Для подключения такой книги достаточно реализовать две Java-класса, поэтому разработчикам проще добавлять отдельные категории рецептов и связывать их с механиками конкретного мода.

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

Rendering API - блоки и 3D-бронирование

Rendering API отвечает за отображение блоков и брони. Главная практическая особенность - упрощенная работа с объемными моделями брони, которые выходят за рамки обычной ванильной экипировки.

Благодаря этому другие моды могут добавлять более сложные визуальные элементы и показывать их непосредственно на персонаже. Для игрока это проявляется в виде корректного 3D-рендера предметов и экипировки, а не только плоской текстуры поверх стандартной модели.

Рендеринг зависит от конкретного мода, который использует библиотеку. [Let's Do] API сам по себе не добавляет новые наборы брони и не меняет графику игры, он предоставляет основу для их отображения.

Условные рецепты

Conditional Recipes добавляет простой механизм условных рецептов для Fabric и Forge. Такой рецепт может быть доступен только при выполнении заданного условия, например при наличии определенной зависимости или включенной функции мода.

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

Помощь с конфигурациями

В библиотеке есть вспомогательные инструменты для создания конфигурационных файлов с комментариями. Комментарии делают настройки понятнее: игрок видит, за что отвечает параметр, не открывая исходный код и не разбираясь в названиях переменных.

На практике это полезно в больших сборках модов, где конфигов становится много. Параметры отдельных проектов проще отличать друг от друга, а настройка функций проходит аккуратнее. При этом набор доступных опций определяется модом, который использует [Let's Do] API, а не самой библиотекой.

Совместимость и зависимости

Для работы [Let's Do] API обязательно требуется Architectury API. Без него библиотека не сможет корректно загрузиться, поэтому обе зависимости должны соответствовать версии Minecraft и выбранному загрузчику.

Проект поддерживает Minecraft Java Edition 1.19.2, 1.20, 1.20.1 и 1.20.2. Доступны сборки для Fabric, Forge, NeoForge и Quilt. Перед установкой проверьте не только версию игры, но и точный загрузчик: файл для Forge не всегда можно заменить версией для Fabric или Quilt.

Актуальные варианты, указанные для поддерживаемых выпусков:

• Minecraft 1.20.1, Forge и NeoForge - [Let's Do] API 1.2.15
• Minecraft 1.20.1, Fabric и Quilt - версия 1.2.14
• Minecraft 1.20.2 - версия 1.3.2
• Minecraft 1.19.2 - версия 1.1.1 beta

Для Minecraft 1.20.1 в версии 1.2.15 исправлено несоответствие CabinetInventory. В выпуске 1.2.14 размер хранилища был увеличен с 2x9 до 5x9. Эти изменения важны прежде всего для модов, которые используют соответствующие контейнеры и библиотечные функции.

Что важно знать перед установкой

[Let's Do] API не является самостоятельным контентным модом. После установки без зависимого проекта вы, скорее всего, не увидите новых предметов или механик. Его задача - обеспечить работу других модов, поэтому ориентироваться нужно на требования конкретного мода из серии [Let's Do].

Не смешивайте файлы для разных загрузчиков. Для Fabric и Quilt понадобится соответствующая версия библиотеки, а для Forge или NeoForge - отдельная сборка. Architectury API тоже должен быть установлен в подходящем варианте.

Если мод используется на сервере, проверьте зависимости в серверной папке и клиентской сборке. Отсутствие библиотеки на одной из сторон может привести к ошибке запуска или невозможности подключиться к миру.

У [Let's Do] API также предусмотрена интеграция с Terraformers API для пользовательских лодок. Это уже область совместимости для разработчиков и модов, которые добавляют собственные типы лодок, а не отдельная игровая механика для обычного игрока.

Итог

[Let's Do] API - базовая библиотека для модов Minecraft, а не самостоятельное расширение выживания. Она объединяет инструменты для древесных предметов, лодок, табличек, книг рецептов, условных рецептов, конфигураций и рендера 3D-брони.

Если в сборке используются Vinery, Meadow, Beachparty, Bakery или другие проекты серии [Let's Do], проверьте их зависимости до запуска игры. На совместимой версии Fabric, Forge, NeoForge или Quilt библиотека работает как техническая основа и помогает этим модам нормально взаимодействовать с клиентом, сервером и интерфейсами Minecraft.

Проект сейчас отмечен как архивный, а его репозиторий также архивирован. Поэтому для старой сборки важно брать версию [Let's Do] API, которая точно соответствует версии игры и зависимому моду, а не устанавливать первый найденный файл.