The global singleton scene, processes everything and hold global data.

<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.

<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.

• 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://dark-peace.notion.site/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 :

API : Special Functions & Signals

Some utility functions you might want to use when coding your bullethell game. They’re all part of the Spawning autoload. Call with Spawning.*function()*

Main Functions

• reset(minimal reset) : clear all the bullet and reset all data. You MUST call before changing scene with get_tree().change_scene() or get_tree().reload_current_scene. If minimal, all resources and nodes whose ID starts with a “@" won't be reset. Which can be used to make global resource that the whole game needs.
• create_pool(bullet id, amount, Shared Area name): create a bullet pool containing a certain amount of bullets with a specific ID, under a specific Shared Area. Set object to true if Create_pool should always be used upon scene loading when you spawn bullets by code. For more details, read about Pooling.