Show / Hide Table of Contents

    Collision Data

    Collision Data

    Collision Data asset contains a baked mesh collision data used at runtime by the Mesh Colliders. It supports convex meshes and triangle meshes data.

    Create a collision data

    To create a new collision data asset use the Content window. Right-click in the Content directory and select option New -> Collision Data. Then specify the name and press Enter to confirm.

    New Collision Data

    Now open the asset (double-click on it) and assign the model to use for a collider shape (set the Model property). Then press Cook button.

    Collision Data

    Properties

    Property Description
    Type Collision data type.
    Model Source model used to generate the collision mesh. Used are all the meshes from the selected LOD.
    Model LOD Index Source model LOD index.
    Convex Flags The convex mesh generation flags. See ConvexMeshGenerationFlags to learn more.
    Vertex Limit The convex mesh vertex limit. Use values in range [8;255].

    Create collision data from code

    Flax supports creating most of the asset types in Editor using C# scripts (with editor plugins). The same applies to the collision data asset. Here is an example code that bakes the asset:

    var path = "Content/MyModel";
    var model = Content.LoadAsync<Model>(path);
    FlaxEditor.Editor.CookMeshCollision(path + "_Collision", CollisionDataType.ConvexMesh, model);
    
    Tip

    When invoking the collision data cooking, please ensure to invoke it on a separate thread or via async job to not block the game thread.

    If your game generates the geometry at runtime and you need to use collision for virtual models then you can enable physics settings option Support Cooking At Runtime (see Physics Settings) and use the following code to create a virtual collision data asset:

    var collisionData = Content.CreateVirtualAsset<CollisionData>();
    collisionData.CookCollision(CollisionDataType.TriangleMesh, myModel);
    
    • Improve this Doc
    Back to top Copyright © 2012-2021 Wojciech Figat