<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/ForceEffectBase",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation15ForceEffectBaseP"
  },
  "title" : "ForceEffectBase"
}
-->

# ForceEffectBase

The base protocol for the wrapping force effect structure containing
common parameters for all force-effects.

```
protocol ForceEffectBase
```

## Overview

Don’t implement this protocol yourself. Create force effects by calling methods on [`ForceEffect`](/documentation/RealityKit/ForceEffect).

## Topics

### Associated Types

[`associatedtype ForceEffectType : ForceEffectProtocol`](/documentation/RealityKit/ForceEffectBase/ForceEffectType)

A type that represents the kind of force effect.

### Instance Properties

[`var effect: Self.ForceEffectType`](/documentation/RealityKit/ForceEffectBase/effect)

Custom force effect parameters.

[`var mask: CollisionGroup`](/documentation/RealityKit/ForceEffectBase/mask)

Controls which collision groups will be affected by this force effect.

[`var orientation: simd_quatf`](/documentation/RealityKit/ForceEffectBase/orientation)

Rotation of the force effect relative to the effect’s transform component.

[`var position: SIMD3<Float>`](/documentation/RealityKit/ForceEffectBase/position)

Position of the force effect relative to the effect’s transform component.

[`var spatialFalloff: SpatialForceFalloff?`](/documentation/RealityKit/ForceEffectBase/spatialFalloff)

Optional strength falloff based on the spatial bounds of the effect.

[`var strengthScale: Float`](/documentation/RealityKit/ForceEffectBase/strengthScale)

A multiplier that scales the strength of the effect.

[`var timedFalloff: TimedForceFalloff?`](/documentation/RealityKit/ForceEffectBase/timedFalloff)

Optional strength falloff based on the duration of the effect.

## Relationships

### Conforming Types

[`ForceEffect`](/documentation/RealityKit/ForceEffect)

---

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)