Added background scripts

Background scripts are scripts that are launched when a map is loaded. They differ in use from a map's init script in that they are expected to contain an infinite loop. These scripts are linked to a sprite and will be killed when that sprite is destroyed (usually when the map is unloaded, but if the sprite is made persistent then it may last longer). The thread running the script is given no warning that it is being killed; the coroutine is simply never called again, and the thread is disposed of. Because of this, background scripts MUST ensure the game is in a consistent state before coroutine yielding, because it is not guaranteed that the coroutine will ever be called again.

1 files changed, 4 insertions, 1 deletions

@@ -19,9 +19,11 @@ public:
 
   void tick(double dt) override;
 
+  void destroySprite(int spriteId) override;
+
   bool mapHasScript(std::string mapName, std::string scriptName);
 
-  void runScript(std::string mapName, std::string scriptName);
+  void runScript(std::string mapName, std::string scriptName, int linkedSprite = -1);
 
   void runDebugScript(std::string script);
 
@@ -33,6 +35,7 @@ private:
     std::unique_ptr<sol::thread> runner;
     std::unique_ptr<sol::coroutine> callable;
     std::string debugInfo;
+    int linkedSprite = -1;
   };
 
   Game& game_;