Auto Convex Shape

Warning

Auto Convex is currently only supported for Windows

Auto Convex is a tool for generating convex colliders for complex meshes. It's especially useful for organic shapes like rocks, statues, and debris. While it's not a one-click solution for every asset, it’s a powerful tool for organic models.

SimpleBranding08.jpg

Basic Parameters

Control the number of convex hulls and their complexity through these settings, which appear in a popup when you activate Auto Convex:

Parameter Description Default Range
Shrinkwrap Shrinkwrap output to source mesh False False/True
Hulls Maximum number of output convex hulls 8 1-4096
Verts per Piece Maximum vertices in the output convex hull 16 8-1024
Voxel Resolution Total number of voxels used 100,000 100,000-10,000,000

img

These parameters are from the original library used: V-HACD on GitHub.

img

Advanced Parameters

Advanced parameters can be found in the addon preferences under Auto Convex. Access preferences directly by pressing the gear button next to "Auto Convex."

img

  • Overwrite Executable: Specify a custom V-HACD executable path if needed.
  • Temporary Data Path: Set a path to store temporary files like meshes and logs used by V-HACD during collider generation.

Additional advanced settings:

Parameter Description Default Range
Volume Error Percentage Allowed volume error percentage. Default is 1%. 0.01 0.001-10
Min Voxel Edge Size Minimum voxel edge size. 2.0 1.0-32.0
Max Recursion Depth Maximum recursion depth, determining the maximum number of convex hulls (e.g., depth of 12 results in up to 4,096 hulls). 4 2-64
Fill Mode Method used to find interior voxels for auto convex creation (Raycast, Flood, Surface). Raycast Raycast/Flood/Surface
Optimal Split Plane If true, finds the optimal split plane location. Otherwise, splits hulls in the middle. False True/False

These parameters also come from the V-HACD library.

For detailed documentation on the library, refer to the Voxelized Hierarchical Convex Decomposition - V-HACD version 4.

Fix Linux Permission

VHACD requires execute permissions to enable Auto Convex collision generation in Blender.

Symptoms of Missing Permissions - A red input field for the Default VHACD Build in Simple Collider preferences. - An info panel warning when attempting to use Auto Convex in your scene.

  1. Locate the VHACD Executable
  2. Navigate to: Edit > Preferences > Add-ons > Simple Collider.
  3. Click "Open Folder" to go directly to the executable (vhacd_4_1_linux_amd64).

alt text

  1. Set Execute Permissions
  2. Right-click the executable and select Properties.

alt text

  • Go to the Permissions tab.
  • Enable Allow executing file as program.

alt text

  1. Verify the Fix
  2. The red input field in preferences will disappear.
  3. Auto Convex collision generation will now work.

Note: This process is specific to Linux Mint and similar distributions. If you encounter further issues, ensure the executable path is correctly referenced in Simple Collider settings.