Core Setup¶
Reference for the core components and ScriptableObjects that every scene needs. The Getting Started walkthrough covers the fast path; this section is the reference you return to when tuning.
What lives in Core Setup¶
A working swarm needs four things in the scene:
| Topic | What it is |
|---|---|
| Swarm Manager | The single component that owns the simulation. One per scene. |
| Targets | The SwarmTarget component on whatever the swarm should chase. |
| Swarm Settings | The global ScriptableObject controlling capacity, grounding, body blocking, LOD, and dormancy. |
| Swarm Agent Archetype | One asset per enemy type. Binds prefab, radius, behavior profile, and movement profile. |
Plus a per-archetype tuning asset:
- Swarm Movement Profile — speed, acceleration, turn rate, and orientation blend.
And one project-wide configuration screen:
- Project Settings — defaults applied to newly created managers.
What is not in this section¶
- Spawning — see Spawners. Spawners are how agents get into the scene; they are configured separately so a single Swarm Manager can be driven by several spawners or a director.
- Behaviors — see Behaviors. Steering profiles are attached to the archetype; the behavior pages document each pass in detail.
- Navigation around walls — see Navigation for the optional Surface Flow Field.
- Animation pipeline — see Animation for VAT, Animator, and instanced rendering.
Recommended reading order¶
- Swarm Manager — to understand the inspector you'll use most.
- Swarm Settings — the global parameters every scene shares.
- Swarm Agent Archetype and Movement Profile — per-enemy-type tuning.
- Targets — short, but worth a read for multi-target setups.
- Project Settings — only if you maintain shared defaults across scenes.