Swarm Agent Archetype

Defines one enemy type. An archetype binds together the visual prefab, the agent's physical radius, and the steering and movement profiles that govern how this enemy moves. Spawners reference archetypes, so the same spawner shape can serve different enemy types.

Archetype Wizard

Use the wizard for your first archetype

The wizard creates an archetype plus fully wired Behavior, Movement, and optional Attack profiles in one step. It is the fastest way to get a new enemy type into your scene.

Open it from either menu path. Both open the same window, which docks with the tab title New Swarm Archetype:

• Tools → Massive Swarm System → New Archetype...
• Right-click in the Project window → Create → Massive Swarm System → Agents → Agent Archetype (Wizard)... (opens with the selected folder pre-filled)

The wizard walks through four steps:

The Archetype Wizard. The four numbered sections match the steps below. In Visuals, assigning a prefab auto-detects its renderer and suggests an Agent Radius from the prefab bounds; the Preview at the bottom lists exactly which assets will be created before you commit.

1. Identity: name and output folder. Choose Single .asset file (the default: all profiles nested as sub-assets inside the archetype, so one file holds the whole enemy type) or Separate .asset files (a new folder with one file per profile, easier to diff and to share a profile between archetypes by hand). The wizard remembers your last layout choice and your last valid output folder between sessions, so the second archetype you create starts where the first one left off rather than back at the defaults.
2. Visuals: assign your prefab. The wizard reads prefab bounds to suggest an agent radius automatically. If the prefab contains a SkinnedMeshRenderer, a link to the VAT Baker is shown.
3. Preset: pick a starting point from the built-in presets (described below). Each preset ships independent profile copies, so editing one archetype's profiles never affects another.
4. Combat: use the preset's attack profile, create none (Pacifist), or configure a Custom profile with Swing and/or Contact enabled.

Click Create Archetype to write all assets at once. On success the wizard pings the new archetype in the Project window and offers shortcuts to the inspector.

Built-in presets

Preset	Movement feel	Combat
Zombie Horde	Slow, dense. Lumbers toward the target in a tight pack.	Contact (bites on touch, no swing animation)
Sword Mob	Medium speed. Surrounds the target and queues for melee strikes.	Swing (melee with windup, recovery, and animation)
Ranged Skirmisher	Fast. Orbits at range, retreats when crowded.	None; wire your own projectile logic
Skittering Bug	Very fast and twitchy. Small radius.	Contact (rapid light bites on touch)
Custom (Defaults)	Medium speed, balanced acceleration.	None; tune everything in the inspector

The numbers behind those descriptions, for when you want to compare rather than read:

Preset	Max Speed	Agent Radius	Push Resistance	Orientation Mode
Zombie Horde	1.6	0.5	1.5	Face Goal With Velocity Blend
Sword Mob	4	0.5	1	Face Goal With Velocity Blend
Ranged Skirmisher	5	0.5	1	Face Goal
Skittering Bug	7	0.3	0.5	Face Velocity
Custom (Defaults)	4	0.5	1	Face Goal With Velocity Blend

Push Resistance is what makes the zombie feel heavy and the bug feel flimsy: at 1.5 the zombie shrugs off shoves that send the bug at 0.5 flying.

Restoring the built-in presets

The wizard only creates preset assets that are missing. It never overwrites edits you've made to them. If you want to revert all five built-in presets back to their shipped values, run Tools → Massive Swarm System → Restore Default Wizard Presets. A confirmation dialog explains what will change. Archetypes you already created from those presets are not affected.

When to use the wizard vs. creating assets manually

Use the wizard when you are creating a new archetype from scratch. Use the manual Create → Agent Archetype flow (documented in the field reference below) when you want to duplicate or variant an existing archetype and only change one or two fields. In that case duplicating the existing .asset files is faster.

---

Field reference

Create a bare archetype via right-click → Create → Massive Swarm System → Agents → Agent Archetype.

Field	What it does
Agent Prefab	The visual GameObject instantiated into the pool. If left empty, the SwarmVisualManager's Fallback Agent Prefab is used instead, and out of the box this points to the bundled MSS Default Agent so agents are visible while you work on your own art.
Agent Radius	Collision and separation radius for this archetype. Default 0.5.
Push Resistance	How hard this archetype is to shove or knock back. Higher values resist pushes from other agents and combat pushback. Default 1. Values below 0.01 are clamped up.
Behavior Profile	Which SwarmBehaviorProfile controls steering for agents of this type.
Movement Profile	Which SwarmMovementProfile controls speed and turn rate.
Attack Profile	Optional SwarmAttackProfile that gives this archetype swing and/or contact attacks. Leave empty for a pacifist enemy: no attacks, no per-agent combat overhead. See Attack Profile.

Editing a profile without leaving the archetype

Under the Behavior Profile and Movement Profile slots the inspector offers Edit Behavior Profile In Place and Edit Movement Profile In Place. Either one folds the profile's full inspector into the archetype, so you can tune steering while looking at the archetype that uses it instead of selecting two assets in turn. Stop Editing In Place folds it back up.

You are editing a shared asset

A profile is its own asset, and more than one archetype can point at it. Editing it here changes it for all of them. The inspector names the asset in a warning above the button for exactly this reason. If you only meant to change this one enemy type, duplicate the profile first and assign the copy. Archetypes created by the wizard each get their own profile copies, so this bites hardest on archetypes you wired by hand.

With several archetypes selected at once, the inline editor refuses to open unless they all point at the same profile.

Writing your own wizard presets

The five built-in presets are not special. Each one is a SwarmArchetypePreset asset, and the wizard finds every preset in the project and lists them sorted by Sort Order. So if your game has four recurring enemy shapes, you can make them one-click options for the rest of the team.

Create one with right-click → Create → Massive Swarm System → Wizard → Archetype Preset.

Field	What it does
Display Name	The name in the wizard's list. Falls back to the asset's own filename when left empty
Summary	One line shown beside the name. This is where you say what the preset is for
Sort Order	Lower numbers list first. Default 100, which is what the built-in presets use, so give yours a lower number to put it on top
Default Radius	Agent radius written into the new archetype. Default 0.5
Default Push Resistance	Push resistance written into the new archetype. Default 1
Behavior Seed	The behavior profile to clone. Required
Movement Seed	The movement profile to clone. Required
Attack Seed	Optional attack profile to clone. Leave it empty for a pacifist preset, and no attack profile is created at all

The three seed slots are cloned, not referenced, so every archetype the wizard creates from your preset gets its own independent profiles. Tuning one enemy later never reaches back into the preset or into anything else built from it. The quickest way to author one is to build an archetype you like by hand, then point a new preset at its three profiles.

Mixing archetypes in a single swarm

Multiple archetypes work in one scene. A shape spawner carries one archetype in its Spawn Profile, so mixing inside a single encounter is the Swarm Spawner Director's job: its Composition list takes a weighted set of archetypes and rolls one per spawn, which is how you get runners, tanks and harassers arriving from the same spawner. Without a director, mix by placing one spawner per enemy type.

Related

• Behaviors: what the Behavior Profile controls.
• Movement Profile: the speed/turn settings the archetype links to.
• Spawners: how archetypes are spawned into the scene.