# Spawn Behavior The **SpawnBehavior** class determines how projectiles are spawned from the spawner. While there are a lot of options, enabling a huge array of behaviors, you can create custom classes which inherit from `SpawnBehavior` to add unique custom functions.

## Number of Projectiles This determines how many projectiles are fired per volley. Note that if you want a "machine gun" effect, keep this value set to `1`, and the "Repeat Count" value `-1`. This means that 1 projectile will be fired, repeating forever until the Launch sequence is stopped.

This is 6 shots per volley, with a short delay between each volley

## Multi Shot Behavior Your options are "*Allowed*", "*Blocked*", and "*Stop Active Shot*". This determines how to handle situations where a new "Fire" command is sent while the Launch sequence is active. `Allowed` means a new sequence will start, while the current one continues. `Blocked` means the new sequence will not start, and `Stop Active Shot` will stop the current sequence and start a new one. ## Delay Before First Projectile This is a delay that occurs before the first projectile is fired. {% hint style="info" %} This delay only occurs ***one time*** per `LaunchProjectiles` call, even if the spawner repeats forever. This is useful for situations where you have a "warm up" period before the projectiles begin firing. {% endhint %} ## Delay Between Projectiles This is the delay between multiple projectiles in the same volley. If there is only `1` projectile, then this is ignored. Note there is an additional delay between volleys you can set as well. ## Switch Spawn Points Between Shots If you have multiple **Spawn Points** set on your [**Projectile Spawner**](/magic-pig-games/projectile-factory/projectile-factory-documentation/projectile-spawner.md), this will switch between them between every shot. The [**Spawn Point Manager**](/magic-pig-games/projectile-factory/projectile-factory-documentation/spawn-point-manager.md) will help determine exactly how the next Spawn Point is chosen. Note there is also an option to *Switch Spawn Points Between Volleys*, which can be used to switch only when one volley of shots completes. ## Position Offset from Spawn Position & Forward Offset from Spawn Position These values will offset the spawn location relative to the direction the Spawn Position is facing.

Who says shots have to always go straight?

{% hint style="info" %} **Spread Options** allow for multiple shots to be spread out in unique ways. While they generally would be used with a `NumberOfProjectiles` value that is greater than 1, the `Spread Angle X` and `Y` values can be used with a single shot to provide a random directional inaccuracy. {% endhint %}

## Start Angle X & Y These offset the starting angle of the shot, relative the the forward direction of the Spawn Point. ## Spread Angle X & Y Multiple shots will be spread out over this total angle, in the positive and negative direction of the Spawn Point forward. ## Spread Pattern X & Y These determine how the spread is calculated. `Random` is entirely random between the minimum and maximum spread angle, while `Random Intervals` will first determine equal intervals (based on the Number of Projectiles), and then randomly choose one of them. `Random Intervals No Repeat` will ensure that each interval is used once per volley. `Negative to Positive` is "left to right" or "bottom to top", and `Positive to Negative` is the opposite, for X and Y respectively.

## Can Stop Mid Spawning When true, the active volley will stop when the **ProjectileSpawner** `Stop` method is called. Otherwise, it will continue until the full `Number of Projectiles` have been created. Spawning will stop if the Spawner is destroyed or disabled, however. ## Stop on Spawner Destroy When true, if the Projectile Spawner is missing or destroyed, spawning will stop. ## Repeat Count A value of `-1` allows for an infinite repetition. A value of `0` or `1` means only one volley will be created. ## Repeat Delay You can set a delay value between volleys here. This only occurs after a volley has completed. ## Switch Spawn Points Between Volleys When true, the Spawn Point will switch (if multiple Spawn Points exist) between each Volley. {% content-ref url="/pages/yyEuyK09NuApk8jSEbXs" %} [Broken mention](broken://pages/yyEuyK09NuApk8jSEbXs) {% endcontent-ref %} {% content-ref url="/pages/mf79eKiFrpOh9lkyHdx5" %} [Broken mention](broken://pages/mf79eKiFrpOh9lkyHdx5) {% endcontent-ref %} {% content-ref url="/spaces/-MY3N\_li2jPq7az6mYfq/pages/KcOTS1fTpuuTbDogO0gD" %} [Spawn Behavior Code](/magic-pig-games/projectile-factory/projectile-factory-documentation/spawn-behavior/spawn-behavior-code.md) {% endcontent-ref %} --- # Agent Instructions: 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://infinitypbr.gitbook.io/magic-pig-games/projectile-factory/projectile-factory-documentation/spawn-behavior.md?ask= ``` 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.