JsonEM

JsonEM (Json Entity Models) - это библиотека для Minecraft, которая полностью меняет подход к созданию моделей сущностей. Вместо того чтобы писать десятки строк Java-кода для TexturedModelData, вы описываете модель в простом JSON-файле. Это особенно полезно для моддеров, создателей ресурспаков и сборщиков модов, которые хотят быстро добавить кастомных мобов или изменить существующих.

Важно: JsonEM не работает с форматом OptiFine! Если вы используете OptiFine, учтите это.

Зачем это нужно?

В ванильном Minecraft модели сущностей жёстко прописаны в коде. Чтобы добавить нового моба, нужно разбираться в Java, анимациях и системе рендеринга. JsonEM заменяет этот процесс на работу с JSON - в Blockbench или даже в обычном текстовом редакторе. Теперь любой, кто умеет редактировать json, может создавать модели для своих модов или ресурспаков.

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

Дамп эталонных моделей

Хотите посмотреть, как устроены модели всех сущностей в игре (ванильных или модифицированных)? JsonEM позволяет выгрузить их в JSON-формате, готовом для редактирования:

• Запустите Minecraft, откройте конфигурационный файл .minecraft/config/jsonem.properties.
• Измените вторую строку на dump_models=true.
• Перезапустите игру. В папке .minecraft/jsonem_dump появятся все модели сущностей, разложенные как структура ресурспака.
• Используйте эти файлы как примеры или основу для своих моделей.

Редактирование в Blockbench

Для работы с моделями JsonEM в Blockbench есть специальный плагин:

• Скачайте файл jsonem_models.js из репозитория мода.
• В Blockbench откройте File > Plugins, нажмите иконку Load Plugin from File и выберите скачанный файл.
• Теперь в File > New появится пункт JsonEM Java Entity Model - создавайте новые модели прямо в Blockbench.
• Также можно открыть готовый JSON-файл модели через File > Open Model.
• Чтобы экспортировать модель для JsonEM, используйте File > Export > Export JsonEM Java Entity Model.

Для создателей ресурспаков и сборок

Сначала выполните дамп всех моделей из вашей игры или сборки. Затем в папке ресурспака добавляйте json-файлы моделей в том же формате, что и в дампе. Например, чтобы заменить модель крипера, просто положите файл с нужными изменениями в соответствующую директорию ресурспака.

Для моддеров

JsonEM позволяет регистрировать модели сущностей без Fabric API (хотя сам мод работает на Fabric). Пример для кубической сущности:

• Подключите JsonEM в build.gradle:

repositories {
    maven { url "https://api.modrinth.com/maven" }
}
dependencies {
    modImplementation "maven.modrinth:jsonem:<version>"
    include "maven.modrinth:jsonem:<version>"
}

• Зарегистрируйте слой модели через JsonEM:

void onInitializeClient() {
    JsonEM.registerModelLayer(MODEL_CUBE_LAYER);
}

• Создайте JSON-файл модели по пути assets/вашмод/models/entity/название_слоя.json:

{
    "texture": {
        "width": 64,
        "height": 64
    },
    "bones": {
        "cube": {
            "transform": {
                "origin": [0, 0, 0]
            },
            "cuboids": [
                {
                    "uv": [0, 0],
                    "offset": [-6, 12, -6],
                    "dimensions": [12, 12, 12]
                }
            ]
        }
    }
}

• В коде модели обращайтесь к кости по имени, например modelPart.getChild("cube").

Совместимость и требования

• Minecraft: 1.19-1.21 (Fabric, Forge, NeoForge, Quilt - проверьте актуальные версии на странице мода).
• Зависимости: Fabric API (для Fabric) или аналоги.
• Не совместим с OptiFine.

JsonEM - это не просто библиотека, а инструмент, который делает моддинг более доступным. Если вы хотите добавить в игру уникальных мобов, но не хотите возиться с Java, этот мод для вас. Скачайте JsonEM, откройте Blockbench, и создавайте модели сущностей так, как вам удобно.