---
title: "resetPhysicsTransform(recursive:)"
framework: realitykit
role: symbol
role_heading: Instance Method
path: "realitykit/hasphysicsbody/resetphysicstransform(recursive:)"
---

# resetPhysicsTransform(recursive:)

Resets the position, orientation, and velocities of the simulated physics body.

## Declaration

```swift
@MainActor @preconcurrency func resetPhysicsTransform(recursive: Bool = true)
```

## Parameters

- `recursive`: Apply the reset to all descendant entities.

## Discussion

Discussion Call this method only for dynamic rigid bodies, with a mode of PhysicsBodyMode.dynamic. This is the only kind of body that’s affected by physics simulations. For all others, modify the entity’s transform property directly. Conversely, directly modifying the transform of a dynamic body has no effect because the physics simulation overwrites it on every frame.

## See Also

### Resetting physics simulations

- [resetPhysicsTransform(_:recursive:)](realitykit/hasphysicsbody/resetphysicstransform(_:recursive:).md)