Skip to documentation

Your complete collider workflow solution in Unity.

Build high quality collider sets in seconds, right inside Unity.

Every game needs colliders. Creating them shouldn’t mean spending hours placing primitives by hand or switching between Unity and Blender to create simplified collider proxies. Collidify gives you a complete, streamlined workflow for turning static and skinned meshes into high quality collider sets in seconds. Choose the collider type you need: Box, Capsule, Sphere, or Convex Mesh. Let Collidify handle the rest. Inspect the generated result, refine only where needed, then exit to bake your colliders. Fast, flexible, and accurate in one workflow.

Requirements and preparation

Install Collidify in your Unity project through the package manager, then work in the Scene view.

Collidify has been tested on the following desktop platforms:

PlatformSupported configuration
WindowsWindows 10 or 11
macOSmacOS 13 or later, on Apple Silicon and Intel Macs
LinuxUbuntu 20 or later with Vulkan

Collidify has been tested on the following Unity versions and render pipelines.

Unity versionBuilt-inURPHDRP
2022.3.62f3CompatibleCompatibleCompatible
6000.3.8f1CompatibleCompatibleCompatible
6000.6.0f1CompatibleCompatibleCompatible

Mesh Requirements

Collidify includes a robust repair pipeline and can work with non-manifold assets, but a clean, manifold input is still recommended for the most predictable results.

Quick start: your first collider set

  1. Select a prop or multiple props. Double-tap Tab to enter Design Mode or click the Collidify launcher chip.
Quick start step 1
  1. Choose a starting collider type and Run Auto Generate (default shortcut Z).
Quick start step 2
  1. Double-tap Tab again to exit, and Collidify will bake the preview into real colliders.
Quick start step 3

Auto Generate

Auto Generate analyzes the selected mesh and automatically decomposes it into a collider set. It can create boxes, capsules, spheres, convex mesh pieces, or a mix of those types.

Auto Generate does not select collider types for you during decomposition. You remain in control of which collider types are allowed and can choose which ones Auto Generate may use in the resulting collider set.

The algorithm is designed to run very quickly, even on lower end hardware. For this reason, it is recommended to start with the highest quality preset (High) and only lower the quality if generation takes too long.

Custom Settings

For faster or more accurate decomposition beyond the default presets, set the Quality Preset to Custom and adjust the following settings, listed in order of impact:

  1. Cut Candidates
  2. Refine Cut Planes
  3. Hull Samples
  4. Samples

Higher values generally produce better results, but will increase processing time.

Adaptive Sampling should typically remain enabled.

You can also set your preferred quality preset in Launcher Settings. This preset will be applied automatically to new models when you enter Design Mode, so you won’t need to configure the same settings each time.

Auto Generate custom settings

Refine a generated result

Merge Colliders

Select the parts that should become one, then choose Merge Colliders (X). Merging reduces collider count, but can make the result less accurate.

Merge Colliders tool

Auto Merge

Use Auto Merge (C) to automatically combine neighboring parts when the merged result stays within the configured tolerance. Lower tolerance keeps more fidelity while higher tolerance favors fewer colliders.

Auto Merge tool
The original setup has 125 colliders.Auto Merge reduces the setup to 77 colliders, a 38% decrease with minimal accuracy impact.

Manual Split

Manual Split works on multiple parts as long as they are part of the same object. Start it, drag across the mesh to establish a split, then review the preview before applying or discarding it. Use its plane placement, rotation, local/global orientation, snapping (holding shift), and grouped versus separate all cutting controls to place the cut intentionally. Manual Split uses Unity’s global position and rotation snap increments for its position and rotation snapping. Apply its preview with V. Use B to toggle the Manual Cut Mode.

Manual Split tool
Group Split mode always splits two parts based on where the user starts the split, while merging the other floating pieces together.Separate All mode does not merge the floating pieces, it keeps each one separated as its own part.

Cancel the split preview or exit Manual Split without applying it whenever the cut is not useful. For hollow meshes that generate inefficiently, split the object into meaningful sections first, then generate or refine those sections. This gives the automatic process smaller, clearer regions to approximate.

Convert Colliders

Select one or more generated parts, then choose a collider type from the Scene view toolbar to convert them. Conversion replaces only the selected parts, so you can combine Mesh, Box, Capsule, and Sphere colliders in the same setup while refining each area with the shape that fits it best.

Converting selected colliders

Reset Design

Use Reset Design (R) to return the active design to the original source mesh state. Reset instead of repeatedly forcing an unsuitable decomposition into a workflow it does not fit.

Reset Design tool

Bake the preview to the scene

Exit Design Mode by double-tapping Tab. Collidify converts preview parts into ordinary Unity collider components and creates or updates the generated hierarchy. Generated collider children are kept inspectable beneath the generated container. For character workflows, collider children are parented under their corresponding bones.

If the mesh copy option is enabled, results are applied to all detected mesh copies.

Collidify identifies existing hand authored colliders as separate from its generated output, so they are preserved when you work on a design.

You can modify any of the collider’s settings, and when re-entering and exiting Design Mode those settings will persist.

Baking the preview to the scene

Choosing a Collider Type

As a general rule, start with Mesh before running Auto Generate. Mesh generation is the most flexible and often produces the best initial results. You can then convert the generated colliders to your desired types afterward.

However, this is only a starting point, not a strict rule. Depending on the model and the number or shape of colliders you need, generating directly as Boxes, Capsules, or Spheres may produce better results. Generation is type specific, so the same model can produce significantly different collider sets depending on the selected type.

If the initial result isn’t suitable, try generating with a different collider type. You can quickly undo and experiment with different types and settings until you find a good generation.

Box auto generation compared with mesh converted to box
Native Box generation uses 16 colliders and produces a slightly messier result.Converting the mesh to Box first, then refining the seat with an additional auto generation pass to split it into two colliders, produces a cleaner result with just 12 colliders and only a 1% reduction in accuracy.
Native box generation compared with mesh converted to box
Initial mesh generation, followed by Mesh to Box conversion and auto generation, achieves 97% accuracy using 87 colliders.Native Box auto generation achieves the same 97% accuracy but with only 56 tightly rotated colliders being an example where native Box generation is more efficient.

Build colliders for skinned characters

Select the character object with a SkinnedMeshRenderer, and the system will automatically use its dedicated Rig Decomposition mode. It will create colliders around weighted bone regions so the baked result can follow the rig where suitable. You can also disable Rig Decomposition, and Collidify will use its default decomposition algorithm.

When in Manual Split mode for rigs, you can click a bone’s joint to snap the splitting plane’s position and orientation directly to it, making it easier to create accurate splits along the rig.

Splitting plane at a bone joint
The white diamonds indicate the bone joints.

Shortcuts and interface reference

ActionDefault shortcut
Enter / exit Design ModeDouble-tap Tab
Auto GenerateZ
Merge CollidersX
Auto MergeC
Reset DesignR
Toggle Manual Split / apply previewV
Toggle Manual Cut ModeB
Select all / deselect allCtrl/Cmd + A / Ctrl/Cmd + Shift + A
Invert selectionCtrl/Cmd + I
Show / hide Rotation ControlsShift + H

You can find most of the shortcuts beside the tool's name.

Interpreting the Dashboard

Worst Fit

Fit measures how closely a collider matches its assigned region of the source mesh. Lower values indicate a better fit.

Worst Fit shows the highest (worst) fit value across all generated parts/colliders.

Click this metric to have Collidify automatically select the part with the worst fit.

Accuracy

Accuracy is an approximate score representing how closely all generated parts/colliders match the source mesh overall.

A higher accuracy score indicates that the generated colliders more closely fit the original mesh.

Physics Cost

Physics Cost is a heuristic estimate based on how PhysX, Unity’s default physics engine, handles colliders. It is not an exact prediction of frame time, but it provides a useful way to compare collider setups and identify potential optimization opportunities.

While mesh colliders are generally more expensive than primitive colliders, using multiple primitive colliders can be more expensive than using a single mesh collider. This can vary depending on the complexity of the mesh collider.

If physics performance is important, try different collider configurations and compare their Physics Cost values to determine which setup is likely to be more efficient.

Click this metric to have Collidify automatically select the most expensive part.

General performance guidelines:

  • A single collider is generally faster than multiple colliders, regardless of collider type.
  • For individual collider types, the typical performance order from slowest to fastest is: Mesh → Box → Capsule → Sphere.
Collidify dashboard
The 66 mesh collider set has a higher physics cost because the detailed octopus mesh makes each collider expensive.The 125 box collider set is more performant because multiple cheaper colliders can outperform fewer expensive mesh colliders, a counterintuitive result that accurately reflects the true physics cost.

The Mesh collider button also includes a slider to simplify the mesh and reduce its physics cost.

Repair Types

  • Automatic starts with the least destructive usable option. It tries Solidify, then Core, and finally Full only when the preceding option does not produce a manifold mesh.
  • Solidify gives an open, thin surface thickness by creating front and back surfaces and closing its boundary edges. It is useful for sheets, planes, and other surface-like meshes that should behave as a volume.
  • Core is the fast, conservative repair path. It repairs components independently, welding crack seams, correcting face orientation, filling holes, and attempting to close any remaining non-manifold surface while preserving the source surface where possible. Use it when a normal mesh cleanup is needed without the more invasive steps in Full.
  • Full includes the Core path, then adds topology repair, self-intersection resolution, and additional whole-mesh closing fallbacks when needed. Use it for difficult non-manifold meshes, intersecting surfaces, or meshes that Core cannot close. It is slower and can retriangulate or change the mesh.

Troubleshooting

Colliders are being generated in empty spaces

If colliders are being generated in empty areas of the mesh even with a high Max Colliders value and running Auto Generate on the affected part does not resolve the issue:

  1. Open Manual Split to inspect the source mesh.
  2. Check whether the empty gap has been incorrectly filled in.
  3. If the gap is filled, the source mesh is likely non-manifold, and the selected repair method was unable to repair it correctly.
  4. Try each available Repair Type to see whether one produces the correct result.

If none of the repair types resolve the issue, you have two options:

  1. Repair the source mesh externally: Open the model in a 3D modeling application and fix the mesh so that it is manifold, then import it again and retry. You can also use dedicated mesh-repair libraries and tools such as: Pamo, MeshLib, and ManifoldPlus.
  2. Disable mesh repair: Set Repair Type to None. Collidify will then use its fallback mode. This mode is slower and may produce less accurate results, but it can avoid issues caused by unsuccessful mesh repair.

Why does my work sometimes disappear when I re-enter Design Mode?

Check whether Cache Cap is enabled and whether your cache usage is close to or at the configured limit.

When the cache reaches its cap, the last modified design may be removed to keep storage usage within the specified limit.

To prevent this, you can either:

  • Disable the Cache Cap
  • Increase the cache limit.

Found a Bug?

If you encounter a bug or unexpected behavior while using Collidify, please report it by emailing BitwiseGames@tuta.com.

To help me reproduce, diagnose, and resolve the issue as quickly as possible, please include the following information where applicable:

  • A copy of the model where the issue occurred
  • The Collidify settings you were using
  • Your Collidify version, Unity version, and operating system
  • A brief description of the issue
  • Steps to reproduce the issue, if known

The more information you can provide, the easier it will be to identify the cause, find a solution, and follow up with you if additional details are needed.

Glossary

TermMeaning
Design ModeThe temporary Scene view workspace for designing colliders.
DesignA previewed collider set in Design Mode.
PartA previewed collider in Design Mode.
Collider typeThe shape used by a part: Mesh, Box, Capsule, or Sphere.
Concavity / toleranceControls how closely a generated or merged shape follows the source; lower tolerance generally preserves more detail.
Cut CandidatesThe number of potential cutting/splitting areas evaluated during generation.
Launcher SettingsThe settings that establish defaults for new designs, including quality preset.
Cache CapA limit on storage reserved for saved designs; old designs may be removed when the cap is reached.
BakeWrites the designed preview as Unity collider components and generated hierarchy.
Mesh copyAn option that applies the result to all detected copies of the same mesh.
FitHow closely a collider matches its assigned region of the source mesh. Lower values indicate a better fit.