Specify CAP engagement range in the doctrine.

gen/aircraft.py

@@ -1504,7 +1504,7 @@ class CasIngressBuilder(PydcsWaypointBuilder):
         if isinstance(self.flight.flight_plan, CasFlightPlan):
             waypoint.add_task(EngageTargetsInZone(
                 position=self.flight.flight_plan.target,
-                radius=FRONTLINE_LENGTH / 2,
+                radius=int(self.flight.flight_plan.engagement_distance.meters),
                 targets=[
                     Targets.All.GroundUnits.GroundVehicles,
                     Targets.All.GroundUnits.AirDefence.AAA,
@@ -1750,8 +1750,10 @@ class RaceTrackBuilder(PydcsWaypointBuilder):
     def build(self) -> MovingPoint:
         waypoint = super().build()
 
-        if not isinstance(self.flight.flight_plan, PatrollingFlightPlan):
-            flight_plan_type = self.flight.flight_plan.__class__.__name__
+        flight_plan = self.flight.flight_plan
+
+        if not isinstance(flight_plan, PatrollingFlightPlan):
+            flight_plan_type = flight_plan.__class__.__name__
             logging.error(
                 f"Cannot create race track for {self.flight} because "
                 f"{flight_plan_type} does not define a patrol.")
@@ -1769,18 +1771,18 @@ class RaceTrackBuilder(PydcsWaypointBuilder):
         # later.
         cap_types = {FlightType.BARCAP, FlightType.TARCAP}
         if self.flight.flight_type in cap_types:
+            engagement_distance = int(flight_plan.engagement_distance.meters)
             waypoint.tasks.append(
-                EngageTargets(max_distance=int(nautical_miles(50).meters),
+                EngageTargets(max_distance=engagement_distance,
                               targets=[Targets.All.Air]))
 
         racetrack = ControlledTask(OrbitAction(
             altitude=waypoint.alt,
             pattern=OrbitAction.OrbitPattern.RaceTrack
         ))
-        self.set_waypoint_tot(
-            waypoint, self.flight.flight_plan.patrol_start_time)
+        self.set_waypoint_tot(waypoint, flight_plan.patrol_start_time)
         racetrack.stop_after_time(
-            int(self.flight.flight_plan.patrol_end_time.total_seconds()))
+            int(flight_plan.patrol_end_time.total_seconds()))
         waypoint.add_task(racetrack)
 
         return waypoint

gen/flights/flightplan.py

@@ -33,7 +33,7 @@ from .closestairfields import ObjectiveDistanceCache
 from .flight import Flight, FlightType, FlightWaypoint, FlightWaypointType
 from .traveltime import GroundSpeed, TravelTime
 from .waypointbuilder import StrikeTarget, WaypointBuilder
-from ..conflictgen import Conflict
+from ..conflictgen import Conflict, FRONTLINE_LENGTH
 
 if TYPE_CHECKING:
     from game import Game
@@ -365,6 +365,12 @@ class PatrollingFlightPlan(FlightPlan):
     #: Maximum time to remain on station.
     patrol_duration: timedelta
 
+    #: The engagement range of any Search Then Engage task, or the radius of a
+    #: Search Then Engage in Zone task. Any enemies of the appropriate type for
+    #: this mission within this range of the flight's current position (or the
+    #: center of the zone) will be engaged by the flight.
+    engagement_distance: Distance
+
     @property
     def patrol_start_time(self) -> timedelta:
         return self.package.time_over_target
@@ -877,6 +883,7 @@ class FlightPlanBuilder:
             package=self.package,
             flight=flight,
             patrol_duration=self.doctrine.cap_duration,
+            engagement_distance=self.doctrine.cap_engagement_range,
             takeoff=builder.takeoff(flight.departure),
             patrol_start=start,
             patrol_end=end,
@@ -1010,6 +1017,7 @@ class FlightPlanBuilder:
             # requests an escort the CAP flight will remain on station for the
             # duration of the escorted mission, or until it is winchester/bingo.
             patrol_duration=self.doctrine.cap_duration,
+            engagement_distance=self.doctrine.cap_engagement_range,
             takeoff=builder.takeoff(flight.departure),
             patrol_start=start,
             patrol_end=end,
@@ -1152,6 +1160,7 @@ class FlightPlanBuilder:
             takeoff=builder.takeoff(flight.departure),
             patrol_start=builder.ingress(FlightWaypointType.INGRESS_CAS,
                                          ingress, location),
+            engagement_distance=meters(FRONTLINE_LENGTH) / 2,
             target=builder.cas(center),
             patrol_end=builder.egress(egress, location),
             land=builder.land(flight.arrival),