---
title: CharacterControllerStateComponent
framework: realitykit
role: symbol
role_heading: Structure
path: realitykit/charactercontrollerstatecomponent
---

# CharacterControllerStateComponent

A component that represents the state of a character controller.

## Declaration

```swift
struct CharacterControllerStateComponent
```

## Overview

Overview RealityKit adds this component to an entity when you add a CharacterControllerComponent instance to it. Manually adding this component to an entity that has a character controller component has no effect because it’s redundant.

## Topics

### Creating a state component

- [init()](realitykit/charactercontrollerstatecomponent/init().md)

### Accessing character controller state

- [isOnGround](realitykit/charactercontrollerstatecomponent/isonground.md)
- [velocity](realitykit/charactercontrollerstatecomponent/velocity.md)

## Relationships

### Conforms To

- [Component](realitykit/component.md)

## See Also

### Character control

- [CharacterControllerComponent](realitykit/charactercontrollercomponent.md)
- [CharacterControllerComponent.Collision](realitykit/charactercontrollercomponent/collision.md)
- [CharacterControllerComponent.CollisionFlags](realitykit/charactercontrollercomponent/collisionflags.md)