Vfp 权威数据 API

manifest()

asset.manifest() -> dict[str, object]

解析唯一 META JSON。常用字段为 formatVersion、sourceHash、objects[0].gridSize、chunkSize 和缓存提示。META 不能代替 validate()。

palette()

asset.palette() -> tuple[PaletteEntry, ...]

返回 PAL0 条目，index 从 1 连续编号，0 保留为空体素；每项包含 symbol、red、green、blue。

voxels()

asset.voxels() -> bytes

恢复全部 VOX0 为 x-fastest RAW8 缓冲。长度是 grid_size ** 3，偏移为 (z * grid_size + y) * grid_size + x。该调用会读取完整模型，大文件应放入后台任务。

value = asset.voxels()[(z * size + y) * size + x]