Skip to content

Samples & Cleanup

Massive Swarm System ships with two optional sample tiers under Assets/MassiveSwarmSystem/Samples/. Both are installed by default. You can remove either tier at any time — the core plugin keeps compiling and running without them.

What ships in each tier

Starter Combat Kit

Located at Assets/MassiveSwarmSystem/Samples/StarterKit/.

Scripts only — no scenes, no art. This tier gives you a damage and weapon system to attach to your own GameObjects so combat works without writing it from scratch.

It includes:

  • Damageable base classes — DamageableBase, CombatTargetBase
  • Combat target types — PlayerCombatTarget, SwarmAgentCombatTarget, DestructibleCombatTarget
  • Weapons — RotatingWeapon (melee), ProjectileWeapon (ranged), SwarmProjectile, TouchDamageSource
  • Feedback helpers — DamageFlashFeedback, HealthBarDisplay, SpawnPrefabOnDeath, PooledEffect, SwarmPoolManager

Bringing your own damage system

The damage contract — IDamageable, ITargetable, and SwarmAttackProfile — lives in the core plugin, not in this tier. The Starter Kit is one implementation of that contract. If you already have a health and damage system, implement IDamageable on your damageable objects and skip this tier entirely.

Full Demo

Located at Assets/MassiveSwarmSystem/Samples/FullDemo/.

The heavy showcase tier. It contains the three playable demo scenes (MSS Pyramid Level, MSS Agent Archetype Sandbox, MSS Tower Defense), all their characters, art assets, VAT bakes, the arena generator, level progression (XP), respawn, camera rig, collectibles, and the fully-built example prefabs (weapons, projectiles, player, HUD, and VFX). This is the largest part of the package.

The Full Demo depends on the Starter Combat Kit (for example, the respawn system uses DamageableBase). The Starter Kit does not depend on the Full Demo.

Removal order matters

You can remove both tiers independently, but the dependency runs one way:

  • You can remove the Full Demo while keeping the Starter Kit.
  • To remove the Starter Kit, remove the Full Demo first.

How to remove samples

Open Tools → Massive Swarm System → Welcome and scroll to the Samples & Project Cleanup card.

Each tier shows its current status (Installed or Removed). Three buttons are available:

  • Remove Full Demo — enabled whenever the Full Demo is present.
  • Remove Starter Kit — enabled only after the Full Demo is removed.
  • Remove All Samples — removes both tiers in one step.

Each button asks for confirmation before deleting anything. Removed files are moved to your system trash via Unity's AssetDatabase.MoveAssetToTrash, so they are recoverable from the trash or re-downloadable from the Asset Store.

Route B — Delete in the Project window

Delete the folder directly in Unity's Project window:

  • Assets/MassiveSwarmSystem/Samples/FullDemo — removes the Full Demo only.
  • Assets/MassiveSwarmSystem/Samples/StarterKit — removes the Starter Kit (delete Full Demo first).
  • Assets/MassiveSwarmSystem/Samples — removes everything.

The core plugin recompiles cleanly after either folder is gone.

Skip at import time

When importing the package from the Asset Store, you can untick the Samples folder in Unity's import dialog before clicking Import. Neither tier is installed, and the core plugin works immediately.

Remove Full Demo before Starter Kit

Deleting StarterKit while FullDemo is still present causes compile errors because the Full Demo scripts reference Starter Kit types. Always remove the Full Demo first when deleting the Starter Kit manually.