SolLib

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

SolLib — это основная библиотека для разработки модов Minecraft. Вместо копирования одних и тех же классов между проектами, она предлагает созвездие общего кода, ориентированного на данные, работу с несколькими загрузчиками и вспомогательные средства рендеринга.

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

SolConfig config = MOD.createConfig("sollib/test", 1.0, builder -> builder
    .addObject("category", category -> category
        .comment("This is a comment")
        .add("hello", "world")
        .add("easyconfig", true)
    )
);

MOD.getLogger().info(config.get("category.hello", ""));

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

SolRegistries.Data.RUNTIME.addJson(Identifier.of("minecraft", "recipe/dropper.json"), json -> {
    if (json == null) return null;
    if (!config.get("recipe.copper_dropper", false)) return null;
    
    json.getAsJsonObject("key")
            .getAsJsonObject("#")
            .addProperty("item", "minecraft:copper_ingot");
    return json;
});

Библиотека предоставляет централизованные и независимые от загрузчика инструменты для рендеринга. Использование этих средств избавляет разработчиков от необходимости создавать дополнительные миксины.

ResourceLocation TEXTURE = MOD.makeID("textures/models/sword_overlay.png");

SolClientRegistries.Render.ITEM.register(stack -> stack.is(Items.DIAMOND_SWORD) && stack.isEnchanted(),
        (stack, context, matrices, bufferSource, light, overlay) -> {
    matrices.scale(1.005f, 1.005f, 1.005f);
    matrices.translate(0, 0.995, 0.4975);
    matrices.mulPose(Axis.XP.rotationDegrees(180));

    MockItemRenderer.renderItem(matrices, bufferSource, light, TEXTURE);
});

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

MOD.register(BlockHolder.class, "block_block", () -> new Block(BlockBehaviour.Properties.of()))
    .withItem(item -> item.withFuel(200)).dropsSelf()
    .withSlab().withStairs().withWall()
    .withFlammability(20, 5);

Для получения подробной информации по использованию библиотеку рекомендуется изучить Wiki проекта или присоединиться к Discord-сообществу.

Требования проверенного файла

• По манифесту для файла sollib-forge-1.20.1-1.4.jar (Minecraft 1.20.1; Forge) требуется forge" #mandatory.