ReQuad documentation

ReQuad documentation

How to install and use ReQuad, the Blender quad remesher for AI-generated meshes: every option, the Result box, the triangle fallback and the limits.

What ReQuad is

ReQuad is a Blender add-on that turns a dense AI-generated mesh into a quad mesh with the face count you choose. It is made for models from Meshy, Tripo, Hunyuan3D, Rodin and TRELLIS. The result has quads where the model is thick enough and triangles on thin parts, in one welded mesh. For the pitch, the measurements and the price, see the ReQuad product page.

This page covers version 0.1.4 on Blender 4.2 and newer. Platforms: macOS (Apple Silicon and Intel), Windows (x86-64) and Linux (x86-64). Intel Mac: Blender 4.2–4.5 (Blender 5.x has no Intel Mac build).

Install

  1. Download the .zip from the store. Do not unpack it.
  2. In Blender, open Edit > Preferences > Get Extensions, open the arrow menu at the top right and choose Install from Disk.
  3. Pick the downloaded .zip.
  4. In the 3D Viewport press N and open the ReQuad tab.

Safari note. Safari unpacks .zip downloads automatically, and Blender then has no .zip to install. Download with Chrome or Firefox, or turn off Safari > Settings > General > Open "safe" files after downloading, then install the .zip with Install from Disk.

To update, install the new .zip the same way; updates are free. To remove the add-on, find ReQuad in Get Extensions among the installed extensions and remove it. Your meshes are not changed by removing it.

Remesh a model

  1. Select the model in Object Mode. In Edit Mode the panel shows Go to Object Mode to remesh.
  2. In the ReQuad tab, set Faces.
  3. Press Remesh to Quads. A progress bar and a Cancel button appear. You can keep orbiting, modelling and saving.
  4. When the job is done, a new object appears next to the source, named after it with _quads added. The source is hidden in the viewport.

One Cmd/Ctrl+Z removes the result. With the result active, Show the Source shows the original again, makes it active and hides the result in the viewport.

The remesh runs in a second Blender in the background. On Apple Silicon it takes 2 seconds to 4 minutes at 10,000 faces, depending on the source; a model of 1 million triangles usually takes 30 to 90 seconds. Cancel stops the job in under a second.

Options

OptionWhat it doesDefault
FacesTarget number of faces of the result: quads, plus triangles where the model is too thin for a quad. From 5,000 to 50,000. The result is within about 5% of it, or the Result box says how far off it is.10,000
Hide the sourceHides the source object in the viewport when the result arrives (the eye icon in the Outliner). The source is never changed or deleted, and it still shows in renders until you hide or delete it there.On
Triangles if quads failWhen a model cannot take clean quads at this face count, you get a triangle mesh with the same face count and the reason. Off: you get the reason and no new object.On
Skip inner layersAI-generated models often have a second skin under the visible one. When that makes the model read as paper-thin, the layers that cannot be seen from outside are left out.On

The Result box

After each run a box under the button shows the name of the new object with a check mark, or a warning sign when the triangle fallback was used. Below it are the face count, the share of quads, the shape deviation from the source and the time.

If the job fails, the box shows the reason. When there is a log file, the box shows its path and a Copy log path button. Send that file to [email protected].

The triangle fallback

Not every model can become quads. A model that is mostly thin sheets, or a quad mesh that fails the shape check, gets a triangle mesh with the face count you asked for, and the Result box says why in plain words, for example "53% of the surface is thinner than one quad at this budget".

What to try:

  • A different face count. More faces make each quad smaller, so thinner parts can take quads.
  • Leave Skip inner layers on. A hidden second skin can make a model read as paper-thin.
  • Accept the triangle mesh. It has the face count you asked for and is a clean, usable mesh.

Limits

  • No UVs and no materials: the result is a plain mesh. Keep your original for textures, or use AssetBake, which adds new UVs and baked textures.
  • No symmetry, no edge-flow guides and no density painting.
  • Sharp edges are not kept. It is not for hard-surface or CAD shapes.
  • Thin parts, thinner than about one and a quarter quad edges, are always triangles.
  • It does not make animation-ready edge loops.
  • One active mesh object at a time. Sources over 2 million triangles are refused.
  • Results are promised for AI-generated meshes only. We did not measure sculpts or 3D scans.

Messages in the panel

Select a mesh object. Nothing is selected, or the active object is not a mesh. Click the model in the viewport.

The object has no faces. The active object is a mesh without faces, for example only vertices or edges. Pick the model itself.

Go to Object Mode to remesh. Press Tab to leave Edit Mode.

Version history

0.1.4 (19 November 2026)

  • Intel Mac support, on Blender 4.2 to 4.5 (Blender 5.x has no Intel Mac build). ReQuad now runs on macOS (Apple Silicon and Intel), Windows (x86-64) and Linux (x86-64).

0.1.2 (19 November 2026)

  • Windows (x86-64) support. ReQuad runs on macOS (Apple Silicon), Windows (x86-64) and Linux (x86-64). Intel Mac is not supported yet.

0.1.1 (18 November 2026)

  • First release: quad remesh in the background, 5,000 to 50,000 faces, triangle fallback with a reason.

Support

Write to [email protected], with a reply within 24 hours. If the Result box shows a log file, attach it.