Add API for mods to interact with other mods' preloads

Assembly-CSharp/IMod.cs

@@ -29,6 +29,15 @@ public interface IMod : ILogger
         /// <returns>List of tuples containg scene names and the respective actions.</returns>
         (string, Func<IEnumerator>)[] PreloadSceneHooks();
 
+        /// <summary>
+        /// This function will be invoked on each gameObject preloaded through the <see cref="GetPreloadNames"/> system.
+        /// </summary>
+        /// <param name="go">The preloaded gameObject.</param>
+        /// <param name="sceneName">The scene the gameObject was preloaded from.</param>
+        /// <param name="goName">The path to the preloaded gameObject.</param>
+        void InvokeOnGameObjectPreloaded(GameObject go, string sceneName, string goName);
+
+
         /// <summary>
         ///     Called after preloading of all mods.
         /// </summary>

Assembly-CSharp/Mod.cs

@@ -118,7 +118,7 @@ private string GetGlobalSettingsPath()
                 Log("Overriding Global Settings path with Mod directory");
                 return globalSettingsOverride;
             }
-            
+
             return Path.Combine(Application.persistentDataPath, globalSettingsFileName);
         }
 
@@ -148,6 +148,14 @@ public string GetName()
         /// <returns>List of tuples containg scene names and the respective actions.</returns>
         public virtual (string, Func<IEnumerator>)[] PreloadSceneHooks() => Array.Empty<(string, Func<IEnumerator>)>();
 
+        /// <summary>
+        /// This function will be invoked on each gameObject preloaded through the <see cref="GetPreloadNames"/> system.
+        /// </summary>
+        /// <param name="go">The preloaded gameObject.</param>
+        /// <param name="sceneName">The scene the gameObject was preloaded from.</param>
+        /// <param name="goName">The path to the preloaded gameObject.</param>
+        public virtual void InvokeOnGameObjectPreloaded(GameObject go, string sceneName, string goName) { }
+
         /// <inheritdoc />
         /// <summary>
         ///     Called after preloading of all mods.

Assembly-CSharp/ModLoader.cs

@@ -249,6 +249,14 @@ Assembly Resolve(object sender, ResolveEventArgs args)
                 yield return pld.Preload(toPreload, preloadedObjects, sceneHooks);
             }
 
+            foreach ((string sceneName, Dictionary<string, GameObject> goMap) in preloadedObjects.Values.SelectMany(x => x))
+            {
+                foreach ((string goName, GameObject go) in goMap)
+                {
+                    OnPreloadedObject(go, sceneName, goName);
+                }
+            }
+
             foreach (ModInstance mod in orderedMods)
             {
                 if (mod.Error is not null)
@@ -466,6 +474,17 @@ internal static void UnloadMod(ModInstance mod, bool updateModText = true)
             if (updateModText) UpdateModText();
         }
 
+        public static void OnPreloadedObject(GameObject go, string sceneName, string goName)
+        {
+            foreach (ModInstance modInstance in ModInstances)
+            {
+                if (modInstance.Error is not null)
+                    continue;
+
+                modInstance.Mod.InvokeOnGameObjectPreloaded(go, sceneName, goName);
+            }
+        }
+
         // Essentially the state of a loaded **mod**. The assembly has nothing to do directly with mods.
         public class ModInstance
         {