Skip to content

Project Settings

Open via Edit → Project Settings → Massive Swarm System.

Project Settings window open at Massive Swarm System, showing the Default Assets, New Manager Defaults, and Inspector Automation sections

Sets project-wide editor defaults used when creating Massive Swarm System scene objects. Changes here do not affect managers, targets, or spawners that already exist in your scenes.

Default Assets

  • Default Swarm Settings — the SwarmSettings asset assigned to new SwarmManager components when you use the Scene View overlay or the GameObject → Massive Swarm System → Swarm Manager menu.
  • Default Swarm Target Prefab — the prefab instantiated when you use Swarm Target from the overlay or the menu. Out of the box this points to the bundled MSS Default Target prefab, which includes a movement controller so you can test the swarm before connecting a player. If you clear it, the menu falls back to creating a simple capsule-and-cylinder target instead. Either way the tool guarantees a SwarmTarget component on the created object.
  • Default Agent Prefab — the prefab assigned to a new SwarmVisualManager's Fallback Agent Prefab slot. Out of the box this points to the bundled MSS Default Agent prefab, so a brand-new swarm can spawn visible agents before you author your own art. Clear it if you always supply per-archetype prefabs and do not want a fallback.
  • Create Default Asset If Missing — recreates the package default SwarmSettings asset automatically when the configured default is missing.

The Use Package… buttons reset each default back to the bundled asset. The Ping… buttons highlight the current asset in the Project window.

New Manager Defaults

These values are stamped onto a SwarmManager at creation time only. Changing them here does not modify managers that already exist.

  • Manager Object Name — the name given to the manager's GameObject.
  • Select Created Manager — selects the new manager in the Hierarchy after it is created.
  • Create Agent Root — creates a sibling Transform to hold pooled agent visuals and assigns it to the new manager's SwarmVisualManager.
  • Agent Root Name — the name given to that agent-root GameObject.
  • Initial Pool Size — the starting pool size assigned to SwarmVisualManager on a newly created manager.
  • Initialize On Awake — sets the Initialize On Awake toggle on new managers.
  • Show Stats Overlay — sets the Show Stats Overlay toggle on new managers.
  • Track Step Timings — sets the Track Step Timings toggle on new managers.

Inspector Automation

  • Auto Assign Missing Manager Settings — when a SwarmManager has no settings asset in the inspector, the editor assigns the project default automatically.

Creating a custom settings asset

Use the Create Custom Swarm Settings button in the SwarmManager inspector, or the Clone to a New Swarm Settings Asset button in the SwarmSettings inspector. Either opens a save dialog so you can name and place the new asset. The new asset is a copy of the current one — the right way to create per-scene tuning variants without editing the shared default.

When to use it

  • Set a project-wide default SwarmSettings so every new scene starts with the right capacity and grounding masks for your project.
  • Swap the default target prefab when your project has a common player prefab that already includes a SwarmTarget component.
  • Clear Default Agent Prefab once your archetypes all carry their own prefabs and you no longer need the placeholder.