Overview
ScriptLibraryLoader loads game script DLL at init. ScriptBuildSystem + async std::future rebuilds DLL from script_build_settings.ini when requested.
Hot reload saves ScriptComponent serialized fields (RapidJSON), reloads DLL, restores instances.
instantiateSceneScripts / destroySceneScripts called around play mode (ModuleGameView). State machine behaviours also destroyed on reload. Cannot rebuild while PLAYING.
How it works
- Init loads the game scripts DLL via
ScriptLibraryLoader. - Editor-triggered rebuild runs MSBuild asynchronously through
ScriptBuildSystem. - On reload, serialized script fields are preserved, DLL is swapped, and scene script instances are restored.
- Play mode start/stop hooks instantiate or destroy scene scripts via
ModuleGameView.
Internal architecture
ModuleScripting
├── ScriptLibraryLoader (DLL)
├── ScriptBuildSystem + MSBuild worker
├── Reload state machine (Idle/Building/…)
└── Scene script lifecycle hooks
Relationships
ScriptComponentonGameObjects;ModuleGameViewplay/stop; editor windows for script settings.
Technical features
- Game script DLL load at init.
- Async MSBuild rebuild from
script_build_settings.ini. - RapidJSON-backed hot reload of
ScriptComponentfields. - Play-mode instantiation rules tied to
ENGINE_STATE.
Implementation notes
- Verified: DLL load, async build/reload, play-mode instantiation rules.