public static string AttemptSpawn(Vector3D startCoords, List <string> eligibleNames = null)
        {
            if (Settings.General.UseMaxNpcGrids == true)
            {
                var totalNPCs = NPCWatcher.ActiveNPCs.Count;

                if (totalNPCs >= Settings.General.MaxGlobalNpcGrids)
                {
                    return("Spawning Aborted. Max Global NPCs Limit Reached.");
                }
            }

            if (NPCWatcher.ActiveNpcTypeLimitReachedForArea("PlanetaryCargoShip", startCoords, Settings.PlanetaryCargoShips.MaxShipsPerArea, Settings.PlanetaryCargoShips.AreaSize) == true)
            {
                return("Too Many Planetary Cargo Ship Grids in Player Area");
            }

            MyPlanet planet = SpawnResources.GetNearestPlanet(startCoords);

            if (SpawnResources.GetDistanceFromSurface(startCoords, planet) > Settings.PlanetaryCargoShips.PlayerSurfaceAltitude)
            {
                return("Player Is Too Far From Planet Surface.");
            }

            KnownPlayerLocationManager.CleanExpiredLocations();
            var validFactions  = new Dictionary <string, List <string> >();
            var spawnGroupList = GetPlanetaryCargoShips(startCoords, eligibleNames, out validFactions);

            if (Settings.General.UseModIdSelectionForSpawning == true)
            {
                spawnGroupList = SpawnResources.SelectSpawnGroupSublist(SpawnGroupSublists, EligibleSpawnsByModId);
            }

            if (spawnGroupList.Count == 0)
            {
                return("No Eligible Spawn Groups Could Be Found To Spawn Near Player.");
            }

            var spawnGroup = spawnGroupList[SpawnResources.rnd.Next(0, spawnGroupList.Count)];

            Vector3D startPathCoords = Vector3D.Zero;
            Vector3D endPathCoords   = Vector3D.Zero;
            MatrixD  startMatrix     = MatrixD.CreateWorld(Vector3D.Zero, Vector3D.Forward, Vector3D.Up);

            bool successfulPath = CalculateAtmoTravelPath(spawnGroup, startCoords, planet, out startPathCoords, out endPathCoords, out startMatrix);

            if (successfulPath == false)
            {
                return("Could Not Generate Safe Travel Path For SpawnGroup.");
            }

            //Get Directions
            var  spawnForwardDir = startMatrix.Forward;
            var  spawnUpDir      = startMatrix.Up;
            var  spawnMatrix     = startMatrix;
            long gridOwner       = 0;
            var  randFactionTag  = spawnGroup.FactionOwner;

            if (validFactions.ContainsKey(spawnGroup.SpawnGroupName))
            {
                randFactionTag = validFactions[spawnGroup.SpawnGroupName][SpawnResources.rnd.Next(0, validFactions[spawnGroup.SpawnGroupName].Count)];
            }

            if (NPCWatcher.NPCFactionTagToFounder.ContainsKey(randFactionTag) == true)
            {
                gridOwner = NPCWatcher.NPCFactionTagToFounder[randFactionTag];
            }
            else
            {
                Logger.AddMsg("Could Not Find Faction Founder For: " + randFactionTag);
            }

            foreach (var prefab in spawnGroup.SpawnGroup.Prefabs)
            {
                if (spawnGroup.UseKnownPlayerLocations)
                {
                    KnownPlayerLocationManager.IncreaseSpawnCountOfLocations(startCoords, randFactionTag);
                }

                var options       = SpawnGroupManager.CreateSpawningOptions(spawnGroup, prefab);
                var spawnPosition = Vector3D.Transform((Vector3D)prefab.Position, spawnMatrix);
                var speedL        = prefab.Speed;
                var speedA        = Vector3.Zero;
                var gridList      = new List <IMyCubeGrid>();


                //Speed Management
                if (Settings.PlanetaryCargoShips.UseMinimumSpeed == true && prefab.Speed < Settings.PlanetaryCargoShips.MinimumSpeed)
                {
                    speedL = Settings.PlanetaryCargoShips.MinimumSpeed;
                }

                if (Settings.PlanetaryCargoShips.UseSpeedOverride == true)
                {
                    speedL = Settings.PlanetaryCargoShips.SpeedOverride;
                }



                /*//Character Injection - Start
                 * MyPrefabDefinition prefabDefB = null;
                 *
                 * if(SpawnGroupManager.prefabBackupList.ContainsKey(prefab.SubtypeId) == true){
                 *
                 *      prefabDefB = MyDefinitionManager.Static.GetPrefabDefinition(prefab.SubtypeId);
                 *
                 *      if(SpawnGroupManager.prefabBackupList[prefab.SubtypeId].Count == prefabDefB.CubeGrids.Length){
                 *
                 *              for(int i = 0; i < SpawnGroupManager.prefabBackupList[prefab.SubtypeId].Count; i++){
                 *
                 *                      var clonedGridOb = SpawnGroupManager.prefabBackupList[prefab.SubtypeId][i].Clone();
                 *                      prefabDefB.CubeGrids[i] = clonedGridOb as MyObjectBuilder_CubeGrid;
                 *
                 *              }
                 *
                 *      }
                 *
                 *      SpawnGroupManager.prefabBackupList.Remove(prefab.SubtypeId);
                 *
                 * }
                 *
                 * var injectedCharacters = false;
                 * if(spawnGroup.FillSeatsWithNpcCrew == true){
                 *
                 *      injectedCharacters = true;
                 *
                 *      if(prefabDefB == null){
                 *
                 *              prefabDefB = MyDefinitionManager.Static.GetPrefabDefinition(prefab.SubtypeId);
                 *
                 *      }
                 *
                 *      var backupGridList = new List<MyObjectBuilder_CubeGrid>();
                 *
                 *      for(int i = 0; i < prefabDefB.CubeGrids.Length; i++){
                 *
                 *              var clonedGridOb = prefabDefB.CubeGrids[i].Clone();
                 *              backupGridList.Add(clonedGridOb as MyObjectBuilder_CubeGrid);
                 *              GridUtilities.CreateAndAttachCrew(prefabDefB.CubeGrids[i], spawnGroup, gridOwner);
                 *
                 *      }
                 *
                 *      if(SpawnGroupManager.prefabBackupList.ContainsKey(prefab.SubtypeId) == false){
                 *
                 *              SpawnGroupManager.prefabBackupList.Add(prefab.SubtypeId, backupGridList);
                 *
                 *      }
                 *
                 * }
                 * //Character Injection - End*/

                //Grid Manipulation
                GridBuilderManipulation.ProcessPrefabForManipulation(prefab.SubtypeId, spawnGroup, "PlanetaryCargoShip", prefab.Behaviour);

                try{
                    MyAPIGateway.PrefabManager.SpawnPrefab(gridList, prefab.SubtypeId, spawnPosition, spawnForwardDir, spawnUpDir, Vector3.Zero, Vector3.Zero, !string.IsNullOrWhiteSpace(prefab.BeaconText) ? prefab.BeaconText : null, options, gridOwner);
                }catch (Exception exc) {
                }

                var pendingNPC = new ActiveNPC();
                pendingNPC.SpawnGroup            = spawnGroup;
                pendingNPC.SpawnGroupName        = spawnGroup.SpawnGroupName;
                pendingNPC.InitialFaction        = randFactionTag;
                pendingNPC.faction               = MyAPIGateway.Session.Factions.TryGetFactionByTag(pendingNPC.InitialFaction);
                pendingNPC.Name                  = prefab.SubtypeId;
                pendingNPC.GridName              = MyDefinitionManager.Static.GetPrefabDefinition(prefab.SubtypeId).CubeGrids[0].DisplayName;
                pendingNPC.StartCoords           = startPathCoords;
                pendingNPC.CurrentCoords         = startPathCoords;
                pendingNPC.EndCoords             = endPathCoords;
                pendingNPC.AutoPilotSpeed        = speedL;
                pendingNPC.Planet                = planet;
                pendingNPC.SpawnType             = "PlanetaryCargoShip";
                pendingNPC.CleanupIgnore         = spawnGroup.IgnoreCleanupRules;
                pendingNPC.ForceStaticGrid       = spawnGroup.ForceStaticGrid;
                pendingNPC.KeenAiName            = prefab.Behaviour;
                pendingNPC.KeenAiTriggerDistance = prefab.BehaviourActivationDistance;

                if (spawnGroup.RandomizeWeapons == true)
                {
                    pendingNPC.ReplenishedSystems = false;
                    pendingNPC.ReplacedWeapons    = true;
                }
                else if ((MES_SessionCore.NPCWeaponUpgradesModDetected == true || Settings.General.EnableGlobalNPCWeaponRandomizer == true) && spawnGroup.IgnoreWeaponRandomizerMod == false)
                {
                    pendingNPC.ReplenishedSystems = false;
                    pendingNPC.ReplacedWeapons    = true;
                }
                else if (spawnGroup.ReplenishSystems == true)
                {
                    pendingNPC.ReplenishedSystems = false;
                }

                NPCWatcher.PendingNPCs.Add(pendingNPC);
            }

            Logger.SkipNextMessage = false;
            return("Spawning Group - " + spawnGroup.SpawnGroup.Id.SubtypeName);
        }
        public static string AttemptSpawn(Vector3D startCoords, IMyPlayer player)
        {
            if (Settings.General.UseMaxNpcGrids == true)
            {
                var totalNPCs = NPCWatcher.ActiveNPCs.Count;

                if (totalNPCs >= Settings.General.MaxGlobalNpcGrids)
                {
                    return("Spawning Aborted. Max Global NPCs Limit Reached.");
                }
            }

            if (NPCWatcher.ActiveNpcTypeLimitReachedForArea("PlanetaryInstallation", startCoords, Settings.PlanetaryInstallations.MaxShipsPerArea, Settings.PlanetaryInstallations.AreaSize) == true)
            {
                return("Too Many Planetary Installation Grids in Player Area");
            }

            MyPlanet planet = SpawnResources.GetNearestPlanet(startCoords);

            if (planet == null)
            {
                return("No Planets In Game World Found.");
            }
            else
            {
                if (SpawnResources.GetDistanceFromSurface(startCoords, planet) > Settings.PlanetaryInstallations.PlayerMaximumDistanceFromSurface || SpawnResources.IsPositionInGravity(startCoords, planet) == false)
                {
                    return("Player Not In Planet Gravity Or Too Far From Surface.");
                }
            }

            var planetEntity = planet as IMyEntity;

            if (MES_SessionCore.playerWatchList.ContainsKey(player) == true)
            {
                var playerSurface = SpawnResources.GetNearestSurfacePoint(player.GetPosition(), planet);

                if (MES_SessionCore.playerWatchList[player].InstallationDistanceCoordCheck == Vector3D.Zero)
                {
                    MES_SessionCore.playerWatchList[player].InstallationDistanceCoordCheck = playerSurface;
                    return("New Player Detected. Storing Position On Planet.");
                }

                if (Vector3D.Distance(MES_SessionCore.playerWatchList[player].InstallationDistanceCoordCheck, playerSurface) < Settings.PlanetaryInstallations.PlayerDistanceSpawnTrigger)
                {
                    Logger.AddMsg("Player Travelled: " + Vector3D.Distance(MES_SessionCore.playerWatchList[player].InstallationDistanceCoordCheck, playerSurface) + " Distance From Last Saved Position.");
                    return("Player Hasn't Traveled Far Enough Yet.");
                }

                MES_SessionCore.playerWatchList[player].InstallationDistanceCoordCheck = playerSurface;
            }
            else
            {
                return("Player Not In Watcher List... Although They Probably Should Be If The Script Got Here.");
            }

            var smallStations  = new List <ImprovedSpawnGroup>();
            var mediumStations = new List <ImprovedSpawnGroup>();
            var largeStations  = new List <ImprovedSpawnGroup>();
            var validFactions  = new Dictionary <string, List <string> >();
            var spawnGroupList = GetPlanetaryInstallations(startCoords, out smallStations, out mediumStations, out largeStations, out validFactions);

            if (Settings.General.UseModIdSelectionForSpawning == true)
            {
                spawnGroupList = SpawnResources.SelectSpawnGroupSublist(SpawnGroupSublists, EligibleSpawnsByModId);
                smallStations  = SpawnResources.SelectSpawnGroupSublist(SmallSpawnGroupSublists, EligibleSmallSpawnsByModId);
                mediumStations = SpawnResources.SelectSpawnGroupSublist(MediumSpawnGroupSublists, EligibleMediumSpawnsByModId);
                largeStations  = SpawnResources.SelectSpawnGroupSublist(LargeSpawnGroupSublists, EligibleLargeSpawnsByModId);
            }

            if (spawnGroupList.Count == 0)
            {
                return("No Eligible Spawn Groups Could Be Found To Spawn Near Player.");
            }

            Logger.AddMsg("Found " + (spawnGroupList.Count / 10).ToString() + " Potential Spawn Groups. Small: " + (smallStations.Count / 10).ToString() + " // Medium: " + (mediumStations.Count / 10).ToString() + " // Large: " + (largeStations.Count / 10).ToString(), true);

            string stationSize = "Small";

            spawnGroupList = smallStations;

            bool skippedAbsentSmall  = false;
            bool skippedAbsentMedium = false;
            bool skippedAbsentLarge  = false;

            //Start With Small Station Always, Try Chance For Medium.
            if (stationSize == "Small" && smallStations.Count == 0)
            {
                //No Small Stations Available For This Area, So Try Medium.
                skippedAbsentSmall = true;
                stationSize        = "Medium";
                spawnGroupList     = mediumStations;
            }
            else if (stationSize == "Small" && smallStations.Count != 0)
            {
                int    mediumChance = 0;
                string varName      = "MES-" + planetEntity.EntityId.ToString() + "-Medium";

                if (MyAPIGateway.Utilities.GetVariable <int>(varName, out mediumChance) == false)
                {
                    mediumChance = Settings.PlanetaryInstallations.MediumSpawnChanceBaseValue;
                    MyAPIGateway.Utilities.SetVariable <int>(varName, mediumChance);
                }

                if (SpawnResources.rnd.Next(0, 100) < mediumChance)
                {
                    stationSize    = "Medium";
                    spawnGroupList = mediumStations;
                }
            }

            if (stationSize == "Medium" && mediumStations.Count == 0)
            {
                //No Medium Stations Available For This Area, So Try Large.
                skippedAbsentMedium = true;
                stationSize         = "Large";
                spawnGroupList      = largeStations;
            }
            else if (stationSize == "Medium" && mediumStations.Count != 0)
            {
                int    largeChance = 0;
                string varName     = "MES-" + planetEntity.EntityId.ToString() + "-Large";

                if (MyAPIGateway.Utilities.GetVariable <int>(varName, out largeChance) == false)
                {
                    largeChance = Settings.PlanetaryInstallations.LargeSpawnChanceBaseValue;
                    MyAPIGateway.Utilities.SetVariable <int>(varName, largeChance);
                }

                if (SpawnResources.rnd.Next(0, 100) < largeChance)
                {
                    stationSize    = "Large";
                    spawnGroupList = largeStations;
                }
            }

            if (stationSize == "Large" && largeStations.Count == 0)
            {
                skippedAbsentLarge = true;
                stationSize        = "Medium";
                spawnGroupList     = mediumStations;

                if (mediumStations.Count == 0)
                {
                    skippedAbsentMedium = true;
                    stationSize         = "Small";
                    spawnGroupList      = smallStations;
                }
            }

            if (spawnGroupList.Count == 0)
            {
                return("Could Not Find Station Of Suitable Size For This Spawn Instance.");
            }

            var      spawnGroup  = spawnGroupList[SpawnResources.rnd.Next(0, spawnGroupList.Count)];
            Vector3D spawnCoords = Vector3D.Zero;

            Logger.StartTimer();

            if (GetSpawnCoords(spawnGroup, startCoords, out spawnCoords) == false)
            {
                Logger.AddMsg("Planetary Installation Spawn Coord Calculation Time: " + Logger.StopTimer(), true);
                return("Could Not Find Safe Position To Spawn " + stationSize + " Installation.");
            }

            Logger.AddMsg("Planetary Installation Spawn Coord Calculation Time: " + Logger.StopTimer(), true);

            //Get Directions
            var upDir                = Vector3D.Normalize(spawnCoords - planetEntity.GetPosition());
            var forwardDir           = Vector3D.CalculatePerpendicularVector(upDir);
            var spawnMatrix          = MatrixD.CreateWorld(spawnCoords, forwardDir, upDir);
            var successfulVoxelSpawn = false;

            foreach (var voxel in spawnGroup.SpawnGroup.Voxels)
            {
                var voxelSpawningPosition = Vector3D.Transform((Vector3D)voxel.Offset, spawnMatrix);

                try{
                    var voxelSpawn = MyAPIGateway.Session.VoxelMaps.CreateVoxelMapFromStorageName(voxel.StorageName, voxel.StorageName, voxelSpawningPosition);

                    if (Settings.PlanetaryInstallations.RemoveVoxelsIfGridRemoved == true && spawnGroup.RemoveVoxelsIfGridRemoved == true)
                    {
                        NPCWatcher.SpawnedVoxels.Add(voxelSpawn.EntityId.ToString(), voxelSpawn as IMyEntity);
                    }

                    successfulVoxelSpawn = true;
                }catch (Exception exc) {
                    Logger.AddMsg("Voxel Spawning For " + voxel.StorageName + " Failed");
                }
            }

            if (successfulVoxelSpawn == true)
            {
                var      voxelIdList  = new List <string>(NPCWatcher.SpawnedVoxels.Keys.ToList());
                string[] voxelIdArray = voxelIdList.ToArray();
                MyAPIGateway.Utilities.SetVariable <string[]>("MES-SpawnedVoxels", voxelIdArray);
            }

            long gridOwner      = 0;
            var  randFactionTag = spawnGroup.FactionOwner;

            if (validFactions.ContainsKey(spawnGroup.SpawnGroupName))
            {
                randFactionTag = validFactions[spawnGroup.SpawnGroupName][SpawnResources.rnd.Next(0, validFactions[spawnGroup.SpawnGroupName].Count)];
            }

            if (NPCWatcher.NPCFactionTagToFounder.ContainsKey(randFactionTag) == true)
            {
                gridOwner = NPCWatcher.NPCFactionTagToFounder[randFactionTag];
            }
            else
            {
                Logger.AddMsg("Could Not Find Faction Founder For: " + randFactionTag);
            }

            for (int i = 0; i < spawnGroup.SpawnGroup.Prefabs.Count; i++)
            {
                var prefab        = spawnGroup.SpawnGroup.Prefabs[i];
                var options       = SpawnGroupManager.CreateSpawningOptions(spawnGroup, prefab);
                var spawnPosition = Vector3D.Transform((Vector3D)prefab.Position, spawnMatrix);

                //Realign to Terrain
                var offsetSurfaceCoords = SpawnResources.GetNearestSurfacePoint(spawnPosition, planet);
                var offsetSurfaceMatrix = MatrixD.CreateWorld(offsetSurfaceCoords, forwardDir, upDir);
                var finalCoords         = Vector3D.Transform(new Vector3D(0, (double)prefab.Position.Y, 0), offsetSurfaceMatrix);

                var newForward = offsetSurfaceMatrix.Forward;
                var newUp      = offsetSurfaceMatrix.Up;

                GetReversedForwardDirections(spawnGroup, i, ref newForward);
                GetDerelictDirections(spawnGroup, i, finalCoords, ref newForward, ref newUp);

                var speedL   = Vector3.Zero;
                var speedA   = Vector3.Zero;
                var gridList = new List <IMyCubeGrid>();

                //Grid Manipulation
                GridBuilderManipulation.ProcessPrefabForManipulation(prefab.SubtypeId, spawnGroup, "PlanetaryInstallation", prefab.Behaviour);

                try{
                    MyAPIGateway.PrefabManager.SpawnPrefab(gridList, prefab.SubtypeId, finalCoords, newForward, newUp, speedL, speedA, prefab.BeaconText, options, gridOwner);
                }catch (Exception exc) {
                }

                Logger.AddMsg("Installation Forward Vector: " + newForward.ToString(), true);
                var pendingNPC = new ActiveNPC();
                pendingNPC.SpawnGroup            = spawnGroup;
                pendingNPC.SpawnGroupName        = spawnGroup.SpawnGroupName;
                pendingNPC.InitialFaction        = randFactionTag;
                pendingNPC.faction               = MyAPIGateway.Session.Factions.TryGetFactionByTag(pendingNPC.InitialFaction);
                pendingNPC.Name                  = prefab.SubtypeId;
                pendingNPC.GridName              = MyDefinitionManager.Static.GetPrefabDefinition(prefab.SubtypeId).CubeGrids[0].DisplayName;
                pendingNPC.StartCoords           = finalCoords;
                pendingNPC.CurrentCoords         = finalCoords;
                pendingNPC.EndCoords             = finalCoords;
                pendingNPC.SpawnType             = "PlanetaryInstallation";
                pendingNPC.CleanupIgnore         = spawnGroup.IgnoreCleanupRules;
                pendingNPC.ForceStaticGrid       = spawnGroup.ForceStaticGrid;
                pendingNPC.KeenAiName            = prefab.Behaviour;
                pendingNPC.KeenAiTriggerDistance = prefab.BehaviourActivationDistance;

                if (spawnGroup.RandomizeWeapons == true)
                {
                    pendingNPC.ReplenishedSystems = false;
                    pendingNPC.ReplacedWeapons    = true;
                }
                else if ((MES_SessionCore.NPCWeaponUpgradesModDetected == true || Settings.General.EnableGlobalNPCWeaponRandomizer == true) && spawnGroup.IgnoreWeaponRandomizerMod == false)
                {
                    pendingNPC.ReplenishedSystems = false;
                    pendingNPC.ReplacedWeapons    = true;
                }
                else if (spawnGroup.ReplenishSystems == true)
                {
                    pendingNPC.ReplenishedSystems = false;
                }

                NPCWatcher.PendingNPCs.Add(pendingNPC);
            }

            if (spawnGroup.PlanetaryInstallationType == "Small")
            {
                int    mediumChance = 0;
                string varName      = "MES-" + planetEntity.EntityId.ToString() + "-Medium";
                if (MyAPIGateway.Utilities.GetVariable <int>(varName, out mediumChance) == true)
                {
                    mediumChance += Settings.PlanetaryInstallations.MediumSpawnChanceIncrement;
                    MyAPIGateway.Utilities.SetVariable <int>(varName, mediumChance);
                }

                Logger.AddMsg("Medium Installation Spawning Chance Now Set To: " + mediumChance.ToString() + " / 100", true);
            }

            if (spawnGroup.PlanetaryInstallationType == "Medium" || skippedAbsentMedium == true)
            {
                int    mediumChance = 0;
                string varName      = "MES-" + planetEntity.EntityId.ToString() + "-Medium";
                if (MyAPIGateway.Utilities.GetVariable <int>(varName, out mediumChance) == true)
                {
                    mediumChance = Settings.PlanetaryInstallations.MediumSpawnChanceBaseValue;
                    MyAPIGateway.Utilities.SetVariable <int>(varName, mediumChance);
                }

                Logger.AddMsg("Medium Installation Spawning Chance Now Set To: " + mediumChance.ToString() + " / 100", true);

                int largeChance = 0;
                varName = "MES-" + planetEntity.EntityId.ToString() + "-Large";
                if (MyAPIGateway.Utilities.GetVariable <int>(varName, out largeChance) == true)
                {
                    largeChance += Settings.PlanetaryInstallations.LargeSpawnChanceIncrement;
                    MyAPIGateway.Utilities.SetVariable <int>(varName, largeChance);
                }

                Logger.AddMsg("Large Installation Spawning Chance Now Set To: " + largeChance.ToString() + " / 100", true);
            }

            if (spawnGroup.PlanetaryInstallationType == "Large" || skippedAbsentLarge == true)
            {
                int    largeChance = 0;
                string varName     = "MES-" + planetEntity.EntityId.ToString() + "-Large";
                if (MyAPIGateway.Utilities.GetVariable <int>(varName, out largeChance) == true)
                {
                    largeChance = Settings.PlanetaryInstallations.LargeSpawnChanceBaseValue;
                    MyAPIGateway.Utilities.SetVariable <int>(varName, largeChance);
                }

                Logger.AddMsg("Large Installation Spawning Chance Now Set To: " + largeChance.ToString() + " / 100", true);
            }

            if (spawnGroup.UniqueEncounter == true)
            {
                SpawnGroupManager.UniqueGroupsSpawned.Add(spawnGroup.SpawnGroup.Id.SubtypeName);
                string[] uniqueSpawnedArray = SpawnGroupManager.UniqueGroupsSpawned.ToArray();
                MyAPIGateway.Utilities.SetVariable <string[]>("MES-UniqueGroupsSpawned", uniqueSpawnedArray);
            }

            Logger.SkipNextMessage = false;
            return("Spawning Group - " + spawnGroup.SpawnGroup.Id.SubtypeName);
        }
        public static string AttemptSpawn(Vector3D startCoords, List <string> eligibleNames = null)
        {
            if (Settings.General.UseMaxNpcGrids == true)
            {
                var totalNPCs = NPCWatcher.ActiveNPCs.Count;

                if (totalNPCs >= Settings.General.MaxGlobalNpcGrids)
                {
                    return("Spawning Aborted. Max Global NPCs Limit Reached.");
                }
            }

            if (NPCWatcher.ActiveNpcTypeLimitReachedForArea("RandomEncounter", startCoords, Settings.RandomEncounters.MaxShipsPerArea, Settings.RandomEncounters.AreaSize) == true)
            {
                return("Too Many Random Encounter Grids in Player Area");
            }

            KnownPlayerLocationManager.CleanExpiredLocations();
            var validFactions  = new Dictionary <string, List <string> >();
            var spawnGroupList = GetRandomEncounters(startCoords, eligibleNames, out validFactions);

            if (Settings.General.UseModIdSelectionForSpawning == true)
            {
                spawnGroupList = SpawnResources.SelectSpawnGroupSublist(SpawnGroupSublists, EligibleSpawnsByModId);
            }

            if (spawnGroupList.Count == 0)
            {
                return("No Eligible Spawn Groups Could Be Found To Spawn Near Player.");
            }

            var      spawnGroup  = spawnGroupList[SpawnResources.rnd.Next(0, spawnGroupList.Count)];
            Vector3D spawnCoords = Vector3D.Zero;

            if (GetSpawnCoords(spawnGroup, startCoords, out spawnCoords) == false)
            {
                return("Could Not Find Safe Position To Spawn Encounter");
            }

            //Get Directions
            var spawnMatrix          = MatrixD.CreateWorld(spawnCoords);
            var successfulVoxelSpawn = false;
            var centerVoxelOffset    = false;

            foreach (var voxel in spawnGroup.SpawnGroup.Voxels)
            {
                spawnGroup.RotateFirstCockpitToForward = false;
                var voxelSpawningPosition = Vector3D.Transform((Vector3D)voxel.Offset, spawnMatrix);

                try {
                    var voxelSpawn = MyAPIGateway.Session.VoxelMaps.CreateVoxelMapFromStorageName(voxel.StorageName, voxel.StorageName, voxelSpawningPosition);

                    if (Settings.RandomEncounters.RemoveVoxelsIfGridRemoved == true && spawnGroup.RemoveVoxelsIfGridRemoved == true)
                    {
                        NPCWatcher.SpawnedVoxels.Add(voxelSpawn.EntityId.ToString(), voxelSpawn as IMyEntity);
                    }

                    successfulVoxelSpawn = true;
                } catch (Exception exc) {
                    Logger.AddMsg("Voxel Spawning For " + voxel.StorageName + " Failed");
                }
            }

            if (successfulVoxelSpawn == true)
            {
                var      voxelIdList  = new List <string>(NPCWatcher.SpawnedVoxels.Keys.ToList());
                string[] voxelIdArray = voxelIdList.ToArray();
                MyAPIGateway.Utilities.SetVariable <string[]>("MES-SpawnedVoxels", voxelIdArray);
            }

            long gridOwner      = 0;
            var  randFactionTag = spawnGroup.FactionOwner;

            if (validFactions.ContainsKey(spawnGroup.SpawnGroupName))
            {
                randFactionTag = validFactions[spawnGroup.SpawnGroupName][SpawnResources.rnd.Next(0, validFactions[spawnGroup.SpawnGroupName].Count)];
            }

            if (NPCWatcher.NPCFactionTagToFounder.ContainsKey(randFactionTag) == true)
            {
                gridOwner = NPCWatcher.NPCFactionTagToFounder[randFactionTag];
            }
            else
            {
                Logger.AddMsg("Could Not Find Faction Founder For: " + randFactionTag);
            }

            foreach (var prefab in spawnGroup.SpawnGroup.Prefabs)
            {
                if (spawnGroup.UseKnownPlayerLocations)
                {
                    KnownPlayerLocationManager.IncreaseSpawnCountOfLocations(startCoords, randFactionTag);
                }

                var options       = SpawnGroupManager.CreateSpawningOptions(spawnGroup, prefab);
                var spawnPosition = Vector3D.Transform((Vector3D)prefab.Position * (centerVoxelOffset ? 1 : 1), spawnMatrix);

                Logger.CreateDebugGPS("Prefab Spawn Coords", spawnPosition);
                var speedL   = Vector3.Zero;
                var speedA   = Vector3.Zero;
                var gridList = new List <IMyCubeGrid>();

                //Grid Manipulation
                GridBuilderManipulation.ProcessPrefabForManipulation(prefab.SubtypeId, spawnGroup, "RandomEncounter", prefab.Behaviour);

                try{
                    MyAPIGateway.PrefabManager.SpawnPrefab(gridList, prefab.SubtypeId, spawnPosition, spawnMatrix.Forward, spawnMatrix.Up, speedL, speedA, !string.IsNullOrWhiteSpace(prefab.BeaconText) ? prefab.BeaconText : null, options, gridOwner);
                }catch (Exception exc) {
                }

                var pendingNPC = new ActiveNPC();
                pendingNPC.SpawnGroupName        = spawnGroup.SpawnGroupName;
                pendingNPC.SpawnGroup            = spawnGroup;
                pendingNPC.InitialFaction        = randFactionTag;
                pendingNPC.faction               = MyAPIGateway.Session.Factions.TryGetFactionByTag(pendingNPC.InitialFaction);
                pendingNPC.Name                  = prefab.SubtypeId;
                pendingNPC.GridName              = MyDefinitionManager.Static.GetPrefabDefinition(prefab.SubtypeId).CubeGrids[0].DisplayName;
                pendingNPC.StartCoords           = spawnCoords;
                pendingNPC.CurrentCoords         = spawnCoords;
                pendingNPC.EndCoords             = spawnCoords;
                pendingNPC.SpawnType             = "RandomEncounter";
                pendingNPC.CleanupIgnore         = spawnGroup.IgnoreCleanupRules;
                pendingNPC.ForceStaticGrid       = spawnGroup.ForceStaticGrid;
                pendingNPC.KeenAiName            = prefab.Behaviour;
                pendingNPC.KeenAiTriggerDistance = prefab.BehaviourActivationDistance;

                if (spawnGroup.RandomizeWeapons == true)
                {
                    pendingNPC.ReplenishedSystems = false;
                    pendingNPC.ReplacedWeapons    = true;
                }
                else if ((MES_SessionCore.NPCWeaponUpgradesModDetected == true || Settings.General.EnableGlobalNPCWeaponRandomizer == true) && spawnGroup.IgnoreWeaponRandomizerMod == false)
                {
                    pendingNPC.ReplenishedSystems = false;
                    pendingNPC.ReplacedWeapons    = true;
                }
                else if (spawnGroup.ReplenishSystems == true)
                {
                    pendingNPC.ReplenishedSystems = false;
                }

                NPCWatcher.PendingNPCs.Add(pendingNPC);
            }

            Logger.SkipNextMessage = false;
            return("Spawning Group - " + spawnGroup.SpawnGroup.Id.SubtypeName);
        }
        public static string AttemptSpawn(Vector3D startCoords)
        {
            if (Settings.General.UseMaxNpcGrids == true)
            {
                var totalNPCs = NPCWatcher.ActiveNPCs.Count;

                if (totalNPCs >= Settings.General.MaxGlobalNpcGrids)
                {
                    return("Spawning Aborted. Max Global NPCs Limit Reached.");
                }
            }

            if (NPCWatcher.ActiveNpcTypeLimitReachedForArea("SpaceCargoShip", startCoords, Settings.SpaceCargoShips.MaxShipsPerArea, Settings.SpaceCargoShips.AreaSize) == true)
            {
                return("Too Many Space Cargo Ship Grids in Player Area");
            }

            var validFactions  = new Dictionary <string, List <string> >();
            var spawnGroupList = GetSpaceCargoShips(startCoords, out validFactions);

            if (Settings.General.UseModIdSelectionForSpawning == true)
            {
                spawnGroupList = SpawnResources.SelectSpawnGroupSublist(SpawnGroupSublists, EligibleSpawnsByModId);
            }

            if (spawnGroupList.Count == 0)
            {
                return("No Eligible Spawn Groups Could Be Found To Spawn Near Player.");
            }

            var      spawnGroup      = spawnGroupList[SpawnResources.rnd.Next(0, spawnGroupList.Count)];
            var      startPathCoords = Vector3D.Zero;
            var      endPathCoords   = Vector3D.Zero;
            bool     successfulPath  = false;
            MyPlanet planet          = SpawnResources.GetNearestPlanet(startCoords);

            if (SpawnResources.LunarSpawnEligible(startCoords) == false)
            {
                successfulPath = CalculateRegularTravelPath(spawnGroup.SpawnGroup, startCoords, out startPathCoords, out endPathCoords);
            }
            else
            {
                successfulPath = CalculateLunarTravelPath(spawnGroup.SpawnGroup, startCoords, out startPathCoords, out endPathCoords);
            }

            if (successfulPath == false)
            {
                return("Could Not Generate Safe Travel Path For SpawnGroup.");
            }

            //Get Directions
            var  spawnForwardDir = Vector3D.Normalize(endPathCoords - startPathCoords);
            var  spawnUpDir      = Vector3D.CalculatePerpendicularVector(spawnForwardDir);
            var  spawnMatrix     = MatrixD.CreateWorld(startPathCoords, spawnForwardDir, spawnUpDir);
            long gridOwner       = 0;
            var  randFactionTag  = spawnGroup.FactionOwner;

            if (validFactions.ContainsKey(spawnGroup.SpawnGroupName))
            {
                randFactionTag = validFactions[spawnGroup.SpawnGroupName][SpawnResources.rnd.Next(0, validFactions[spawnGroup.SpawnGroupName].Count)];
            }

            if (NPCWatcher.NPCFactionTagToFounder.ContainsKey(randFactionTag) == true)
            {
                gridOwner = NPCWatcher.NPCFactionTagToFounder[randFactionTag];
            }
            else
            {
                Logger.AddMsg("Could Not Find Faction Founder For: " + randFactionTag);
            }

            foreach (var prefab in spawnGroup.SpawnGroup.Prefabs)
            {
                var options       = SpawnGroupManager.CreateSpawningOptions(spawnGroup, prefab);
                var spawnPosition = Vector3D.Transform((Vector3D)prefab.Position, spawnMatrix);
                var speedL        = prefab.Speed * (Vector3)spawnForwardDir;
                var speedA        = Vector3.Zero;
                var gridList      = new List <IMyCubeGrid>();


                //Speed Management
                if (Settings.SpaceCargoShips.UseMinimumSpeed == true && prefab.Speed < Settings.SpaceCargoShips.MinimumSpeed)
                {
                    speedL = Settings.SpaceCargoShips.MinimumSpeed * (Vector3)spawnForwardDir;
                }

                if (Settings.SpaceCargoShips.UseSpeedOverride == true)
                {
                    speedL = Settings.SpaceCargoShips.SpeedOverride * (Vector3)spawnForwardDir;
                }



                //Grid Manipulation
                GridBuilderManipulation.ProcessPrefabForManipulation(prefab.SubtypeId, spawnGroup, "SpaceCargoShip", prefab.Behaviour);

                try{
                    MyAPIGateway.PrefabManager.SpawnPrefab(gridList, prefab.SubtypeId, spawnPosition, spawnForwardDir, spawnUpDir, speedL, speedA, prefab.BeaconText, options, gridOwner);
                }catch (Exception exc) {
                    Logger.AddMsg("Something Went Wrong With Prefab Spawn Manager.", true);
                }

                var pendingNPC = new ActiveNPC();
                pendingNPC.SpawnGroupName        = spawnGroup.SpawnGroupName;
                pendingNPC.SpawnGroup            = spawnGroup;
                pendingNPC.InitialFaction        = randFactionTag;
                pendingNPC.faction               = MyAPIGateway.Session.Factions.TryGetFactionByTag(pendingNPC.InitialFaction);
                pendingNPC.Name                  = prefab.SubtypeId;
                pendingNPC.GridName              = MyDefinitionManager.Static.GetPrefabDefinition(prefab.SubtypeId).CubeGrids[0].DisplayName;
                pendingNPC.StartCoords           = startPathCoords;
                pendingNPC.CurrentCoords         = startPathCoords;
                pendingNPC.EndCoords             = endPathCoords;
                pendingNPC.SpawnType             = "SpaceCargoShip";
                pendingNPC.AutoPilotSpeed        = speedL.Length();
                pendingNPC.CleanupIgnore         = spawnGroup.IgnoreCleanupRules;
                pendingNPC.ForceStaticGrid       = spawnGroup.ForceStaticGrid;
                pendingNPC.KeenAiName            = prefab.Behaviour;
                pendingNPC.KeenAiTriggerDistance = prefab.BehaviourActivationDistance;

                if (string.IsNullOrEmpty(pendingNPC.KeenAiName) == false)
                {
                    Logger.AddMsg("Stock AI Detected In Prefab: " + prefab.SubtypeId + " in SpawnGroup: " + spawnGroup.SpawnGroup.Id.SubtypeName);
                }

                if (spawnGroup.RandomizeWeapons == true)
                {
                    pendingNPC.ReplenishedSystems = false;
                    pendingNPC.ReplacedWeapons    = true;
                }
                else if ((MES_SessionCore.NPCWeaponUpgradesModDetected == true || Settings.General.EnableGlobalNPCWeaponRandomizer == true) && spawnGroup.IgnoreWeaponRandomizerMod == false)
                {
                    pendingNPC.ReplenishedSystems = false;
                    pendingNPC.ReplacedWeapons    = true;
                }
                else if (spawnGroup.ReplenishSystems == true)
                {
                    pendingNPC.ReplenishedSystems = false;
                }

                NPCWatcher.PendingNPCs.Add(pendingNPC);
            }

            Logger.SkipNextMessage = false;
            return("Spawning Group - " + spawnGroup.SpawnGroup.Id.SubtypeName);
        }
        public static string AttemptSpawn(Vector3D startCoords)
        {
            if (Settings.General.UseMaxNpcGrids == true)
            {
                var totalNPCs = NPCWatcher.ActiveNPCs.Count;

                if (totalNPCs >= Settings.General.MaxGlobalNpcGrids)
                {
                    return("Spawning Aborted. Max Global NPCs Limit Reached.");
                }
            }

            if (NPCWatcher.ActiveNpcTypeLimitReachedForArea("BossEncounter", startCoords, Settings.BossEncounters.MaxShipsPerArea, Settings.BossEncounters.AreaSize) == true)
            {
                return("Too Many Boss Encounter Grids in Player Area");
            }

            var spawnCoords = Vector3D.Zero;

            if (GetInitialSpawnCoords(startCoords, out spawnCoords) == false)
            {
                return("Could Not Find Valid Coords For Boss Encounter Signal Generation.");
            }

            var spawnGroupList = GetBossEncounters(startCoords, spawnCoords);

            if (Settings.General.UseModIdSelectionForSpawning == true)
            {
                spawnGroupList = SpawnResources.SelectSpawnGroupSublist(SpawnGroupSublists, EligibleSpawnsByModId);
            }

            if (spawnGroupList.Count == 0)
            {
                return("No Eligible Spawn Groups Could Be Found To Spawn Near Player.");
            }

            var spawnGroup = spawnGroupList[SpawnResources.rnd.Next(0, spawnGroupList.Count)];

            var bossEncounter = new BossEncounter();

            bossEncounter.SpawnGroup     = spawnGroup;
            bossEncounter.SpawnGroupName = spawnGroup.SpawnGroupName;
            bossEncounter.Position       = spawnCoords;

            foreach (var player in MES_SessionCore.PlayerList)
            {
                if (player.IsBot == true || player.Character == null || IsPlayerInBossEncounter(player.IdentityId) == true)
                {
                    continue;
                }

                if (Vector3D.Distance(player.GetPosition(), spawnCoords) < Settings.BossEncounters.PlayersWithinDistance)
                {
                    bossEncounter.PlayersInEncounter.Add(player.IdentityId);
                }
                else
                {
                    continue;
                }

                if (spawnGroup.BossCustomAnnounceEnable == true)
                {
                    MyVisualScriptLogicProvider.SendChatMessage(spawnGroup.BossCustomAnnounceMessage, spawnGroup.BossCustomAnnounceAuthor, player.IdentityId, "Red");
                }

                /*
                 *              var syncData = new SyncData();
                 *              syncData.Instruction = "MESBossGPSCreate";
                 *              syncData.GpsName = spawnGroup.BossCustomGPSLabel;
                 *              syncData.GpsCoords = spawnCoords;
                 *              var sendData = MyAPIGateway.Utilities.SerializeToBinary<SyncData>(syncData);
                 *              bool sendStatus = MyAPIGateway.Multiplayer.SendMessageTo(8877, sendData, player.SteamUserId);
                 */
            }

            bossEncounter.CreateGpsForPlayers();
            NPCWatcher.BossEncounters.Add(bossEncounter);

            try {
                if (NPCWatcher.BossEncounters.Count > 0)
                {
                    BossEncounter[] encounterArray = NPCWatcher.BossEncounters.ToArray();
                    var             byteArray      = MyAPIGateway.Utilities.SerializeToBinary <BossEncounter[]>(encounterArray);
                    var             storedBossData = Convert.ToBase64String(byteArray);
                    MyAPIGateway.Utilities.SetVariable <string>("MES-ActiveBossEncounters", storedBossData);
                }
                else
                {
                    MyAPIGateway.Utilities.SetVariable <string>("MES-ActiveBossEncounters", "");
                }
            } catch (Exception e) {
                Logger.AddMsg("Something went wrong while getting Boss Encounter Data from Storage.");
                Logger.AddMsg(e.ToString(), true);
            }



            Logger.SkipNextMessage = false;
            return("Boss Encounter GPS Created with Spawngroup: " + spawnGroup.SpawnGroup.Id.SubtypeName);
        }