5 分钟快速开始

model.json

{"grid_size":2,"colors":{"A":"#2F80ED"},"data":[[["A","."],[".","."]],[[".","."],[".","."]]]}

from voxelkit import Vfp, compile_json

report = compile_json("model.json", "model.vfp", preview=False)
asset = Vfp.parse("model.vfp")
verified = asset.validate()

print(report["sourceHash"])
print(verified["gridSize"], len(asset.voxels()), asset.palette()[0].symbol)

compile_json() 的简化入口只接受 chunk_size 与 preview。它默认写入 VBUF、PMSH、ANM0、每 Chunk MSH0 和 SCNE；不生成 THMB。需要控制 RND0 或动画缓存时使用 Vfp.compile() / compile_vfp()。

若资产自带缩略图：

thumbnail = asset.thumbnail()
if thumbnail is not None:
    mime, width, height, png = thumbnail
    open("thumb.png", "wb").write(png)