<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/ManipulationComponent/configureEntity(_:hoverEffect:allowedInputTypes:collisionShapes:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation21ManipulationComponentV15configureEntity_11hoverEffect17allowedInputTypes15collisionShapesyAA0F0C_AA05HoverhD0V0nH0VSgAA0j6TargetD0V0J4TypeVSgSayAA13ShapeResourceCGSgtFZ"
  },
  "title" : "configureEntity(_:hoverEffect:allowedInputTypes:collisionShapes:)"
}
-->

# configureEntity(_:hoverEffect:allowedInputTypes:collisionShapes:)

Apply a default configuration to an entity to enable to it for use with manipulation component.

```
static func configureEntity(_ entity: Entity, hoverEffect: HoverEffectComponent.HoverEffect? = nil, allowedInputTypes: InputTargetComponent.InputType? = nil, collisionShapes: [ShapeResource]? = nil)
```

## Parameters

`entity`

The entity to configure.

`hoverEffect`

A replacement for the default `HoverEffect` this method applies.

`allowedInputTypes`

A replacement for the allowed input types this method applies.

`collisionShapes`

A replacement for the deafult collision shape this method
generates based on the entity’s bounding box.

## Discussion

This function applies an [`InputTargetComponent`](/documentation/RealityKit/InputTargetComponent), [`CollisionComponent`](/documentation/RealityKit/CollisionComponent),
and [`HoverEffectComponent`](/documentation/RealityKit/HoverEffectComponent) to an [`Entity`](/documentation/RealityKit/Entity).

Use this method on an entity that already has a mesh asset in a [`ModelComponent`](/documentation/RealityKit/ModelComponent).
The system generates a collision mesh based on the entity’s bounding box
if you don’t set one.
This function will replace any pre-existing components of these types.

---

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)