<aside> 📌 Items marked with a ☄️are exclusive to the BLAST! version. Items marked with a 🌀 will disappear in future versions.

</aside>

There are different kinds of Spawn Pattern resources.

Pattern One

Pattern Line

Pattern Circle

Pattern Custom Points

Pattern Custom Shape

Pattern Custom Area

☄️PatternRandomizer

But each of them have these general properties :

• Nbr : Number of bullets to spawn

• Bullet : The ID of the Bullet Props

• Iterations : Number of times this pattern will spawn bullets.

  Set to -1 for an infinite loop. Call ☄️process_kill(process:int) : stop a spawning process, given its ID. to stop the infinite loop.

• Symmetrical : if the spawn / shot delay > 0, bullets will not be spawned / shot one by one but 2 by 2, starting from the center bullet. Thus doing a symmetrical effect.

• Advanced :

  • ☄️Bullet List : Array of IDs. It can allow you to spawn multiple bullets with different Bullet Props with a single spawner. The bullet spawned by the pattern will alternate between the IDs in the list. Exemple: if there are 2 IDs, one bullet out of 2 will get the first ID.

  • ☄️Skip in list: In case some bullets are skipped (see Pattern Circle or Pattern Line ), they won’t count in the bullet list.

  • ☄️Skip steps : One out of x bullets will be skipped, which means they won’t spawn.

  • ☄️Skip amount : The amount of bullets that will be skipped at each step.

  • ☄️ Skip chance : Chance between 0 and 1 that the bullet will be skipped. Works independently of the other skipping properties.

  • ☄️ Skip list: The index of the bullets that will be skipped. Can’t be used along skip_steps.

  • ☄️Behavior : pattern behavior between the time the bullets spawn and they’re shot in the case where the spawner is moving. The bullet can follow the parent’s position like it was a child node, the parent’s rotation can additionally be used to calculate the bullet position and/or its rotation (with the full option)

  • ☄️Keep Behavior : whether the above behavior is kept once the bullet has been shot. It allows the bullet’s position and rotation to be relative to its parent at all times. This is not guaranteed to work with every movement property.

  • Tween momentum : When the bullet is ready to be shot, it will go in the opposite direction first, as if they’re building momentum before being shot (this is purely visual and doesn’t change anything about the shot). Set to none to disable. Other values are the tween transition types.

  • Tween length : distance from the spawn position to which the bullet is gonna go while “building momentum”.

  • Tween time : time it’s gonna take for the bullet to reach the total length.

  • ☄️Temp Count : this resource will be erased from memory after being used by this many spawners. A resource is considered used after a spawner has shot all its iterations. Set to -1 to disable. Set to 1 to create a one-time resource that will get disposed of as soon as it has been used, taking no place in memory.

• Spawning :

  • On interrupt: when the bullets’s parent node is deleted, they can either get destroyed, shot immediately or continue with the normal cooldown.
  • Forced Angle
    • Angle: pattern rotation angle in radian. Independant from the bullet's shooting angle.
    • ☄️Angle mouse: Instead of a forced angle, the mouse cursor will be targeted.
    • ☄️Angle Target : Instead of a forced angle, the specified node will be targeted.

• Shooting :

  • Angle : If ≠ 0 (TODO : change that), all bullets will be shot with that angle, regarding of their own shot angle or the patterns angle above.
  • Target : Instead of a forced angle, the specified node will be targeted.
  • Look at mouse: Instead of a forced angle, the mouse cursor will be targeted.
  • Pattern look at : When a target is selectionned, if true, the pattern looks at the target and a unique angle is derived from it for all the bullets. If false, all the bullets will target the target upon shooting and their trajectories will all meet at the target's position.
  • ☄️Target pattern : ID of a pattern y to target. Each bullet of index xi will spawn at the position dictated by the current pattern x as normal, but when shot, they will target the position yi they would have spawned at if they had spawned with pattern y. If the nbr property of y < x, bullet xi will starts targeting back at index y0 (= a modulo is used).

  <aside> ⚠️

  All the above properties cannot be used together.

  </aside>

  • ☄️Target pattern offset : target positions yi from the targeted pattern are relative to the spawn point. You can offset the position with this property.
  • ☄️Target absolute position : instead of being relative to the spawnpoint, the offset will be the target pattern’s absolute position
  • ☄️Target pattern rotation : rotate the target pattern.
  • ☄️Target delay : if > 0, the bullet’s speed will be calculated not by the Bullet Props’s speed property. Instead, when spawning, bullets will be at their position xi, as normal, but will reach the position yi after the specified delay. Bullets closer to their target yi will be slower to ensure that, at the exact time of the delay, all bullets i are at their position yi.
  • ☄️Impulse : initial speed boost when spawning.

• Cooldowns :

  • Spawn : cooldown between 2 iterations.
  • Shoot : cooldown between the spawn of all the bullets and the shot.
    • A cooldown_shoot = 0 will make it so it doesn’t wait for all the bullets to spawn in order to start shooting. They will shoot as soon as they’re spawned, unless a cooldown_next_shoot is present.
  • Next spawn : cooldown between 2 bullets of a same iteration ( ex : nbr = 3 → cooldown between 1 & 2 and 2 & 3)
  • Next shoot : cooldown between 2 shots of a same iteration. Allows for each bullet to be shot at different times.
  • ☄️ Layers: Adds extra-cooldowns between some iterations. The x (int) value is the number of iterations before the next extra-cooldown. The y (float) value is the value of the extra-cooldown. Once the end of the array is reached, it loops back.
  • Stasis : bullets are spawned but never shot. Similar to setting the speed to 0, but here, bullets will never go through the code related to movement, unlike bullets with 0 speed.

• 🌀Layers (to be removed, do not use) :

  • 🌀Nbr : number of layers to the itération. Différents layers CAN have similar but différent properties. For example : a circle pattern with the bullets spawning with an offset of x radians.
  • 🌀Cooldown Spawn : cooldown between 2 layers
  • 🌀Pos offset : position offset between 2 layers
  • 🌀Speed offset : speed différence between 2 layers
  • 🌀Angle offset : angle différence between 2 layers
  • 🌀Nbr offset : difference of number of bullets between 2 layers

• ☄️Random : ‣ used to randomise other properties.

<aside> ☄️ If you update from an obsolete version that was using the layer properties, know that the feature that intends to replace layers is the function ☄️spawn_list(spawner:Array, id:PackedStringArray, loops:int=0, shared_area:Array[String]=["0"], process_id:int=-1, cust_bullet): spawn a list of patterns one by one. It’s used exactly like spawn() except that all the arguments are arrays. Loop determines if it loops back to the start of the list once it reaches the end. id is the list of pattern spawned. For each pattern of index i, the spawner i and shared area i will be used. If those lists have less items than i, the last item of the list will be used. So if you don’t want to change the shared_area, just input a list with a single item for example..

</aside>