Aquamarine

Библиотека для создания многоблочных структур в модах Minecraft, значительно упрощающая процесс их разработки. Данный мод позволяет создавать многоблоки по аналогии с Modern Industrialization - конструкции, состоящие из контроллера, стандартных блоков и специальных блоков-люков для ввода/вывода ресурсов.

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

Документация доступна, но пока не охватывает все аспекты и продолжает дополняться.

Основные возможности

Многоблочные структуры

Многоблоки формируются из списков, включающих как обычные элементы, так и флаги для люков. Обычные элементы определяют, какой блок должен находиться в конкретной позиции. Флаги люков указывают, какие типы люков могут заменять данную позицию. Также предусмотрена возможность указания пустых флагов.

Многоблочные структуры легко получают доступ к подключенным люкам для передачи предметов, жидкостей и энергии между многоблоком и люками.

Визуализация многоблоков

Поэтапный предпросмотр слоями

Индикация заменяемых блоков

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

Полная визуализация структуры

Возможен предпросмотр всей многоблочной конструкции целиком, однако этот метод не рекомендуется, так как может отображаться некорректно. Поэтапное отображение по слоям значительно удобнее для строительства.

Руководство по использованию

Добавление зависимости

Добавьте версию в gradle.properties

aquamarine_version = 0.0.1-1.21.3 # замените на идентификатор версии со страницы загрузки

Добавьте репозиторий в build.gradle

repositories {
  maven { url 'https://jitpack.io' }
}

Добавьте зависимость в build.gradle

dependencies {
    modApi "com.github.KrazyMiner001:Aquamarine:${project.aquamarine_version}"
}

Практическое применение

Создайте класс, расширяющий MultiblockBlockEntity и реализующий необходимые методы. Создайте класс, расширяющий HatchBlockEntity и реализующий необходимые методы. Создайте блоки для обеих сущностей блоков. Сформируйте многоблочную структуру. (более подробное объяснение будет добавлено позже)