材质与资源包

内置色块

不提供资源包时，引擎使用内置色块 catalog。它适合快速预览、CI 和回归测试，但不会还原真实贴图。

blockscope render model.litematic --output out.png

blockscope render model.litematic --output out.png --client-jar client.jar

客户端 jar 中可以包含 assets/minecraft/blockstates、models 和 textures。引擎直接读取 jar，不会解压到工作目录。

blockscope render model.litematic --output out.png --assets ./assets

--assets 指向包含 assets/minecraft/... 的目录，或已解压的 assets/ 目录。

blockscope render model.litematic --output out.png \
  --client-jar client.jar \
  --resource-pack ./packs/my-pack

--resource-pack 可以是目录，也可以是 zip/jar。overlay 中的同名 blockstate、 model 或 texture 会覆盖 base。

资源包缺失模型或贴图时，引擎会按以下顺序回退：

使用 materials --json 查看覆盖率和缺失统计：

blockscope materials model.litematic --client-jar client.jar --json

非 JSON 的 render 输出也会打印材质诊断。完整材质规则见资源包材质说明。

资源包、客户端 jar 应Minecraft EULA 请自行提供。本仓库不包含.jar、resourcepacks/、Minecraft 贴图或其他 Minecraft 资产