# Welcome to Enemy Masses

**Enemy Masses** is a high-performance crowd simulation and rendering solution for Unity, built on top of the powerful [**GPU Instancer Pro**](https://assetstore.unity.com/packages/tools/utilities/gpu-instancer-pro-266353) **and its Crowd Animator Addon**. It is designed to bring massive, interactive armies to your game without sacrificing framerate.

Whether you are building a "Survivor-style" horde game, an epic RTS battle simulator, or a bustling city full of civilians, Enemy Masses provides the tools to render and simulate thousands of agents with ease.

<figure><img src="https://1399020235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdAWkGLIIEWW0l8btRh5G%2Fuploads%2FIcnYaRlyxeu7JlS8zMfg%2FDontMakeTheGC2BotsAngry%20(1).gif?alt=media&#x26;token=82e5755a-33f4-46a5-b23e-84758b162f53" alt=""><figcaption></figcaption></figure>

### Why Enemy Masses?

Standard Unity GameObjects are heavy. Spawning 500 enemies with `Instantiate()` will often bring even powerful PCs to a crawl. Enemy Masses solves this by utilizing [**GPU Instancing Pro**](https://assetstore.unity.com/packages/tools/utilities/gpu-instancer-pro-266353) and its Addon Crowd Animator for rendering and a highly optimized **Data-Oriented** simulation loop for logic.

* **Massive Scale:** Render 5,000+ animated units on screen simultaneously.
* **High Performance:** Custom physics, navigation, and animation systems designed for scale.
* **Zero Coding Required:** Everything can be configured via ScriptableObjects and Inspectors.

### Core Features

#### ⚔️ Combat Crowds

Create aggressive hordes that chase, circle, and attack the player.

* **Behavior Templates:** One-click setups for "Vampire Survivors" swarms, "Assassin's Creed" circle-fighting, or "Total War" battle lines.
* **Hybrid Combat:** Units that intelligently switch between Melee and Ranged attacks based on distance.
* **Faction Battles:** Create multi-team wars where Orcs fight Humans while the Player fights everyone.

#### 🏙️ Civil Crowds

Populate your world with neutral NPCs that bring your environments to life.

* **Waypoint System:** Define traffic lanes, sidewalks, and intersections.
* **Activities:** Agents can stop to sit on benches, talk to each other, or interact with the world.
* **Free Roam:** Let agents wander parks and plazas naturally.

#### 🎮 RTS Integration

Turn your game into a strategy commander.

* **Selection & Command:** Select units and issue Move/Attack orders.
* **RTS Camera:** Built-in top-down camera controls.
* **Minimap & Fog of War:** Essential tools for strategy gameplay.

### Supported Genres & Inspirations

Enemy Masses is versatile enough to power the core loop of several distinct genres.

#### 🧟 Survivor / Horde Games

Build games where the player faces overwhelming odds against thousands of enemies.

* **Inspiration:** *Vampire Survivors*, *Deep Rock Galactic: Survivor*, *Brotato*.
* **Key Tech:** High-performance rendering of 5,000+ units, "Melee Swarm" behavior templates.

#### ⚔️ Real-Time Strategy (RTS)

Create epic battles where players command armies rather than a single hero.

* **Inspiration:** *Total War* series, *StarCraft*, *Age of Empires*.
* **Key Tech:** Unit selection, formation movement, faction-based combat logic.

{% embed url="<https://www.youtube.com/watch?v=x7w4KqKOm6U>" %}

#### 🛡️ Action RPG / Hack & Slash

Design levels where the hero cuts through dense mobs of fodder enemies.

* **Inspiration:** *Diablo 4*, *Dynasty Warriors*, *Path of Exile*.
* **Key Tech:** "Melee Queued" behavior (enemies circle and attack), fluid animations, hit reactions.

#### 🏙️ City Simulation

Populate open worlds with believable background crowds.

* **Inspiration:** *Cities: Skylines*, *Grand Theft Auto* (pedestrians), *Assassin's Creed* (crowds).
* **Key Tech:** Civil Waypoint System, activity nodes, performance-friendly ambient AI.

### Getting Started

Ready to build your army?

1. **Installation & Setup:** Learn how to install the package and run the Setup Wizard.
2. **Crowd Types:** Understand the difference between Combat, RTS, and Civil crowds.
3. **The Enemy Crowd Asset:** The core data file that defines your units.

***

*Enemy Masses requires* [*GPU Instancer Pro*](https://assetstore.unity.com/packages/tools/utilities/gpu-instancer-pro-266353) *to function.*

### Jump right in

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-bolt">:bolt:</i></h4></td><td><strong>Quickstart</strong></td><td>Use the Wizard</td><td><a href="https://1399020235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdAWkGLIIEWW0l8btRh5G%2Fuploads%2Fx9QBnQ28frIF2BC8mcxA%2Fimage.png?alt=media&#x26;token=7f593b5d-dc6e-41fd-b923-179d4ce4b001">image.png</a></td><td></td><td><a href="getting-started/quickstart">quickstart</a></td></tr><tr><td><h4><i class="fa-gears">:gears:</i></h4></td><td><strong>Editor basics</strong></td><td>Learn the basics of Enemy Masses</td><td><a href="https://1399020235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdAWkGLIIEWW0l8btRh5G%2Fuploads%2FP39db00e2u70YdxOY9am%2Fimage.png?alt=media&#x26;token=a89b306a-281b-446d-b462-27879379a9e3">image.png</a></td><td></td><td><a href="basics">basics</a></td></tr><tr><td><h4><i class="fa-people-group">:people-group:</i></h4></td><td><strong>RTS</strong></td><td>Build the next Battle Simulation</td><td><a href="https://1399020235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdAWkGLIIEWW0l8btRh5G%2Fuploads%2FjQfQqk8wyRQvbBXI6R1V%2FImage%20Sequence_001_0429.jpg?alt=media&#x26;token=6ad07537-a2bf-4ebd-84c1-f7c39fda7f2a">Image Sequence_001_0429.jpg</a></td><td></td><td><a href="rts">rts</a></td></tr></tbody></table>
