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.
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.