Troubleshooting

Quadify Ultra Panel Not Appearing

Ensure you are running Blender 5.0 or newer — Ultra will not load on Blender 4.x. Go to Edit → Preferences → Extensions and confirm that Quadify Ultra is listed and enabled. If the extension is enabled but the panel is missing, try disabling and re-enabling it, then restart Blender.

Unexpected Results on Non-Manifold Meshes

Non-manifold geometry — including T-junctions, internal faces, and boundary edges — can cause unexpected results with all algorithms. Before running Quadify, go to Mesh → Clean Up → Merge by Distance to close near-duplicate vertices, and Mesh → Clean Up → Delete Loose to remove floating geometry. For complex non-manifold issues, use Select → Select All by Trait → Non-Manifold in Edit Mode to identify problem areas.

Shape Key Warning

QuadriFlow + Transfer and Voxel Remesh + Transfer modes cannot preserve shape keys, since the geometry is replaced entirely. You will see a warning if shape keys are detected. Bake shape keys to separate meshes before using these modes if you need to preserve them. The Smart algorithm does not replace geometry and is safe to use with shape keys.

Mirror Modifier Warning

A warning appears when a Mirror modifier is detected on the selected mesh. For best results, apply the modifier to one half of the mesh, process it with Quadify, then re-apply the mirror. Processing a mirrored mesh without applying the modifier first can cause seam artefacts at the mirror boundary.

QuadWild Hangs or Times Out

QuadWild hangs indefinitely on high-genus topology — ironwork, lattice, filigree, ornate scanned objects — regardless of face count. This is a known limitation of QuadWild's cross-field/patch decomposition. Switch to "Exact face count" in Quick Remesh (routes to Voxel + QuadriFlow), which completes successfully on these mesh types.

For meshes that are simply too dense, try a lower resolution preset (Draft or Medium) or manually decimate the mesh before processing. On meshes above 20,000 faces, auto-decimate runs automatically before QuadWild — if it is still timing out, manually decimate further first.

To cancel a running QuadWild operation, press ESC — the live HUD in the viewport will confirm the cancellation.

All QuadWild Presets Produce Similar Results

This was a bug in versions before v1.5.0. Update to v1.5.0 or newer — the Draft/Medium/Fine/Ultra presets now produce genuinely different output densities (Draft ~8K → Medium ~18K → Fine ~40K → Ultra ~150K).

Exact Face Count Routes to QuadWild Instead of QuadriFlow

This was a Blender operator dispatch bug fixed in v1.5.0. Update to v1.5.0 or newer — "Exact face count" now always routes to Voxel + QuadriFlow as intended.

UVs Not Rebuilt After Voxel Remesh

In versions before v1.5.0, if the source mesh had UVs, the post-remesh UV step was skipped even though voxel remeshing destroys original UV data. This is fixed in v1.5.0 — Smart UV Project now always runs after Voxel Remesh.

Mesh Deselects During QuadWild

Fixed in v1.5.0. The active mesh now remains selected and active throughout QuadWild processing.

Instant Meshes Not Found

The Instant Meshes algorithm requires the binary to be configured in Settings. Go to the Settings panel, find Instant Meshes Binary Path, and set it to the path of the Instant Meshes executable on your system. Instant Meshes is not bundled with Quadify Ultra and must be downloaded separately.

ML Routing Not Improving

The ML system requires approximately 30 operations before recommendations reflect your specific mesh types. If routing recommendations seem off early on, override them manually — each correction is recorded and helps the model learn. You can also download the community model from Settings to start with a larger baseline dataset.

Agent Returns "Model Not Found" Error

When the Claude or OpenAI API returns a 404 with "model" in the response body, the agent shows: "Model X not found or deprecated — update model in Agent Settings or set a model override." Go to Agent tab → Agent Settings → Model Override and enter a valid model string.

Still Having Issues?

Use the Suggest a Feature or Report an Issue button at the top of the panel — it opens a Gmail compose link pre-filled with your mesh diagnostics and system info. Or contact Anvil Interactive Solutions at anvilinteractivesolutions@gmail.com or via the Superhive marketplace listing. Include your Blender version, Quadify Ultra version, and a description of the mesh type you are working with.