MCTOOLBOX
MC ToolboxMC TOOLBOX

创造

Minecraft 方块模型生成器

使用常见原版父模型的 Java 方块模型 JSON 起始文件。你仍需要匹配的 blockstate 文件将其连接到方块。

模型

资源包位置

assets/<namespace>/models/block/custom_block.json

This only writes the model. Add a blockstate JSON under assets/<namespace>/blockstates/ so the game knows when to use it. Textures must exist under assets/<namespace>/textures/... matching the paths above.

已生成 custom_block.json

{
  "parent": "minecraft:block/cube_all",
  "ambientocclusion": true,
  "textures": {
    "all": "my_pack:block/custom_block",
    "particle": "my_pack:block/custom_block"
  }
}

这个 Java 方块模型生成器能创建什么

此工具生成一个 Java 版方块模型 JSON 起始文件，它继承自常见的原版父模型。选择完整立方体、原木式柱体、交叉植物或熔炉式朝向模型，然后为父模型所需的纹理变量赋值。

模型文件仅描述外观。它不会添加新的原版方块、创建纹理、注册模组方块，也不会决定方块状态使用哪个模型。你仍然需要匹配的资源包文件夹以及由目标项目提供的 blockstate 或其他注册。

选择匹配几何形状的父模型

cube_all 在每个面使用同一纹理。cube_column 区分顶部和侧面纹理。cross 创建交叉平面，适合植物类模型。orientable 为方向性方块提供顶部、正面和侧面纹理。

将纹理路径写为资源位置

例如 my_pack:block/custom_block 指向 assets/my_pack/textures/block/custom_block.png。在 JSON 资源位置中不要包含 assets、textures 或 .png 扩展名。

将模型与 blockstate JSON 关联

将下载的模型保存到 assets/<namespace>/models/block 下。然后创建 blockstate 映射，为正确的方块属性和朝向选择此模型。具体的 blockstate 结构取决于方块和项目。

了解环境光遮蔽的影响

环境光遮蔽会在模型面与附近表面接触处添加柔和阴影。对于需要更平坦光照的模型，可以禁用它，然后在游戏中比较效果，因为纹理和着色器设置会影响最终外观。

创建 Minecraft 方块模型起始文件

  1. 选择安全的小写文件名和最接近的原版父模型。
  2. 输入该父模型所需的每个纹理资源位置。
  3. 选择模型是否使用环境光遮蔽。
  4. 将 JSON 下载到 assets/<namespace>/models/block。
  5. 添加纹理和匹配的 blockstate 或项目注册，然后重新加载资源包并检查游戏日志。

Minecraft 方块模型常见问题

这能向原版 Minecraft 添加全新方块吗？

不能。资源包模型只改变外观，不会注册新的方块 ID。新方块需要相应的模组、插件和包系统，或其他受支持的自定义工作流程。

为什么显示紫色和黑色缺失纹理？

Minecraft 无法解析纹理资源。请检查命名空间、小写路径、PNG 位置、文件名以及游戏日志中具体的缺失资源 ID。

添加 JSON 后为什么模型不显示？

该文件可能未被 blockstate 选中，可能位于错误的命名空间或文件夹，或者使用的模型路径与 blockstate 引用不同。模型 JSON 无法自行激活。

交叉植物父模型会使纹理透明吗？

父模型提供交叉几何形状，但透明度和渲染行为还取决于纹理 alpha 以及游戏或项目的渲染规则。请在游戏中测试完整的资源设置。