JsonEM

JsonEM（Json 实体模型）

为 模组开发者、资源包制作者 和 整合包制作者 提供的库，用于通过 JSON 创建和编辑实体模型

不兼容 OptiFine 格式！

生成参考实体模型：

如果你想导出所有实体模型（原版或模组）的 JSON 版本，以便轻松通过资源包编辑或用作示例，请按以下步骤操作：

• 启动游戏，然后打开位于 .minecraft/config/jsonem.properties 的配置文件。
• 将文件的第二行修改为 dump_models=true。
• 重新启动游戏。导航到文件夹 .minecraft/jsonem_dump。
• 在此文件夹中，你应该能找到所有已注册的实体模型以 JSON 格式导出，结构类似于资源包。
• 在通过资源包编辑或添加模型时，请使用此格式。

在 Blockbench 中编辑模型：

要在 Blockbench 中编辑模型，请安装此仓库中的插件。

• 从此 GitHub 仓库 下载 文件 jsonemmodels.js
• 在 Blockbench 中，导航到 文件 > 插件，在对话框顶部点击 从文件加载插件 图标。选择 jsonem_models.js 文件。
• 导航到 文件 > 新建，选择 JsonEM Java 实体模型 开始编辑。
• 你也可以通过 文件 > 打开模型 导入 JsonEM 的 JSON 模型文件，例如从游戏中导出的模型。
• 要 导出 你的模型以供 JsonEM 使用，请导航到 文件 > 导出 > 导出 JsonEM Java 实体模型 并保存文件。

对于资源包/整合包制作者：

• 完成上述步骤，从你的游戏或整合包中导出所有实体模型。
• 在编辑资源包/整合包资源时，按照导出模型文件夹中的格式添加实体模型 JSON 文件。

对于模组开发者：

JsonEM 可用于完全通过 JSON 为你的实体创建 TexturedModelData。

本指南将演示如何为 此教程 中的 方块实体 制作模型。

• 按如下方式引入模组（版本可在 此处 找到）：

repositories {
	maven { url "https://api.modrinth.com/maven" }
}
dependencies {
    // 将  替换为所需版本
    modImplementation "maven.modrinth:jsonem:"
    include "maven.modrinth:jsonem:"
}

• 通过 JsonEM 而非 Fabric API 注册你的实体模型层（无需代码生成的 TexturedModelData）

void onInitializeClient() {
    [...]
    JsonEM.registerModelLayer(MODEL_CUBE_LAYER); // 层 ID："entitytesting:cube"，层名称："main"
}

• 向你的模组资源中添加一个模型文件，包含你的实体模型数据

示例： assets/entitytesting/models/entity/cube/main.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]
                }
            ]
        }
    }
}

• 确保上述文件中的骨骼 "cube" 在你的实体模型中以相同名称被访问

public CubeEntityModel(ModelPart modelPart) {
    this.base = modelPart.getChild("cube"); // 原教程使用了未指定的字段 EntityModelPartNames.CUBE
}