remove_physics_asset_constraint
Remove a ragdoll constraint (joint) from a UPhysicsAsset by name or index. Deletes an existing joint; absent constraints return already_absent without saving.
Instructions
Remove a ragdoll constraint (joint) from a UPhysicsAsset — the inverse of add_physics_asset_constraint. Resolves the joint by constraint_name (preferred) or constraint_index and deletes it via FPhysicsAssetUtils::DestroyConstraint (the same ConstraintSetup.RemoveAt the PhAT editor runs). Idempotent: an already-absent constraint returns removed:false/already_absent:true with success (no mutation, no save).
Returns: { physics_asset_path: string, constraint_name: string, constraint_index: int, child_bone: string, parent_bone: string, removed: bool, already_absent: bool, constraint_count: int, saved: bool, save_error?: string }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| constraint_name | No | Optional joint name (JointName) of the constraint to remove; preferred over constraint_index when both are given (see get_physics_asset_info). | |
| constraint_index | No | Optional constraint index to remove (used when constraint_name is absent). | |
| physics_asset_path | Yes | /Game path to the UPhysicsAsset to remove the constraint from. |