> For the complete documentation index, see [llms.txt](https://artemis3d.gitbook.io/bqr-boolean-quad-ready/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://artemis3d.gitbook.io/bqr-boolean-quad-ready/welcome-to-bqr/how-to-use-it.md).
# How to use it
A simple how to use guide
### 🧩 RemeshIT – Main Remeshing Engine
The **RemeshIT** button is the heart of the BQR workflow. When pressed, it automatically adds a chain of modifiers (Remesh → Bevel → Subdivision Surface) optimized to convert dense, triangulated geometry into a clean, quad-dominant mesh suitable for boolean operations and further modeling.
This operator is particularly useful for CAD imports or high-poly assets that need to be transformed into smoother, concept-friendly, quad-based geometry, ready for boolean operations!
## 🔍 Main Workflow Parameters
{% tabs %}
{% tab title="Octree Depth" %}
**Octree Depth**
**What it does**: Controls the level of detail of the voxel remesher.
* **Higher values** create finer geometry but also increase polygon count.
* **Lower values** reduce detail and simplify the mesh more aggressively.
{% embed url="" %}
Example Video
{% endembed %}
{% hint style="success" %}
**Tip**: Use values between **4–6** for most boolean-friendly results.
{% endhint %}
{% endtab %}
{% tab title="Scale" %}
**Scale**
**What it does**: Adjusts how tightly the remesher fits the surface.
* A **higher value** (closer to 1) creates a denser remesh.
* A **lower value** leaves more spacing between vertices, leading to a lighter mesh.
{% embed url="" %}
Example Video
{% endembed %}
{% hint style="success" %}
**Tip**: If you experience holes or distortions, try slightly lowering this value (e.g., 0.85).
{% endhint %}
{% endtab %}
{% tab title="Amount" %}
**Bevel Amount**
**What it does**: Determines how thick the bevel is on sharp edges.
* **Higher values** produce softer, more visible bevels.
* **Lower values** keep the bevel tight and technical.
{% embed url="" %}
{% hint style="success" %}
**Tip**: A setting of **0.02–0.05** is ideal for clean technical edges.
{% endhint %}
{% endtab %}
{% tab title="Segments" %}
**Segments**
**What it does**: Sets how many subdivisions are used in the bevel curve.
* **Higher segments** create smoother curves.
* **Lower segments** are better for hard-surface models.
{% embed url="" %}
{% hint style="success" %}
**Tip**: Keep this at **3** for a good balance between quality and performance
{% endhint %}
{% endtab %}
{% tab title="Angle" %}
**Angle**
**What it does**: Specifies the minimum edge angle (in degrees) that will receive a bevel.
* **Lower values** apply bevels to more edges.
* **Higher values** apply bevels only to sharp corners.
{% embed url="" %}
{% hint style="success" %}
**Tip**: 30° is usually ideal for CAD or modelling.
{% endhint %}
{% endtab %}
{% endtabs %}
{% tabs %}
{% tab title="Shape" %}
**Shape**
**What it does**: Adjusts the profile curve of the bevel.
* A value of **0** creates a concave bevel.
* A value of **1** creates a convex bevel.
* **0.5** gives a uniform, even bevel.
{% embed url="" %}
{% hint style="success" %}
**Tip**: 0.5 is the most stable and recommended for general use.
{% endhint %}
{% endtab %}
{% tab title="Subdivision" %}
#### **Subdivision Level**
**What it does**: Controls how many levels of Subdivision Surface are applied after the bevel.
* **Higher levels** give a smoother, more rounded result.
* **Lower levels** keep the mesh lightweight and sharper.
{% embed url="" %}
{% hint style="success" %}
**Tip**: Use **1 or 2** depending on the level of visual smoothness you want.
{% endhint %}
{% endtab %}
{% tab title="Reset Settings" %}
This button resets all the remeshing-related values (Octree Depth, Scale, Bevel Amount, Segments, Angle, Shape, and Subdivision Level) back to their default state.
{% embed url="" %}
{% hint style="success" %}
**Tip:** Use it if your mesh gets distorted or if you want to start fresh without tweaking sliders manually.
{% endhint %}
{% endtab %}
{% tab title="Clear BQR Modifier" %}
Removes all modifiers added by the BQR workflow: Remesh, Bevel, Subdivision Surface, and Smooth.
{% embed url="" %}
{% hint style="success" %}
**Tip:** Ideal when you want to delete everything BQR added without affecting other modifiers you may have on the mesh.
{% endhint %}
{% endtab %}
{% endtabs %}
***
## ✨ Refining Parameters
{% tabs %}
{% tab title="Smooth Repeat" %}
Controls how many times the smoothing modifier is applied to the mesh. It helps soften the shading and clean up minor artifacts after remeshing.
{% embed url="" %}
{% hint style="success" %}
**Tip:** Use higher values (e.g. 30–50) if your mesh looks too rough or jagged after remeshing. Be careful not to overdo it excessive smoothing might blur sharp details.
{% endhint %}
{% endtab %}
{% tab title="Beauty Bevel" %}
Toggles the use of a more aesthetically pleasing bevel profile (Arc instead of Sharp). This results in smoother, rounded bevels, ideal for concept art or stylized hard-surface models.
{% embed url="" %}
{% hint style="success" %}
**Tip:** If your CAD model breaks or explodes after applying Remesh, disable this setting. Some dense or complex meshes may not support Beauty Bevel properly.
{% endhint %}
{% endtab %}
{% endtabs %}
***
## 🔨 Modeling
{% tabs %}
{% tab title="Mirror" %}
The Mirror feature automatically creates a Mirror modifier with an empty object at the world center. Select mirror axes (X, Y, Z), set Merge/Clip options, and control its position in the modifier stack with a single click.
{% embed url="" %}
{% hint style="success" %}
Tip: you can move the mirror in the modifiers by moving it before or after the remesher according to your needs
{% endhint %}
{% endtab %}
{% tab title="Boolean Tools V1.5" %}
The **Boolean Tool** in BQR allows you to easily manage and organize all boolean modifiers applied to a selected mesh. Once the object is selected, the addon automatically detects all active boolean operations and displays them in a clean, intuitive panel.
Each boolean is tagged with a visual icon to indicate its type:
* âž• **Addition (Union)**
* âž– **Subtraction (Difference)**
* ⚡ **Intersection (Cut)**
{% embed url="" %}
{% hint style="success" %}
**Before applying modifiers, use the Boolean Tool to sort operations from simplest to most complex (e.g. Difference → Union → Intersect).**\
This improves calculation accuracy and helps avoid topological errors during boolean processing, or its good for concepting!
{% endhint %}
{% endtab %}
{% tab title="Deform Tools V1.5" %}
The **Deform Tools** panel introduces non-destructive deformation workflows designed to keep your mesh **boolean-ready** at all times.\
Currently, the available tool is the **Lattice Cage**.
By clicking **Add Lattice Cage**, a lattice is automatically added and bound to the selected mesh, allowing you to deform it in real-time while preserving a clean, quad-based topology suitable for boolean operations.
You can **increase or decrease** the resolution of the cage at any time using the **+** and **–** buttons, giving you finer or broader control over the deformation.
{% embed url="" %}
{% hint style="success" %}
The lattice cage isn't just useful for modeling, it's also ideal for animation.\
By animating the lattice itself, you can create smooth mesh deformations without affecting your modifier stack or boolean structure.
{% endhint %}
{% endtab %}
{% tab title="Displace V1.6" %}
The "Displace" button adds (or removes) a Displace modifier to the selected object. This modifier deforms the mesh by moving its vertices based on a texture, creating bumps or dents on the surface. When you activate the button, a procedural texture (Clouds type) is automatically created and linked to the modifier, ready for customization.
{% embed url="" %}
{% hint style="success" %}
Use the Displace modifier to add organic details or surface irregularities to your mesh without manual modeling. You can achieve different effects by changing the texture or adjusting the modifier’s Strength and Mid Level settings.
{% endhint %}
{% endtab %}
{% endtabs %}
##
## 🛠️ Finalization Parameters
{% tabs %}
{% tab title="Apply Modifiers" %}
Applies all the modifiers added during the RemeshIT process (Remesh, Bevel, Subsurf, etc.), converting them into real geometry.
{% embed url="" %}
{% hint style="success" %}
**Tip:** Use this before exporting or unwrapping to lock in your final mesh. A backup is automatically created in a hidden collection, just in case.
{% endhint %}
{% endtab %}
{% tab title="Opitimize" %}
Adds a *Decimate (Unsubdivide)* modifier to simplify the mesh and reduce unnecessary geometry while preserving the overall shape.
{% embed url="" %}
{% hint style="success" %}
**Tip:** Great for lowering polycount after remeshing. Works best when used after applying modifiers.
{% endhint %}
{% endtab %}
{% tab title="CEL V1.4" %}
Dissolves redundant edge loops that don’t contribute to the shape of the model. It preserves geometry around curves, holes, and corners.
{% embed url="" %}
{% hint style="success" %}
**Tip:** Use this to achieve a cleaner topology for real-time or game assets. The edge dissolve is adaptive and non-destructive.
{% endhint %}
{% endtab %}
{% tab title="UV Unwrap" %}
Automatically unwraps the mesh using Blender’s *Smart UV Project*, preparing the object for texturing.
{% hint style="info" %}
With the introduction (in V1.5) of real-time unwrapping this feature will change.
{% endhint %}
{% embed url="" %}
{% hint style="success" %}
**Tip:** Only use this after applying all modifiers. It creates and activates a default UV map named “UVMap”.
{% endhint %}
{% endtab %}
{% tab title="Reeal Time UV V1.6" %}
The "Add Real-Time UV" button adds (or removes) a Geometry Nodes modifier that applies a tri-planar UV mapping to the selected mesh. This setup automatically generates UV coordinates by projecting them from three axes, which is especially useful for objects without proper UV unwrapping or for quickly testing textures.
{% embed url="" %}
If you wish to export the mesh to graphics engines such as Unreal Engine, Unity, Godot or others, the modifier must be applied.
Tri-planar projection works very well with seamless textures, so it is not mandatory that the UVs be confined within the 0-1 space. However, if you prefer to have UVs packed neatly in that space, you can use the Pack UV button.
Once the modifier is applied, you can freely change the angle and scale of each UV island separately, according to your needs.
{% hint style="success" %}
Use Real-Time UV mapping to instantly preview textures on your model without manual UV unwrapping. This is ideal for hard-surface objects or when you need a fast, seamless texture projection for previews or procedural materials.
{% endhint %}
{% endtab %}
{% endtabs %}