1. Installation
  2. Other Addons
  3. Terminology
  4. Using MESHmachine
  5. Reporting Errors or Problems


How is it done?

See the Installation guide and note the version requirement.

Something went wrong! Where can I report errors?

Only via email, here

Other Addons

Are DECALmachine and MACHIN3tools required?

No, MESHmachine provides modeling tools that work on the mesh level. It does not depend on any other addon to do so.
MESHmachine is a mesh modeling toolset, while DECALmachine is a detailing toolset, using mesh decals.

MACHIN3tools is a free addon collection, covering a variety of tasks simple, common blender task, including but not exclusively related to modeling. MACHin3tools is a bit outdated by now, and represents my first steps in addon development. I still use it's various tools heavily and will completetly overhaul MACHin3tools for Blender 2.80.

Is HardOps or BoxCutter required?

HardOps and BoxCutter are not developed by myself and they are not required to use MESHmachine.
They can complement each other however, and I personally do use both of them.


What is a chamfer? What is a fillet? What is a bevel?

A chamfer is a transitional surface between 2 other surfaces, often - but not necessiarily - at a 45 degree angle. It's also referred to as a flat bevel.
In blender it can be created using the Bevel tool and modifier, if the segments are set to 1 and with the Bridge tool if the number of cuts is set to 0.
A chamfer has a flat profile.

Similarly, a fillet is a transitional surface, with a curved profile. It's also referred to as a rounded bevel. In blender it can be created using the Bevel tool and modifier, if the segments are set to higher than 1 and with the Bridge tool if the number of cuts is set to above 0.
A fillet has a round profile.

Both are used to refine and replace hard edges.

FAQChamferandBevel this chamfer has 2 micro bevels of its own!

And so in the context of MESHmachine, I think it makes sense to differentiate between fillet and bevel.
Bevel is a tool to create a fillet from a hard edge. And with MESHmachine's fuse tool, you can now also create a fillet from a chamfer. The chamfer itself, can of course also be created by the bevel tool or by using MESHmachine's Chamfer tool, although the later is specifically made for post-boolean chamfers.

What are rail and sweep edges?

Rail edges are edges or edgeloops going along a bevel or chamfer. Sweep edges are edges going across.

FAQChamferRailandSweeps chamfers have only 2 sets of rails

FAQBevelRailandSweeps while bevels can have many rails

Rail edges are great to loop select across a chamfer or bevel, while sweep edges can be used to loop select along a chamfer or bevel.

Loop Selections

Loop selections are done - by default via Alt + Select Mouse, while pointing at an edge.

What are triangular and quad bevel corners?

A triangular bevel corner is one, that has three corner vertices.
Similarly a quad corner is one, that has four corner verts.

TriangularBevelCorners a triangular bevel corner can be a single triangle, can include a single triangle in its center or may not contain a triangle at all

Triangular Bevel Corners

Triangular bevel corners split the flow of a bevel/fillet in 2 directions.
This is undesired and tools like Unfuse, Refuse and Unbevel, will not work with these kinds of corners.

Is this non-destructive modeling?

It's not non-destructive, no.

With MESHmachine you work directly on the mesh level. There's no continuous construction history as in CAD modeler and there's aren't stacks of modifiers either. Mesh manipulation is permanent.
What MESHmachine's chamfer and fillet toolset does, is reconstruct geometry, which is imperfect, but often good enough.
And so, I'd call it pseudo-non-destructive, or better reconstructive.

Using MESHmachine

Where can I discuss the MESHmachine workflow?

I'd invite you to discuss all things MESHmachine (except errors and tool misbehaviors) in the blenderartists and polycount threads.

Can I use this with subdivision surfaces? Are plugs compatible with sub-d's?

Subdivision Surface modeling is generally understood as working on a low to mid poly model, and adding a live sub-d modfier on top, which produces a higher density, smoother mesh. While I think some of MESHmachine's tools can be helpful in this context, it's not really aimed at that.

You will likely have to manually remove ngons and avoid triangles due to the tight topology constraints of the sub-d workflow.

For me personally, sub-d's only play a role, if a sculptural surfacing is an important part of the form language. And in that case I will use it to generate the main forms, but then fatten the modifier stack.
In that scenario you can then abolutely use plugs on top of the mesh, but you loose the flexibily of sub-d modeling.

What you can't do is use plugs on the low or mid poly model while keeping the sub-d modifier live. This is asking for trouble.

So, if you use sub-d's as a finishing tool, MESHmachine is not your best choice. If you only use it for form generation initialy and are willing to apply the subsurf modifier, MESHmachine can be useful.

Why is the ... tool greyed out in the MESHmachine menu?

Every time you open the MESHmachine menu, each tool listed will check if certain conditions are met, before becoming available.
This is to avoid having to deal with illegal selections a tool can't properly process.

Refer to the individual tool pages here in the docs, for details on what tool expects what kind of selection.


These conditions are intentionally very simple and just because, a tool is no longer greyed out does not mean it will execute properly.

Illegal selections may still be present and you will receive feedback, if that's the case. FAQIllegalSelection

Reporting Errors or Problems


Note the Requirements in the installation guide.
Make sure you are using the latest version.
Confirm you've followed the installation instructions.


If you are seeing an error, please send me a screenshot of the error message.
Even better, send a screenshot of the terminal/system console, which you can turn on under Windows by clicking 'Toggle System Console'.

I do not need an image of blenders info view and I don't need to see blender's python console.

Keep in mind

Send the screenshot, attach it to the email, don't link to an image on some obscure image hoster.
Alternatively you can also just copy and paste the error message directly from the terminal into the email!

If the error only occurs on a certain model, please attach the blend file as well.
Feel free to remove any part of the model that doesn't contrinbute to the problem to keep the file size small.

Tool misbehaviors

If you think a tool of MESHmachine doesn't do what it should do on your model, please send me the blend file.
Please remove any part of the model that doesn't contribute to the problem to keep the file size small.

General information I need to help you:

Please provide the following:

  1. system-info.txt open Blender's Help menu, choose Save System Info, attach file to email
  2. Proof of Purchase
  3. in case of error: terminal/console output or screenshot (see above)
  4. if you know: Blender version
  5. if you know: MESHmachine version

Keep in mind

If your mail is missing the specific error message or the first two items of the list entries above, don't expect a speedy reply.

Use eMail, not twitter, not facebook, not youtube, not artstation, not blender market, and not the blenderartists or polycount threads for reporting of errors.