---
title: "teleportCharacter(to:relativeTo:)"
framework: realitykit
role: symbol
role_heading: Instance Method
path: "realitykit/entity/teleportcharacter(to:relativeto:)"
---

# teleportCharacter(to:relativeTo:)

Moves the character instantly to a new position.

## Declaration

```swift
@MainActor @preconcurrency func teleportCharacter(to position: SIMD3<Float>, relativeTo referenceEntity: Entity?)
```

## Parameters

- `position`: The position to move the character to, relative to referenceEntity.
- `referenceEntity`: The entity that defines a frame of reference. Set this to nil to indicate world space.

## Discussion

Discussion This method moves the character to a location specified relative to another entity. Pass nil in relativeTo to specify a position in world coordinates. A teleport move happens instantly. RealityKit does no collision checking when it moves the entity.

## See Also

### Animating and controlling characters

- [characterController](realitykit/entity/charactercontroller.md)
- [characterControllerState](realitykit/entity/charactercontrollerstate.md)
- [moveCharacter(by:deltaTime:relativeTo:collisionHandler:)](realitykit/entity/movecharacter(by:deltatime:relativeto:collisionhandler:).md)