class

FMeshAssetMeta

Everything authored ON a model that the model file itself cannot hold.

Module
Physics
Header
#include "Physics/MeshCollision.h"
Namespace
Mowo

Properties

TypeNameDescription
static constexpr const char*kRootTypeDefault "MeshMeta".
static constexpr const char*kCollisionTypeDefault "Collision".
static constexpr const char*kPrimitiveTypeDefault "Primitive".
static constexpr const char*kSocketTypeDefault "Socket".
static constexpr const char*kSlotTypeDefault "MaterialSlot".
static constexpr const char*kSurfaceCacheTypeDefault "SurfaceCache".
static constexpr const char*kVirtualBoneTypeDefault "VirtualBone".
static constexpr const char*kClothMaskTypeDefault "ClothMask".
static constexpr const char*kSourceKeyDefault "source".
static constexpr const char*kTargetKeyDefault "target".
static constexpr const char*kSubmeshKeyDefault "submesh".
static constexpr const char*kWeightsKeyDefault "weights".
static constexpr const char*kComplexityKeyDefault "complexity".
static constexpr const char*kShapeKeyDefault "shape".
static constexpr const char*kCenterKeyDefault "center".
static constexpr const char*kRotationKeyDefault "rotation".
static constexpr const char*kHalfExtentsKeyDefault "half_extents".
static constexpr const char*kRadiusKeyDefault "radius".
static constexpr const char*kHalfHeightKeyDefault "half_height".
static constexpr const char*kPointsKeyDefault "points".
static constexpr const char*kBoneKeyDefault "bone".
static constexpr const char*kPositionKeyDefault "position".
static constexpr const char*kScaleKeyDefault "scale".
static constexpr const char*kMaterialKeyDefault "material".
static constexpr const char*kPhysicsAssetKeyDefault "physics_asset".
static constexpr const char*kCardSetModeKeyDefault "card_set_mode".
static constexpr const char*kMaxCardsKeyDefault "max_cards".
static constexpr const char*kDecompositionTypeDefault "Decomposition".
static constexpr const char*kAutoConvexKeyDefault "auto".
static constexpr const char*kMaxHullsKeyDefault "max_hulls".
static constexpr const char*kHullVerticesKeyDefault "hull_vertices".
static constexpr const char*kConcavityKeyDefault "concavity".
static constexpr const char*kMinTrianglesKeyDefault "min_triangles_per_hull".
static constexpr const char*kMaxDepthKeyDefault "max_depth".
static constexpr const char*kMaxTrianglesKeyDefault "max_triangles".
static constexpr uint32_tkDefaultMaxCardsMmodelBuildOptions::maxMeshCards and FMeshCardBuildOptions::MaxCards agree on 8; the ceiling is the .mmodel format's MMODEL_MAX_CARDS_PER_MESH. Both are repeated here rather than included because this header sits below AssetFormats and is read by three modules that cannot link to each other. Default 8.
static constexpr uint32_tkMaxCardsCeilingDefault 32.
EMeshCollisionComplexityComplexityDefault EMeshCollisionComplexity::SimpleAndComplex.
EMeshCardSetModeCardSetModeDefault EMeshCardSetMode::Auto.
uint32_tMaxCardsDefault kDefaultMaxCards.
std::vector<FMeshCollisionPrimitive>Primitives
std::vector<FMeshSocket>Sockets
std::vector<FMeshMaterialSlotBinding>SlotMaterials
std::vector<FMeshVirtualBone>VirtualBones
std::vector<FMeshClothMask>ClothMasks
boolAutoConvexCollisionWhether the collision cook may split a concave mesh into hulls when nobody authored simple collision for it. On by default: the alternative is the single hull that swallows the silhouette, which is a solid block wherever the mesh has a hole. A convex mesh measures convex and stays on the single-hull path either way, so the default costs it nothing. Default true.
FMeshDecompositionSettingsDecomposition
std::stringPhysicsAssetThe .physasset authored against this skeletal mesh. Stored on the mesh so a ragdoll follows the character everywhere it is placed, instead of being re-picked per actor in every level.

Public functions

ReturnsNameDescription
boolIsEmptyAn emptied setup deletes the sidecar, so every authored field has to be named here — a card-set override alone would otherwise be written and then removed by the same Save.
const FMeshVirtualBone*FindVirtualBone
std::stringMakeUniqueVirtualBoneName
const FMeshClothMask*FindClothMask
FMeshClothMask&ClothMaskForThe mask to paint into, created fully free (1) or re-sized to the mesh when the topology it was painted on no longer matches.
voidRemoveClothMask
boolHasDecompositionOverrideWhether anything about the decomposition was moved off its default.
boolHasSimpleCollision
boolHasCardSetOverride
boolBuildsMeshCardsThe two questions both card producers ask — the cook (MmodelBuilder) and the live Assimp import (ModelResource).
uint32_tMeshCardLimit
const FMeshSocket*FindSocket
const std::string&MaterialForSlot
voidSetMaterialForSlot
std::stringMakeUniqueSocketName
std::stringMakeUniquePrimitiveName
std::stringSidecarPathFor<model>.fbx / <model>.fbx.mmodel / <model>.mmodel → <model>.mmeshmeta.
const char*ShapeName
EMeshCollisionShapeShapeFromName
const char*ComplexityName
const char*CardSetModeName
EMeshCardSetModeCardSetModeFromName
EMeshCollisionComplexityComplexityFromName
voidReadRoot
voidWriteRootOnly what was actually authored is written.
std::stringSerializeToString
boolDeserializeFromString
boolLoadFromFile
boolSaveToFile

Function details

IsEmpty

C++
bool IsEmpty() const

An emptied setup deletes the sidecar, so every authored field has to be named here — a card-set override alone would otherwise be written and then removed by the same Save.

FindVirtualBone

C++
const FMeshVirtualBone* FindVirtualBone(const std::string& name) const

MakeUniqueVirtualBoneName

C++
std::string MakeUniqueVirtualBoneName(const std::string& base) const

FindClothMask

C++
const FMeshClothMask* FindClothMask(int32_t submesh) const

ClothMaskFor

C++
FMeshClothMask& ClothMaskFor(int32_t submesh, size_t vertexCount)

The mask to paint into, created fully free (1) or re-sized to the mesh when the topology it was painted on no longer matches.

RemoveClothMask

C++
void RemoveClothMask(int32_t submesh)

HasDecompositionOverride

C++
bool HasDecompositionOverride() const

Whether anything about the decomposition was moved off its default. The sidecar is deleted when the setup is empty, so a mesh whose only authored thing is a hull budget has to count as authored or the Save that wrote it would remove it again.

HasSimpleCollision

C++
bool HasSimpleCollision() const

HasCardSetOverride

C++
bool HasCardSetOverride() const

BuildsMeshCards

C++
bool BuildsMeshCards() const

The two questions both card producers ask — the cook (MmodelBuilder) and the live Assimp import (ModelResource). They are here rather than in each producer because a mesh that clustered at cook and not on import lights differently in the editor than in the packaged build, with nothing failing.

MeshCardLimit

C++
uint32_t MeshCardLimit(uint32_t fallback) const

FindSocket

C++
const FMeshSocket* FindSocket(const std::string& name) const

MaterialForSlot

C++
const std::string& MaterialForSlot(const std::string& slot) const

SetMaterialForSlot

C++
void SetMaterialForSlot(const std::string& slot, const std::string& material)

MakeUniqueSocketName

C++
std::string MakeUniqueSocketName(const std::string& base) const

MakeUniquePrimitiveName

C++
std::string MakeUniquePrimitiveName(const std::string& base) const

SidecarPathFor

C++
static std::string SidecarPathFor(const std::string& modelPath)

<model>.fbx / <model>.fbx.mmodel / <model>.mmodel → <model>.mmeshmeta. The cooked container appends .mmodel to the source name, so both spellings have to collapse onto one sidecar or the editor would author against the source and the runtime would read nothing.

ShapeName

C++
static const char* ShapeName(EMeshCollisionShape shape)

ShapeFromName

C++
static EMeshCollisionShape ShapeFromName(const std::string& name)

ComplexityName

C++
static const char* ComplexityName(EMeshCollisionComplexity complexity)

CardSetModeName

C++
static const char* CardSetModeName(EMeshCardSetMode mode)

CardSetModeFromName

C++
static EMeshCardSetMode CardSetModeFromName(const std::string& name)

ComplexityFromName

C++
static EMeshCollisionComplexity ComplexityFromName(const std::string& name)

ReadRoot

C++
void ReadRoot(const MDF::MdfNode& root)

WriteRoot

C++
void WriteRoot(MDF::MdfNode& root) const

Only what was actually authored is written. An empty Collision node in every sidecar would make the diff of one stop saying what changed, which is the whole reason the animation sidecar writes deltas too.

SerializeToString

C++
std::string SerializeToString() const

DeserializeFromString

C++
static bool DeserializeFromString(const std::string& text, FMeshAssetMeta& out)

LoadFromFile

C++
static bool LoadFromFile(FMeshAssetMeta& out, const std::string& path)

SaveToFile

C++
bool SaveToFile(const std::string& path) const
Generated from Physics/MeshCollision.h via physics.json · Nov 4, 2026Version 1.0.0