<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/ClothSimulationComponent/maximumStepsPerUpdate-swift.property",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:22RealityFoundationCloth0C19SimulationComponentV21maximumStepsPerUpdateAC07MaximumghI0Vvp"
  },
  "title" : "maximumStepsPerUpdate"
}
-->

# maximumStepsPerUpdate

The maximum number of time steps that the simulation can advance each update.

```
var maximumStepsPerUpdate: ClothSimulationComponent.MaximumStepsPerUpdate
```

## Discussion

A higher number of time steps per update is more expensive in terms of power and performance.
However, a lower number restricts the simulation’s ability to keep up with the [`targetClock`](/documentation/RealityKit/ClothSimulationComponent/targetClock).

As an example, if [`timeStep`](/documentation/RealityKit/ClothSimulationComponent/timeStep) is `1.4 ms` and [`maximumStepsPerUpdate`](/documentation/RealityKit/ClothSimulationComponent/maximumStepsPerUpdate-swift.property) is `13`, then the simulation can perfectly follow [`targetClock`](/documentation/RealityKit/ClothSimulationComponent/targetClock) up to delta times of `1.4 ms * 13 = 18.2 ms`.

The automatic value differs based on the target platform.
Must be a positive number.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)