> For the complete documentation index, see [llms.txt](https://wiki.thescriptersguild.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.thescriptersguild.com/forge/nav-mesh/npc-units/ai/ai-spawning/ai-phantom-spawner.md).

# AI Phantom Spawner

Spawns AI units by dropping them from a Phantom. The object boundary must intersect the nav mesh, to see the Nav Mesh data toggle the *Nav Mesh Visualization* to ON in the **Tool Settings** menu. Up to 32 AI units and 4 Phantoms can exist at a time, but runtime budgets may decrease this limit.

## Remarks

As the Phantom travels to the spawn location, it can be damaged and destroyed, preventing the AI units from entering gameplay. Objects obstructing the Phantom drop off location or path can interfere with the spawn process so it is important to verify that the dropship can reach its destination as expected.

## Object Properties

### Unit 1 Selection

| Property | Description                                               |
| -------- | --------------------------------------------------------- |
| Unit     | The AI unit to spawn in this slot.                        |
| Weapon   | The weapon that will be used by the AI unit in this slot. |

### Unit 2 Selection

| Property | Description                                               |
| -------- | --------------------------------------------------------- |
| Unit     | The AI unit to spawn in this slot.                        |
| Weapon   | The weapon that will be used by the AI unit in this slot. |

### Unit 3 Selection

| Property | Description                                               |
| -------- | --------------------------------------------------------- |
| Unit     | The AI unit to spawn in this slot.                        |
| Weapon   | The weapon that will be used by the AI unit in this slot. |

### Unit 4 Selection

| Property | Description                                               |
| -------- | --------------------------------------------------------- |
| Unit     | The AI unit to spawn in this slot.                        |
| Weapon   | The weapon that will be used by the AI unit in this slot. |

### Unit 5 Selection

| Property | Description                                               |
| -------- | --------------------------------------------------------- |
| Unit     | The AI unit to spawn in this slot.                        |
| Weapon   | The weapon that will be used by the AI unit in this slot. |

### Unit 6 Selection

| Property | Description                                               |
| -------- | --------------------------------------------------------- |
| Unit     | The AI unit to spawn in this slot.                        |
| Weapon   | The weapon that will be used by the AI unit in this slot. |

### Unit 7 Selection

| Property | Description                                               |
| -------- | --------------------------------------------------------- |
| Unit     | The AI unit to spawn in this slot.                        |
| Weapon   | The weapon that will be used by the AI unit in this slot. |

### Unit 8 Selection

| Property | Description                                               |
| -------- | --------------------------------------------------------- |
| Unit     | The AI unit to spawn in this slot.                        |
| Weapon   | The weapon that will be used by the AI unit in this slot. |

### Phantom Preferences

| Property        | Description                                                      |
| --------------- | ---------------------------------------------------------------- |
| Seat Preference | What seats should be prioritized in the Phantom.                 |
| Active Turret   | If true, the Phantom will spawn with an active chin turret.      |
| Side Gunners    | If true, the Phantom will spawn with grunts on the side turrets. |

### Phantom Vehicle Drop

| Property           | Description                                                                                        |
| ------------------ | -------------------------------------------------------------------------------------------------- |
| Vehicle Preference | Select which vehicle should be dropped by the Phantom.                                             |
| Vehicle Piloted    | If true, the vehicle selected above will be occupied by an AI unit. This replaces the Unit 8 slot. |

### Squad Behaviors

| Property        | Description                                                                                                 |
| --------------- | ----------------------------------------------------------------------------------------------------------- |
| Set Deaf        | If enabled, the spawned AI units will not perceive audio cues such as gunfire.                              |
| Set Blind       | If enabled, the spawned AI units will not perceive visual cues such as the player walking in front of them. |
| Set Inactive    | If enabled, the spawned AI units will not make any behavior decisions or be active.                         |
| Set Magic Sight | If enabled, the spawned AI units will be able to see enemies through walls and terrain.                     |

### Spawn Logic

| Property            | Description                                                                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Triggered by Script | If enabled, the spawner will not automatically spawn AI units and will instead wait for a script call to activate it.                            |
| Initial Spawn Delay | The number of seconds into the round before the AI units spawn. Set to 0 to cause the units to spawn immediately.                                |
| Squad Label         | The Squad Label used by the spawned AI units. Each spawner will spawn AI units as a squad and nodegraph can use these labels to identify squads. |

### AI Zone

| Property     | Description                                                                                                                                                                                                                                  |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AI Move Zone | The AI Move Zone that the spawner's AI units will be assigned to. Linking a zone will allow the spawner's AI units to move and fight outside the vicinity of the spawner. To cancel a link, select this AI spawner from the list of options. |

**Contributors**

Mr. Admirals


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.thescriptersguild.com/forge/nav-mesh/npc-units/ai/ai-spawning/ai-phantom-spawner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
