# Unreal Chaos

> Unreal Chaos is an Agent Skill for development published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Unreal Engine Chaos physics skill for destruction, vehicle simulation, and cloth physics.

- Skill name: `unreal-chaos`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/game-development/skills/unreal-chaos/SKILL.md
- Repository: a5c-ai/babysitter (1,548 GitHub stars when collected)

## SKILL.md

# Unreal Chaos Skill

Chaos physics system for Unreal Engine.

## Overview

This skill provides capabilities for implementing physics-based destruction, vehicles, and soft body simulation using Unreal's Chaos physics system.

## Capabilities

### Destruction
- Create geometry collections
- Configure fracture patterns
- Handle debris simulation
- Manage collision clusters

### Vehicle Physics
- Implement wheel vehicles
- Configure suspension
- Handle aerodynamics
- Manage vehicle networking

### Cloth Simulation
- Configure cloth assets
- Handle collision
- Manage constraints
- Optimize performance

### Physics Fields
- Apply force fields
- Create attraction/repulsion
- Handle noise fields
- Manage field interactions

## Prerequisites

- Unreal Engine 5.0+
- Chaos enabled (default)

## Usage Patterns

### Geometry Collection Setup

```
1. Create Geometry Collection from mesh
2. Configure fracture settings
3. Add cluster connections
4. Set physics properties
5. Place in level
```

### Vehicle Setup

```cpp
// Configure in Vehicle Movement Component
WheelSetups.Add(FWheelSetup{
    WheelClass,
    BoneName,
    WheelOffset
});
```

## Best Practices

1. Profile destruction complexity
2. Use LOD for distant debris
3. Configure sleep thresholds
4. Test networked destruction
5. Manage cluster counts

## References

- [Chaos Documentation](https://docs.unrealengine.com/5.0/en-US/physics-in-unreal-engine/)

---

Source: https://www.openparable.com/skill/development/unreal-chaos (OpenParable). Cite the canonical URL above.
