The global singleton scene, processes everything and hold global data. Also contains all the API functions.

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

</aside>

Properties of the root node :

• ☄️ Custom Bullet Props Data : dictionary of data that will be appended to all Bullet Props in the inspector. Imagine you want all your bullets to have a “coolness” value, which your game needs. Add a “coolness” string key to this dictionary, with or without a default value (any type). And this custom data will be modifiable in every Bullet Prop inspector.
• ☄️STANDARD_BULLET_RADIUS : the average radius of a bullet. It doesn’t have any effect on the bullets, it’s just used in some calculations where the plugin needs to know what is the average size of the bullets in your game. Value is 5 by default.

<aside> ☄️ If you change Custom Bullet Props Data, you need to restart Godot to see the changes applied to all Bullet Props. Adding and removing keys will impact ALL Bullet Props in your project. Changing default values will ONLY impact Bullet Props where this default value hasn’t been changed. If you witness a case where this rule doesn’t apply, please report it.

</aside>

• ☄️Default idle/spawn/shoot/waiting/delete: default ☄️AnimState for each native state of all bullets.

• ☄️Time scale : change the speed of the time.

• ☄️RAND SEED : the RandomNumberGenerator seed. Any Int32 value is a valid seed (except -1, which generates a random seed with randomize() ). Once the game is loaded, it’s better to change the seed through rng_edit(). Read Randomisation and Randomisation

• Bounce Group : bullets that will collide with bodies belonging to these groups will bounce instead of be destroyed. Default group name : "Bounce". You can change or add more.

• ☄️Gravity : global gravity value applied to all bullets. A normal gravity should be less than 10. Using 0,0 will disable the gravity system.

• ☄️z_index (this is the native Godot property) : change the z level at which the bullets are drawn. It can be individually changed in Bullet Props but it’s not recommended as it will impact performances.

• 🌀SFX list : list of audio files, see Animating bullets to learn how to use.

• Culling :

  • ☄️Cull margin : bullets are deemed offscreen if their distance to the screen borders (viewport) is farther than this value.
  • ☄️Cull triggers : offscreen bullets won’t trigger their trigger logic
  • ☄️ Technique : determines what happen when a bullet goes offscreen.
    • Anim : this is the minimal behavior, the bullets aren’t drawn anymore but their physics remain the same.
    • Move : offscreen bullets are disabled but not destroyed. Their position will continue being updated except they won’t be rendered and won’t interact with the physical world. If they reenter the screen, they will appear again.
    • Full : offscreen bullets are destroyed right away
    • Inherit : do not pick that. It does nothing.
  • ☄️ Culling rate : delay between 2 culling checks. Checking which bullets are offscreen can be expensive. Instead of doing it every frame (default value), you can choose another delay.
  • ☄️ Increase At : Culling technique goes to Full when this bullet count is reached.
  • ☄️ Max bullets : prevent from spawning new bullets when this number is reached.
  • ☄️ Viewport refresh rate : delay between 2 viewport updates. Checking where are the limits of the screen can be expensive. Instead of doing it every frame (default value), you can choose another delay.
  • ☄️ Fixed screen : if the screen doesn’t move in your game, you can enable this and the viewport will never be updated. You can still update it manually with [☄️**update_viewport()** : update the Rect2() which determines the limits of the screen. Used for Culling. Viewport is updated automatically every Viewport refresh rate times but this function does it manually. It is recommended to call this function every time the scene changes in the scene’s _ready function, before any bullet gets shot.](https://www.notion.so/update_viewport-update-the-Rect2-which-determines-the-limits-of-the-screen-Used-for-Viewpor-13e6afe4334642fc92e2c51b41ed35a0)
  • ☄️ Culling faking dist : bullets past that distance from ALL NoI in Spawning.interest_list will have their collision disabled.
  • ☄️ Culling unfaking dist : bullets under that distance from ANY NoI will have their collision disabled.
  • 🌀 obsolete features :

Useful variables

These variables aren’t exported but can still be useful. Use Spawning.*variable* to get it. Variables accessible by an API function aren’t listed here, as it’s recommended to get them through their function instead.

• CUSTOM : reference to ☄️customFunctions.gd
• RAND : ref to the RNG (see Randomisation)