Custom Asteroids-inspired updates.

src/DiscoverableObjectUtil.cs

@@ -3,7 +3,7 @@ public static class DiscoverableObjectsUtil
 {
 	/// <summary>Generates an suitably science-y asteroid name</summary>
 	///  
-	/// <returns>A random string of the form "XXX-###".</returns>
+	/// <returns>A random string of the form "Ast. XXX-###".</returns>
 	///
 	public static extern string GenerateAsteroidName();
 }

src/Game.cs

@@ -0,0 +1,105 @@
+using UnityEngine;
+
+public class Game {
+	public ConfigNode config;
+
+	public uint launchID;
+
+	public string flagURL;
+
+	public int file_version_revision;
+
+	public int file_version_minor;
+
+	public int file_version_major;
+
+	public bool compatible;
+
+	public ConfigNode additionalSystems;
+
+	/// <summary>
+	/// A list of all scenario templates in the currently loaded game.
+	/// </summary>
+	/// 
+	/// <remarks>Since most ProtoScenarioModules contain a reference to the Scenario that represents 
+	/// them, this member is the easiest way to locate a specific Scenario in most cases. It is 
+	/// recommended that ProtoScenarioModules be searched by <c>ProtoScenarioModule.moduleName</c>, 
+	/// not by <c>ProtoScenarioModule.moduleRef</c>, as the latter may be null.</remarks>
+	public List<ProtoScenarioModule> scenarios;
+
+	public GameParameters Parameters;
+
+	public FlightState flightState;
+
+	public KerbalRoster CrewRoster;
+
+	public GameScenes startScene;
+
+	public Game.GameStatus Status;
+
+	public Game.Modes Mode;
+
+	public string linkCaption;
+
+	public string linkURL;
+
+	public string Description;
+
+	public string Title;
+
+	public EditorFacility editorFacility;
+
+	public double UniversalTime {
+		get;
+	}
+
+	/// <summary>
+	/// Creates a new scenario of the specified type. Once created, the scenario will persist 
+	/// automatically.
+	/// </summary>
+	/// <returns>A ProtoScenarioModule corresponding to the newly installed scenario.</returns>
+	/// <param name="typeOfScnModule">The scenario module to create. The object represented by 
+	/// this type must be a subclass of ScenarioModule.</param>
+	/// <param name="scenes">The scenes in which the scenario should automatically load itself.</param>
+	public extern ProtoScenarioModule AddProtoScenarioModule(Type typeOfScnModule, params GameScenes[] scenes);
+
+	public extern ProtoVessel AddVessel(ConfigNode protoVesselNode);
+
+	public extern bool DestroyVessel(Vessel v);
+
+	public extern bool IsResumable();
+
+	public extern void Load();
+
+	/// <summary>
+	/// Unregisters a ProtoScenarioModule from the game. It will not persist until the scenario 
+	/// is re-added.</summary>
+	/// <remarks>IMPORTANT: calling this method DOES NOT remove the Scenario object itself, which will 
+	/// continue to run until the next scene change.</remarks>
+	/// <returns><c>true</c>, if the ProtoScenarioModule was removed, <c>false</c> if it could not 
+	/// be found.</returns>
+	/// <param name="typeOfScnModule">The scenario module to de-persist. The object represented by 
+	/// this type must be a subclass of ScenarioModule.</param>
+	public extern bool RemoveProtoScenarioModule(Type typeOfScnModule);
+
+	public extern void Save(ConfigNode rootNode);
+
+	public extern void Start();
+
+	public extern Game Updated();
+
+	public enum GameStatus {
+		UNSTARTED,
+		ONGOING,
+		FAILED_OR_ABORTED,
+		COMPLETED
+	}
+
+	public enum Modes {
+		SANDBOX,
+		CAREER,
+		SCENARIO,
+		SCENARIO_NON_RESUMABLE,
+		SCIENCE_SANDBOX
+	}
+}

src/ScenarioDiscoverableObjects.cs

@@ -14,9 +14,6 @@
 /// asteroids already in the game exceeds spawnGroupMaxLimit. Because spawn checks happen 
 /// very frequently, the number of detected asteroids in a game where the player never 
 /// tracks an asteroid will almost always be close to spawnGroupMaxLimit.
-/// 
-/// The timing of spawn checks appears to be independent of the warp rate, but at high time warp 
-/// multiple asteroids may be spawned per check. (Needs confirmation)
 /// </remarks>
 public class ScenarioDiscoverableObjects : ScenarioModule
 {
@@ -52,11 +49,11 @@ public class ScenarioDiscoverableObjects : ScenarioModule
 	/// <summary>Number of seconds between asteroid checks</summary>
 	///
 	/// <remarks>
-	/// These are seconds of time spent playing KSP, regardless of the time warp rate. The faster 
-	///	your time warp, the longer the in-game interval between asteroid detections.
+	/// These are approximately seconds of in-game time, but if you make sudden changes 
+	/// in the time warp rate the spawner may need some time to catch up.
 	///
 	/// Since asteroids are removed during spawn checks, spawnInterval also controls the 
-	/// 	asteroid removal rate.
+	/// asteroid removal rate.
 	/// </remarks>
 	public float spawnInterval = 15.0f;