Voxel to Mesh (Basic) (DEPRECATED)

Voxel to Mesh (Basic) is the older, smaller version of Voxel to Mesh, and it carries a DEPRECATED tag in the name for a reason: when the improved node added its algorithm dropdown, this one became redundant. Everything it does, the new node does too - you just pick "basic" from the dropdown. It still exists in ComfyUI core (in the "3d" category) mostly so old workflows keep loading without breaking. Nothing to install, and it will keep working for the foreseeable future.

What it does

Identical job to its replacement: take a VOXEL grid from VAEDecodeHunyuan3D and convert it to a MESH - vertices and faces you can export with Save 3D Model. It's the block-extraction method: it walks the grid, finds every solid voxel, and puts a face on each exposed side. Fast, simple, and it produces exactly the chunky voxel-look you'd expect. If you've ever seen a low-poly blocky model and wondered how it was made, this is that algorithm in its raw form.

The inputs are the old pair: voxel in, and threshold (default 0.6, -1 to 1) as the solid/empty cutoff. One MESH output. Same threshold semantics as the modern node, same workflow position - it sits between VAEDecodeHunyuan3D and Save 3D Model in the Hunyuan 3D v2 pipeline.

Why it's deprecated

The original node was superseded in 2025 when the proper Voxel to Mesh node gained the algorithm selector. The "basic" algorithm in that node's dropdown is this node - the developers kept the old code path alive as an option rather than deleting it. So if you're building a workflow from scratch, don't reach for this one; use Voxel to Mesh and choose "basic" only if you specifically want the blocky look. On a fresh graph the only reason to pick this node is muscle memory from an old workflow file.

And honestly, you usually don't want basic. The other algorithm - "surface net" - runs the same voxel data through a smoothing interpolation and produces geometry that looks like a proper sculpture instead of stacked cubes, at the cost of some speed. For a one-shot generation it's the better trade, and it's why the modern node defaults to it in spirit.

The practical gotcha

The gotcha is the word "deprecated." Some users see it and assume the node is about to vanish or is broken. Neither is true - it's simply not recommended for new work, and ComfyUI keeps deprecated nodes loading precisely so your saved graphs don't randomly break. If an old workflow uses it, it'll run.

The one real caveat: because it's frozen while its replacement keeps evolving, any future quality fixes land on the other node, not here. If you export from this one and think the mesh is ugly, that's the algorithm, not a bug - and the fix is a two-second swap to Voxel to Mesh with the algorithm set to "surface net."

There's not much more to say, and that's the point. This is a legacy node doing a legacy job. It works, it's documented, and you can safely ignore it until an old workflow drags it onto your canvas.