/// <summary>
/// Main unit generation method.
/// </summary>
/// <param name="mission">Mission to which generated units should be added</param>
/// <param name="template">Mission template to use</param>
/// <param name="objectiveDB">Mission objective database entry</param>
/// <param name="coalitionsDB">Coalitions database entries</param>
/// <param name="moving">Will the group be moving</param>
/// <param name="objectiveGroup">If the group should be tracked as an objective</param>
public void SpawnUnitGroups(DCSMission mission, MissionTemplate template, DBUnitGroup unitGroup, DBEntryCoalition[] coalitionsDB, Side side, Coalition coalition)
{
DCSMissionUnitGroupFlags flags =
GeneratorTools.ShouldUnitBeHidden(unitGroup, !template.OptionsPreferences.Contains(MissionTemplatePreferences.HideEnemyUnits)) ?
DCSMissionUnitGroupFlags.Hidden : 0;
for (int i = 0; i < mission.Objectives.Length; i++)
{
// This objective requires no unit group generation
if (!mission.Objectives[i].TargetFamily.HasValue)
{
continue;
}
string[] units =
coalitionsDB[(int)coalition].GetRandomUnits(
mission.Objectives[i].TargetFamily.Value, mission.DateTime.Decade,
unitGroup.Count.GetValue(), template.OptionsUnitMods);
// Pick the skill level once for each objective so not all target groups have the same skill level when a "random" skill level is chosen.
DCSSkillLevel skillLevel;
if (side == Side.Ally)
{
skillLevel = Toolbox.BRSkillLevelToDCSSkillLevel(template.PlayerAISkillLevel);
}
else
{
skillLevel =
Toolbox.IsUnitFamilyAircraft(mission.Objectives[i].TargetFamily.Value) ?
Toolbox.BRSkillLevelToDCSSkillLevel(template.OppositionSkillLevelAir) : Toolbox.BRSkillLevelToDCSSkillLevel(template.OppositionSkillLevelGround);
}
DCSMissionUnitGroup group;
DBEntryTheaterSpawnPoint?spawnPoint = null;
if (unitGroup.SpawnPoints[0] != TheaterLocationSpawnPointType.Airbase)
{
if (unitGroup.Flags.HasFlag(DBUnitGroupFlags.DestinationObjective))
{
spawnPoint = UnitMaker.SpawnPointSelector.GetRandomSpawnPoint(
unitGroup.SpawnPoints,
mission.Objectives[i].Coordinates,
unitGroup.DistanceFromPoint);
if (!spawnPoint.HasValue)
{
throw new Exception($"Failed to find spawn point for moving objective unit");
}
}
}
if (unitGroup.Flags.HasFlag(DBUnitGroupFlags.EmbeddedAirDefense)) // Add "embedded" close range surface-to-air defense
{
if (Toolbox.GetUnitCategoryFromUnitFamily(mission.Objectives[i].TargetFamily.Value) == UnitCategory.Vehicle) // Objectives are ground vehicles, insert air defense units in the group itself
{
units = GeneratorTools.AddEmbeddedAirDefense(units, template.OppositionAirDefense, coalitionsDB[(int)coalition], mission.DateTime.Decade, template.OptionsUnitMods);
}
else // Objectives are not ground vehicles, create another group nearby
{
// TODO: make sure the group is not spawn in water
string[] airDefenseGroupUnits = new string[0];
for (int j = 0; j < 2; j++)
{
airDefenseGroupUnits = GeneratorTools.AddEmbeddedAirDefense(airDefenseGroupUnits, template.OppositionAirDefense, coalitionsDB[(int)coalition], mission.DateTime.Decade, template.OptionsUnitMods);
}
UnitMaker.AddUnitGroup(
mission, airDefenseGroupUnits,
side,
(spawnPoint != null ? spawnPoint.Value.Coordinates : mission.Objectives[i].Coordinates) + Coordinates.CreateRandom(0.5, 1.5) * Toolbox.NM_TO_METERS,
"GroupVehicle", "UnitVehicle",
skillLevel, flags);
}
}
group = UnitMaker.AddUnitGroup(
mission, units,
side,
spawnPoint != null? spawnPoint.Value.Coordinates : mission.Objectives[i].Coordinates,
Toolbox.RandomFrom(unitGroup.LuaGroup), unitGroup.LuaUnit,
skillLevel, flags, coordinates2: getDestination(unitGroup, mission, i),
airbaseID: mission.Objectives[i].AirbaseID,
requiresParkingSpots: mission.Objectives[i].AirbaseID > 0,
requiresOpenAirParking: unitGroup.Flags.HasFlag(DBUnitGroupFlags.AvoidHardenedBunkers)
);
// Something went wrong, abort mission generation, objective unit groups are required for the mission to work properly.
if (group == null)
{
throw new Exception($"Failed to create objective unit group for objective #{i + 1} made of the following units: {string.Join(", ", units)}");
}
// Add aircraft group to the queue of aircraft groups to be spawned
if (!unitGroup.Flags.HasFlag(DBUnitGroupFlags.ManualActivation) &&
((group.Category == UnitCategory.Helicopter) || (group.Category == UnitCategory.Plane) || unitGroup.Flags.HasFlag(DBUnitGroupFlags.DelaySpawn)))
{
mission.AircraftSpawnQueue.Add(new DCSMissionAircraftSpawnQueueItem(group.GroupID, true));
}
if (!unitGroup.Flags.HasFlag(DBUnitGroupFlags.NotObjectiveTarget))
{
if (mission.ObjectiveIsStatic)
{
mission.CoreLuaScript += $"briefingRoom.mission.objectives[{i + 1}].groupID = {group.Units[0].ID}\r\n";
}
else
{
// Add the ID of the unit group associated with this objective to the Lua script
mission.CoreLuaScript += $"briefingRoom.mission.objectives[{i + 1}].groupID = {group.GroupID}\r\n";
}
}
}
}
/// <summary>
/// Main unit generation method.
/// </summary>
/// <param name="mission">Mission to which generated units should be added</param>
/// <param name="template">Mission template to use</param>
/// <param name="objectiveDB">Mission objective database entry</param>
/// <param name="coalitionsDB">Coalitions database entries</param>
/// <param name="moving">Will the group be moving</param>
/// <param name="objectiveGroup">If the group should be tracked as an objective</param>
public void SpawnUnitGroups(DCSMission mission, MissionTemplate template, DBUnitGroup unitGroup, DBEntryCoalition[] coalitionsDB, Side side, Coalition coalition)
{
DCSMissionUnitGroupFlags flags =
GeneratorTools.ShouldUnitBeHidden(unitGroup, !template.OptionsPreferences.Contains(MissionTemplatePreferences.HideEnemyUnits)) ?
DCSMissionUnitGroupFlags.Hidden : 0;
for (int i = 0; i < mission.Objectives.Length; i++)
{
// This objective requires no unit group generation
if (!mission.Objectives[i].TargetFamily.HasValue)
{
continue;
}
string[] units =
coalitionsDB[(int)coalition].GetRandomUnits(
mission.Objectives[i].TargetFamily.Value, mission.DateTime.Decade,
unitGroup.Count.GetValue(), template.OptionsUnitMods);
if (unitGroup.Flags.HasFlag(DBUnitGroupFlags.EmbeddedAirDefense) &&
coalition != mission.CoalitionPlayer &&
(Toolbox.GetUnitCategoryFromUnitFamily(mission.Objectives[i].TargetFamily.Value) == UnitCategory.Vehicle))
{
units = GeneratorTools.AddEmbeddedAirDefense(units, template.OppositionAirDefense, coalitionsDB[(int)coalition], mission.DateTime.Decade, template.OptionsUnitMods);
}
// Pick the skill level once for each objective so not all target groups have the same skill level when a
// "random" skill level is chosen.
DCSSkillLevel skillLevel =
Toolbox.IsUnitFamilyAircraft(mission.Objectives[i].TargetFamily.Value) ?
Toolbox.BRSkillLevelToDCSSkillLevel(template.OppositionSkillLevelAir) :
Toolbox.BRSkillLevelToDCSSkillLevel(template.OppositionSkillLevelGround);
DCSMissionUnitGroup group;
DBEntryTheaterSpawnPoint?spawnPoint = null;
if (unitGroup.Flags.HasFlag(DBUnitGroupFlags.DestinationObjective))
{
spawnPoint = UnitMaker.SpawnPointSelector.GetRandomSpawnPoint(
unitGroup.SpawnPoints,
mission.Objectives[i].Coordinates,
unitGroup.DistanceFromPoint);
if (!spawnPoint.HasValue)
{
throw new Exception($"Failed to find spawn point for moving objective unit");
}
}
group = UnitMaker.AddUnitGroup(
mission, units,
side,
spawnPoint != null? spawnPoint.Value.Coordinates : mission.Objectives[i].Coordinates,
Toolbox.RandomFrom(unitGroup.LuaGroup), unitGroup.LuaUnit,
skillLevel, flags, coordinates2: getDestination(unitGroup, mission, i));
// Something went wrong, abort mission generation, objective unit groups are required for the mission to work properly.
if (group == null)
{
throw new Exception($"Failed to create objective unit group for objective #{i + 1} made of the following units: {string.Join(", ", units)}");
}
// Add aircraft group to the queue of aircraft groups to be spawned
if ((group.Category == UnitCategory.Helicopter) || (group.Category == UnitCategory.Plane) || unitGroup.Flags.HasFlag(DBUnitGroupFlags.DelaySpawn))
{
mission.AircraftSpawnQueue.Add(new DCSMissionAircraftSpawnQueueItem(group.GroupID, true));
}
if (!unitGroup.Flags.HasFlag(DBUnitGroupFlags.NotObjectiveTarget))
{
if (mission.ObjectiveIsStatic)
{
mission.CoreLuaScript += $"briefingRoom.mission.objectives[{i + 1}].groupID = {group.Units[0].ID}\r\n";
}
else
{
// Add the ID of the unit group associated with this objective to the Lua script
mission.CoreLuaScript += $"briefingRoom.mission.objectives[{i + 1}].groupID = {group.GroupID}\r\n";
}
}
}
}
