Static Meshes

Turn Nanite on or off and set Nanite settings, then rebuild and report whether Nanite data was built

Reads the mesh's FMeshNaniteSettings, applies --properties by reflection (field names are this engine's own: KeepPercentTriangles, FallbackPercentTriangles, FallbackRelativeError, PositionPrecision, ShapePreservation on 5.7+, bPreserveArea on 5.6...), sets --enabled if given, and rebuilds the mesh through the Static Mesh Editor subsystem. The reply's nanite.has_data says whether the build produced Nanite data. Undoable.

cfa set_static_mesh_nanite --mesh-path /Game/Props/SM_Rock --enabled
cfa set_static_mesh_nanite --mesh-path /Game/Props/SM_Rock --properties '{"KeepPercentTriangles":0.5}'

Generate LODs by triangle fraction or count, set screen sizes, or switch automatic screen size

--percent-triangles [0.5,0.25] regenerates LOD1.. at those triangle fractions (LOD0 stays full), as Epic's generate_lods does. --lod-count 4 makes 4 LODs in total, each half the triangles of the last. --screen-sizes [1,0.5,0.25] (one per LOD, strictly descending, else refused) turns automatic screen size off; given alone it only changes the screen sizes. Reply: triangles, vertices and screen size per LOD. Undoable.

cfa set_static_mesh_lods --mesh-path /Game/Props/SM_Rock --lod-count 4
cfa set_static_mesh_lods --mesh-path /Game/Props/SM_Rock --percent-triangles '[0.5,0.2]' --screen-sizes '[1,0.4,0.1]'

Remove every LOD except LOD0

cfa remove_static_mesh_lods --mesh-path /Game/Props/SM_Rock

Add simple collision (box, sphere, capsule, NDOP, convex), remove it, or set collision complexity

--shape is the engine's EScriptCollisionShapeType (box, sphere, capsule, ndop10_x, ndop10_y, ndop10_z, ndop18, ndop26), convex (convex decomposition with --hull-count, --max-hull-vertices, --hull-precision; Epic's defaults 4/16/100000), or none. --replace (default true) removes the existing simple collision first; --replace=false adds to it. --complexity is the engine's ECollisionTraceFlag: default, simple_and_complex, simple_as_complex, complex_as_simple. Reply: element counts by shape and the complexity. Undoable.

cfa set_static_mesh_collision --mesh-path /Game/Props/SM_Crate --shape box
cfa set_static_mesh_collision --mesh-path /Game/Props/SM_Rock --shape convex --hull-count 8
cfa set_static_mesh_collision --mesh-path /Game/Props/SM_Floor --complexity complex_as_simple

Add a socket to a static mesh with location, rotation, scale and tag

Done the way the Static Mesh Editor's Socket Manager does it, so it is undoable. --properties takes UStaticMeshSocket fields by reflection: RelativeLocation, RelativeRotation, RelativeScale, Tag. List sockets with get_mesh_info.

cfa add_static_mesh_socket --mesh-path /Game/Weapons/SM_Rifle --socket-name Muzzle --properties '{"RelativeLocation":{"X":60,"Y":0,"Z":8}}'

Rename or move a static mesh socket, or change its scale or tag

cfa set_static_mesh_socket --mesh-path /Game/Weapons/SM_Rifle --socket-name Muzzle --new-name Barrel --properties '{"RelativeLocation":{"X":64}}'

Remove a socket from a static mesh

cfa remove_static_mesh_socket --mesh-path /Game/Weapons/SM_Rifle --socket-name Barrel

Merge Static Mesh Actors into one new static mesh asset (the editor's Merge Actors tool)

Uses the engine's own merge (UStaticMeshEditorSubsystem::MergeStaticMeshActors). Only Static Mesh Actors with a mesh can be merged. The engine names a merged mesh SM_<name>: /Game/Merged/SM_Houses lands exactly there, /Game/Merged/Houses becomes SM_Houses. The new asset is never written over an existing one. The merged actor is placed by default (--spawn-merged-actor=false to skip); the source actors are kept unless --destroy-source-actors. --properties takes FMeshMergingSettings fields by reflection, e.g. {"bMergeMaterials":true}. Creating the asset cannot be undone, like the editor's own Merge Actors.

cfa merge_static_mesh_actors --actors House_1,House_2,House_3 --asset-path /Game/Merged/SM_Houses

Verdict for a static mesh: engine data validation, Nanite, materials, LODs, lightmaps, collision

Returns verdict = pass | pass_with_warnings | fail plus findings (code, severity, target, message). Errors (fail): engine_data_invalid, zero_triangles, nanite_no_data, section_bad_material_index, no_collision. Warnings: nanite_material_unsupported (the engine then draws the mesh without Nanite), material_slot_empty, lod_not_reduced (a CFA rule), lod_screen_sizes_not_descending, lightmap_index_invalid, lightmap_uvs_missing, lightmap_uvs_bad (only with --check-lightmap-uvs, slow on big meshes), complex_as_simple. Info: material_slot_unused. counts_by_code is always complete; only the findings list is capped.

cfa validate_static_mesh /Game/Props/SM_Rock
cfa validate_static_mesh /Game/Props/SM_Rock --check-lightmap-uvs