QuadMend – Quad Remesher for AI & Scanned Models

MendWorks in Modeling


Installation

  1. Download quadmend-0.10.8.zip. Do not unzip it.
  2. In Blender, open Edit → Preferences → Get Extensions.
  3. Click the ⌄ menu in the top-right corner and choose Install from Disk…
  4. Select the .zip file and click Install from Disk. (You can also drag the .zip into the Blender window.)
  5. Make sure QuadMend is ticked in the list.

If Blender says "Cannot read file … Permission denied", you selected an unzipped folder. Choose the .zip file itself.

Updating: install the new .zip the same way. It replaces the old version, and there's no need to uninstall first.

Using QuadMend

  1. Switch to Object Mode and click your model to select it.
  2. In the 3D View, press N to open the sidebar and click the QuadMend tab.
  3. Set Target Faces (see below).
  4. Click Remesh to Quads. Progress appears in the status bar at the bottom of the window. Press Esc to cancel.
  5. When it finishes, a new object with _quads added to its name (for example Dragon_quads) appears with the same position, rotation and scale. The original is hidden, not deleted: find it in the Outliner.

If your model imports as several pieces, select them all and press Ctrl+J to join them first. QuadMend works on one object at a time; to do several, select them all and click Remesh Each Selected.

Settings

Setting What it does
Target Faces Roughly how many quads you want. 3,000 for a game prop, 5,000–10,000 for a detailed prop, 10,000–20,000 for a hero character. The result lands close to this number.
Best / Fast Best runs two quad engines and keeps the better result. Fast runs QuadriFlow only (quicker, and the only mode on Intel Macs).
Hide Original Hides the original in the viewport and in renders after the run, so the two don't overlap. Untick to keep both visible.
Transfer Textures Bakes base color, roughness, metallic, alpha and emission from the original's material (including mixed shaders and node groups) or its vertex colors onto the new mesh.
Detail Normal Map Bakes a tangent-space normal map that carries fine surface detail onto the new mesh.
1K / 2K / 4K Resolution of the baked texture maps.

The result

  • New UVs and material. The result gets its own UV map and a material ending in _quads_mat with the baked images connected to a Principled BSDF. The images are packed into the .blend. To use them in another program, save them from the Image Editor (Image → Save As), or export the model as glTF/FBX with textures.
  • The report in the panel shows:
    • Avg. distance and Worst 1%: the average gap between the new surface and the original, and the gap only 1% of the surface exceeds, in % of the model's size.
    • Surface within 1%: how much of the original's visible surface lies within 1% of the model's size. Below 99% means fine detail didn't fit, and the panel suggests a face count to try.
    • Quad share, open edges, separate parts and geometry warnings (non-manifold edges, self-intersections), if any, and how many small pieces the cleanup removed.
    • Show Error Map colors the result by distance to the original: blue on the surface, green 0.5%, yellow 1%, red 2% or more.
    • Copy Report copies the full technical report (version, settings used, each engine's scores) for bug reports.

More options (sub-panels, new in 0.10.8)

Option What it does
Remove Pieces Under Separate pieces smaller than this (% of the model's size, default 1) are removed as debris. Set 0 to keep everything, like teeth, buckles and accessories. The magnifier button selects the pieces that would be removed so you can check them. Kept pieces too small to rebuild as quads are carried over unchanged.
Never Remove Selected Pieces with a face selected in Edit Mode are always kept.
Parts: Merge & Repair / Keep Separate Merge & Repair (default) rebuilds touching parts as one clean surface. Keep Separate remeshes each separate part on its own, so a sword in a hand stays a separate part.
Symmetry X / Y / Z Mirrored topology across the model's centre (QuadriFlow only), for models that are symmetrical in their own local space.
Shading Smooth, Sharp Edges (edges sharper than the angle stay sharp, for hard-surface models) or Flat.
Keep Other Results Also keeps the other engine's result as a hidden object (name_quads_instant or _quadriflow), to compare and pick.
Limit Steep Normals On by default: limits normal-map tilt so folds don't shade black. Untick to keep the raw baked normals.
Ray / Retry Distance, Cage How far the bake searches for the original (% of size), how far it retries for missed texels, and an optional cage mesh.
Bake Textures Bakes onto a result you have edited (topology or UVs); with Keep My UVs it uses your UV map. Select the result, or the original and the result with the result active.

If baking fails or you press Esc during baking, the new mesh is kept without textures; click Bake Textures to try again. An unconnected name_coverage image in the result's material shows where the bake reached the original (white), where the retry did (grey) and what was filled (black).

Troubleshooting

Problem Fix
Remesh to Quads is greyed out Select a mesh object and switch to Object Mode.
Blender seems frozen Check the status bar. Texture baking at the end pauses Blender for a few seconds up to a minute on large models.
Result is grey, no colors Switch the viewport to Material Preview. If it's still grey, the original has no color texture or vertex colors.
"Fine detail didn't fit" Raise Target Faces to the number the panel suggests and run again.
"Instant Meshes unavailable" Normal on Intel Macs. QuadMend still works using QuadriFlow only.
Something else Click Copy Report in the panel and send it to me with a screenshot.

Support

Questions and bug reports through Superhive messages. I reply within 72 hours. Please include the text from Copy Report.

Changelog

  • 0.10.2: First public release.

Credits: Bundled Instant Meshes (BSD-3-Clause, Wenzel Jakob et al.) via pynanoinstantmeshes, and oneTBB (Apache-2.0). Example models in the images: dragon from Step1X-3D (Apache-2.0), robot and mech from Tripo via DetailGen3D (MIT).

$15

Have questions about this product?
Login to message

Details
Blender Extension Compatible Yes
Sales 10+
Rating
2 ratings
Published about 2 months ago
Blender Version 4.2 - 5.2
Extension Type Add-on
Render Engine Used Cycles
License GPL