godot-autoload-architecture

name

godot-autoload-architecture

description

Expert patterns for Godot AutoLoad (singleton) architecture including global state management, scene transitions, signal-based communication, dependency injection, autoload initialization order, and anti-patterns to avoid. Use for game managers, save systems, audio controllers, or cross-scene resources. Trigger keywords: AutoLoad, singleton, GameManager, SceneTransitioner, SaveManager, global_state, autoload_order, signal_bus, dependency_injection.

Available Scripts

autoload_init_order_diag.gd

MANDATORY before trusting a multi-Autoload dependency graph — verifies boot sequence.

singleton_dependency_diagram.gd

MANDATORY with the mermaid/order diagram — maps who may call whom at boot.

global_event_bus.gd

MANDATORY before a cross-system Autoload bus (Achievements, UI, Save events).

safe_scene_switcher.gd

MANDATORY before Autoload-owned scene transitions (deferred free / root management).

service_locator.gd / service_registry.gd

MANDATORY before Engine.register_singleton DI for non-Node services.

persistent_data_holder.gd

Data that must survive change_scene_to_file() (inventory, settings).

static_state_manager.gd

static var global state when you do not need a SceneTree Node.

lazy_loaded_singleton.gd

On-demand instantiate instead of eager boot cost.