Browse documentation

Troubleshooting

Check the engine, review active inputs, and export a local support report when a result needs a closer look.

On this page

Check the engine

In WQuads preferences, run Check. The standard add-on ZIP contains the engine and required runtime files for its platform.

For a missing or incompatible external installation, use Install / Repair with the matching engine ZIP, or explicitly choose Bundled to use the included engine. See engine location choices and installation and repair.

Match your platform.

Use the package built for your operating system and architecture. If a system or antivirus policy blocks the engine, follow the reported guidance or contact your administrator.

Review an unexpected result

Remesh is unavailable

Select an active mesh in Object Mode, finish weight painting or the guide session, and check the engine. A running remesh must finish or be cancelled before another one starts.

The count differs from my target

Target quads is approximate. Enable Target count adjustment, review constraints, and check whether Post Optimize is reducing the result count. With adjustment off, curvature can increase the total.

The run cannot find a result near my budget

Increase Target quads or disable Target count adjustment and compare again. Adjustment may require extra attempts; use the run's warning or support report to inspect what happened.

A guide has no visible effect

Click Done to finish the edits, enable the guide in the list, turn on Apply to Remesh, and check that Guide strength is greater than 0.

A mirrored guide is missing

Mirror drawing uses the object origin. Check the axes and Projection limit; distant copies are skipped. See loops and mirroring.

Esc kept my guide edits

When no drawing gesture or axis lock is active, Esc saves and exits the guide session. Use Discard to cancel the whole session. See session controls.

Density painting does not change the total

The map redistributes the budget. Finish painting, enable Apply map, and use a positive Influence. Raise Target quads for a denser overall mesh.

The result loses an asymmetric detail

Symmetry replaces one side with a mirrored copy. Check the chosen axis, center, and source side, or disable it to preserve asymmetric input.

Textures distort near UV seams

Transfer Source UVs is experimental. Coarse output meshes can distort textures near seams. Inspect the UVs and consider a denser result. The source must already have UV maps; see Source UV transfer.

Use These Settings did not bring back my guides or paint

The action restores saved parameter values. Select the original source, which holds the guides, painted maps, and edge marks. See Result Settings.

CPU and working files

Lower CPU threads in preferences to leave capacity for other applications. If a working-file error occurs, check that Run directory is writable, or leave it empty for the system temporary folder.

See CPU and working-file preferences for the full controls.

Export a support report

Use Export support report to save a ZIP containing a report and a short log. Adding mesh files is your choice. Reports are not uploaded automatically.

For a successful run with an unexpected result, enable Keep successful mesh files in preferences and repeat the remesh before exporting. Failed-run mesh files are kept by default.

Include the Blender version, add-on version, and the steps that produced the result when sharing a report.