Pipeline and Runtime Lifecycle
GLB import, pointer capture, and feature registration
Engine node responsibilities
- Pointer capture: when a
FoldedPaperEnginenode enters the tree, it remembers the prior mouse mode and captures the pointer ifCapture Pointeris true. On exit it restores the original mode. - Load and unload:
_enter_treedefers_setup, which callsglobal_load_levelwith the configured path._exit_treedefers_teardownto unload the active GLB and detach any listeners. - Global registries: the engine stores a global
FeatureUtilsinstance, the current stage node, and the activeWorldEnvironmentso sub-scenes and events share the same context.
Load flow
- Input setup: device change listeners are connected on first load so controllers can be remapped at runtime.
- Scene creation: the GLB/GLTF is instantiated under the engine node. Feature utils parse user data for scene settings, objects, triggers, animations, and inventory.
- Frame events: a
FrameEventRunneris attached and populated with animation-specific frame triggers so events can fire at precise timestamps.
Download