关于Viktor Ferenczi的Godot Voxel插件使用及转换工具问题求助

1. 关于Voxel.png和Model.png的疑问 #

你不需要提前准备这两个文件——它们是Python工具运行后生成的输出文件。示例命令里的Texture/Voxel.png和Texture/Model.png只是工具的输出路径，你只需要确保该路径的文件夹存在（比如提前创建Texture文件夹），工具会自动生成这两个目标文件，不用自己做占位图填充。

2. Slice.png的断言错误排查 #

触发assert slices.shape == (height * depth, width, 4)错误，和“尺寸被16整除”无关，核心是你的Slice.png尺寸、通道数，和你传入脚本的最后三个参数不匹配，按以下步骤排查：

步骤1：确认Slice.png的导出方式 #

在MagicaVoxel中导出切片时，必须：

• 选择沿Z轴切片（将所有深度层的切片垂直拼接成一张长图）
• 导出为RGBA格式的PNG（带透明通道，确保是4通道）
• 拼接后的Slice.png的尺寸规则：
  • 宽度 = 模型的实际宽度
  • 高度 = 模型的实际高度 × 模型的实际深度

比如示例里的参数64 80 48，对应的Slice.png应该是宽64像素，高80×48=3840像素，且是4通道的PNG。

步骤2：检查脚本参数的顺序 #

脚本最后三个参数的顺序是width height depth，必须严格对应你的模型实际尺寸，不能颠倒顺序。比如你的模型宽64、高80、深48，就必须传入64 80 48，如果顺序错了（比如写成80 64 48），就会触发断言错误。

步骤3：验证Slice.png的实际尺寸 #

可以用图像查看工具（比如Photoshop、GIMP或系统自带的属性查看器）检查Slice.png的像素尺寸和通道数：

• 右键图片 → 属性 → 详细信息，查看宽度、高度
• 用Python代码快速验证：

import cv2
img = cv2.imread("你的Slice.png路径", cv2.IMREAD_UNCHANGED)
print(img.shape)  # 输出必须匹配 (height*depth, width, 4)

内容的提问来源于stack exchange，提问作者Meowing