Jigsaw Logic Lib

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

Установка

Для добавления библиотеки в ваш проект выполните следующие шаги:

Добавьте в файл build.gradle:

repositories {
    maven { url 'https://jitpack.io' }
}
dependencies {
    modImplementation 'com.github.Totobird-Creations:JigsawLogicLib:${jigsawlogiclib_version}'
    // Опционально:
    include 'com.github.Totobird-Creations:JigsawLogicLib:${jigsawlogiclib_version}'
}

Укажите версию в gradle.properties:

jigsawlogiclib_version = v1.0.1-mc1.19

Добавьте зависимость в файл fabric.mod.json:

"depends": {
    "jigsawlogiclib": "1.x.x"
}

Использование

В методе onInitialize вашего инициализатора добавьте следующий код:

LogicCommandManager.register(
    new Identifier("yourModId", "commandName"),
    (metadata, world, blockPos, structureOrigin) -> {
        // Параметры:
        // - String   metadata        : Дополнительная информация от логического блока.
        // - World    world           : Мир, в котором выполняется логический блок.
        // - BlockPos blockPos        : Позиция логического блока при выполнении.
        // - BlockPos structureOrigin : Позиция начала генерации структуры.
        // Важные заметки:
        // - Если вы изменяете блоки, убедитесь, что они находятся в том же чанке.
    }
);

Порядок действий в игре

1. Настройте структуру обычными блоками структуры и разместите логический блок внутри нее.
2. Получите логический блок командой: /give @s jigsawlogiclib:logic
3. Установите его и задайте значение команды как указано выше: yourModId:commandName
4. При желании добавьте метаданные, которые будут переданы в вашу функцию.
5. Сохраните изменения кнопкой "Готово" или протестируйте через "Запуск".
6. Сохраните структуру и настройте все необходимые файлы генерации мира.