Advance standalone admission, finite artillery and native validation

2026-09-19 09:02:31 +02:00
parent af5146a317
commit 40a474934c
532 changed files with 56456 additions and 199 deletions
@@ -0,0 +1,339 @@
+class ERR_HQUnit
+{
+	int Id;
+	SCR_AIGroup Group;
+	SCR_AIGroupUtilityComponent Utility;
+	IEntity Radio;
+	float NextReport;
+	ref ERR_HQRoute Uplink;
+	ref ERR_HQReport PendingReport;
+	ref ERR_HQRoute Downlink;
+	ref ERR_HQReport PendingOrder;
+	ref ERR_HQReport Assignment;
+	AIWaypoint Waypoint;
+	bool ReservedForSupport;
+
+	bool Eligible(ERR_GameMode mode)
+	{
+		if (ReservedForSupport || !Group || !Utility || Group.GetPlayerCount(true) > 0 || Group.IsSlave() || Group.GetFaction() != mode.EnemyFaction()) return false;
+		array<AIAgent> agents = {};
+		Group.GetAgents(agents);
+		bool survivor;
+		foreach (AIAgent agent : agents)
+		{
+			if (!agent || !ERR_Actors.CanFight(agent.GetControlledEntity())) continue;
+			survivor = true;
+			if (CompartmentAccessComponent.GetVehicleIn(agent.GetControlledEntity())) return false;
+		}
+		return survivor;
+	}
+
+	void Release()
+	{
+		if (Waypoint)
+		{
+			if (Group) Group.RemoveWaypoint(Waypoint);
+			SCR_EntityHelper.DeleteEntityAndChildren(Waypoint);
+		}
+		Waypoint = null;
+		Assignment = null;
+		PendingOrder = null;
+		Downlink = null;
+	}
+}
+
+class ERR_HQ : ERR_CommandService
+{
+	protected ERR_GameMode m_Mode;
+	protected ref ERR_MortarSystem m_Mortars;
+	protected ref array<ref ERR_HQUnit> m_Units = {};
+	protected ref array<ref ERR_HQReport> m_Contacts = {};
+	protected ref ERR_HQNetwork m_Network = new ERR_HQNetwork();
+	protected ref ERR_HQJournal m_Journal = new ERR_HQJournal();
+	protected int m_NextId;
+	protected float m_NextNetwork;
+	protected float m_NextAssignment;
+
+	void ERR_HQ(ERR_GameMode mode) { m_Mode = mode; m_Mortars = new ERR_MortarSystem(this); }
+ static ERR_HQ Get()
+ {
+  ERR_GameMode mode = ERR_GameMode.Get();
+  if (!mode) return null;
+  return ERR_HQ.Cast(mode.Command());
+ }
+ static bool MissionActive()
+ {
+  ERR_GameMode mode = ERR_GameMode.Get();
+  return mode && mode.Active();
+ }
+ static void Event(string kind, string message, int messageId = 0)
+ {
+  ERR_HQ hq = Get();
+  if (hq) hq.Journal().Write(kind, message, messageId);
+ }
+ ERR_MortarSystem Mortars() { return m_Mortars; }
+ bool PrepareSupport() { return m_Mortars.Prepare(); }
+ void ReserveGroup(SCR_AIGroup group)
+ {
+  foreach (ERR_HQUnit unit : m_Units)
+  {
+   if (unit.Group != group) continue;
+   unit.Release();
+   unit.ReservedForSupport = true;
+  }
+ }
+ void PhysicalForces(out array<IEntity> entities)
+ {
+  entities.Clear();
+  foreach (ERR_HQUnit unit : m_Units)
+  {
+   if (!unit.Group) continue;
+   array<AIAgent> agents = {};
+   unit.Group.GetAgents(agents);
+   foreach (AIAgent agent : agents)
+   {
+    if (!agent || !agent.GetControlledEntity()) continue;
+    IEntity actor = agent.GetControlledEntity();
+    if (!entities.Contains(actor)) entities.Insert(actor);
+    IEntity vehicle = CompartmentAccessComponent.GetVehicleIn(actor);
+    if (vehicle && !entities.Contains(vehicle)) entities.Insert(vehicle);
+   }
+  }
+  m_Mortars.AppendGuns(entities);
+ }
+ bool MortarConnected(SCR_AIGroup group)
+ {
+  foreach (ERR_HQUnit unit : m_Units)
+   if (unit.Group == group && unit.Radio) return m_Network.Route(unit.Radio) != null;
+  return false;
+ }
+ ERR_HQRoute Downlink(SCR_AIGroup group, string kind, string detail, int sourceId)
+ {
+  foreach (ERR_HQUnit unit : m_Units)
+  {
+   if (unit.Group != group || !unit.Radio) continue;
+   ERR_HQRoute route = m_Network.Route(unit.Radio, true);
+   if (!route) return null;
+   route.MessageId = m_Journal.Message();
+   route.Payload = string.Format("%1 from report M%2; %3", kind, sourceId, detail);
+   m_Journal.Write("ORDER QUEUED", route.Payload, route.MessageId);
+   return route;
+  }
+  return null;
+ }
+ void SupportContacts(out array<ref ERR_HQReport> contacts, float now)
+ {
+  contacts.Clear();
+  foreach (ERR_HQReport contact : m_Contacts)
+   if (ERR_MortarPrediction.Fresh(contact, now)) contacts.Insert(contact.Snapshot());
+ }
+
+	ERR_HQJournal Journal() { return m_Journal; }
+	string Status()
+	{
+		return string.Format("HQ: %1 groups, %2 delivered contacts, %3 assignments", m_Units.Count(), m_Contacts.Count(), Assigned()) + "; " + m_Mortars.Status();
+	}
+
+	override void RegisterGroup(SCR_AIGroup group)
+	{
+		if (!Replication.IsServer() || !group || m_Units.Count() >= 128) return;
+		foreach (ERR_HQUnit known : m_Units) if (known.Group == group) return;
+		SCR_AIGroupUtilityComponent utility = SCR_AIGroupUtilityComponent.Cast(group.FindComponent(SCR_AIGroupUtilityComponent));
+		if (!utility || group.GetFaction() != m_Mode.EnemyFaction()) return;
+		ERR_HQUnit unit = new ERR_HQUnit();
+		unit.Id = ++m_NextId;
+		unit.Group = group;
+		unit.Utility = utility;
+		int phase = unit.Id % 5;
+		unit.NextReport = GetGame().GetWorld().GetWorldTime() + phase * 1000;
+		m_Units.Insert(unit);
+		m_Journal.Write("REGISTER", string.Format("group %1", unit.Id));
+	}
+
+	override void UnregisterGroup(SCR_AIGroup group)
+	{
+		foreach (ERR_HQUnit unit : m_Units)
+		{
+			if (unit.Group != group) continue;
+			unit.Release();
+			unit.Group = null;
+			unit.Utility = null;
+		}
+	}
+
+	protected int Assigned()
+	{
+		int total;
+		foreach (ERR_HQUnit unit : m_Units) if (unit.Assignment || unit.PendingOrder) total++;
+		return total;
+	}
+
+	protected void IndexRadios()
+	{
+		m_Network.Clear();
+		foreach (ERR_HQUnit unit : m_Units)
+		{
+			unit.Radio = null;
+			if (!unit.Group || unit.Group.GetPlayerCount(true) > 0 || unit.Group.GetFaction() != m_Mode.EnemyFaction()) continue;
+			array<AIAgent> agents = {};
+			unit.Group.GetAgents(agents);
+			int best;
+			foreach (AIAgent agent : agents)
+			{
+				if (!agent) continue;
+				IEntity actor = agent.GetControlledEntity();
+				int capability = ERR_HQRadio.Capability(actor);
+				if (capability <= 0) continue;
+				m_Network.Add(actor, unit.Group, unit.Id, capability);
+				if (capability > best) { unit.Radio = actor; best = capability; }
+			}
+		}
+		m_Network.Build();
+	}
+
+	protected void Observe(ERR_HQUnit unit, float now)
+	{
+		if (!unit.Utility || !unit.Radio || unit.Uplink || now < unit.NextReport) return;
+		unit.NextReport = now + m_Mode.Settings().Get("reportIntervalSeconds") * 1000;
+		array<ref ERR_HQVisualContact> samples = {};
+		ERR_HQObservation.Gather(unit.Utility, now, samples);
+		if (samples.IsEmpty()) return;
+		ERR_HQVisualContact seen = samples[0];
+		ERR_HQRoute route = m_Network.Route(unit.Radio);
+		if (!route) return;
+		ERR_HQReport report = new ERR_HQReport();
+		report.MessageId = m_Journal.Message();
+		report.Target = seen.Entity;
+		report.Source = unit.Group;
+		report.Position = seen.Position;
+		report.ObservedAt = seen.ObservedAt;
+		ERR_HQObservation.Describe(report, samples, now);
+		route.MessageId = report.MessageId;
+		route.Payload = report.Description(now);
+		unit.PendingReport = report;
+		unit.Uplink = route;
+		m_Journal.Write("REPORT", route.Payload, report.MessageId);
+	}
+
+	protected void Accept(ERR_HQReport report, float now)
+	{
+		if (!report || !ERR_MissionRules.ContactFresh(report.ObservedAt, now)) return;
+		for (int i = 0; i < m_Contacts.Count(); i++)
+		{
+			ERR_HQReport previous = m_Contacts[i];
+			if (previous.Target != report.Target) continue;
+			if (previous.ObservedAt >= report.ObservedAt) return;
+			float seconds = (report.ObservedAt - previous.ObservedAt) / 1000;
+			if (seconds > 0 && seconds < 30 && vector.DistanceXZ(previous.Position, report.Position) < 500)
+			{
+				report.Velocity = (report.Position - previous.Position) / seconds;
+				report.HasVelocity = report.Velocity.Length() <= 100;
+			}
+			m_Contacts[i] = report.Snapshot();
+			return;
+		}
+		if (m_Contacts.Count() >= 64) m_Contacts.Remove(0);
+		m_Contacts.Insert(report.Snapshot());
+	}
+
+	protected void DeliverOrder(ERR_HQUnit unit, float now)
+	{
+		ERR_HQReport order = unit.PendingOrder;
+		if (!order || !ERR_MissionRules.ContactFresh(order.ObservedAt, now) || !unit.Eligible(m_Mode)) { unit.Release(); return; }
+		SCR_AIGroupPerception perception = unit.Utility.m_Perception;
+		if (perception && !perception.m_aTargets.IsEmpty()) { unit.Release(); return; }
+		int deliveryId;
+		if (unit.Downlink) deliveryId = unit.Downlink.MessageId;
+		unit.Release();
+		vector position = order.Position;
+		if (order.HasVelocity) position = ERR_HQReport.Predict(position, order.Velocity, (now - order.ObservedAt) / 1000);
+		AIWaypoint waypoint = AIWaypoint.Cast(ERR_Actors.Spawn(ERR_Resources.SearchWaypoint(), ERR_Actors.Ground(position)));
+		if (!waypoint) { m_Journal.Write("ORDER FAILED", "waypoint spawn failed", order.MessageId); return; }
+		unit.Waypoint = waypoint;
+		unit.Assignment = order;
+		unit.Group.AddWaypointAt(waypoint, 0);
+		m_Journal.Write("ORDER DELIVERED", string.Format("group %1 from report M%2: %3", unit.Id, order.MessageId, order.Description(now)), deliveryId);
+	}
+
+	protected void Assign(float now)
+	{
+		int limit = m_Mode.Settings().Get("supportSquadLimit");
+		int radius = m_Mode.Settings().Get("responseRadiusMetres");
+		int assigned = Assigned();
+		foreach (ERR_HQUnit unit : m_Units)
+		{
+			if (unit.Assignment && (!ERR_MissionRules.ContactFresh(unit.Assignment.ObservedAt, now) || !unit.Eligible(m_Mode) || assigned > limit))
+			{
+				unit.Release(); assigned--;
+			}
+			if (unit.PendingOrder && (!ERR_MissionRules.ContactFresh(unit.PendingOrder.ObservedAt, now) || !unit.Eligible(m_Mode) || assigned > limit))
+			{
+				unit.Release(); assigned--;
+			}
+		}
+		foreach (ERR_HQReport report : m_Contacts)
+		{
+			if (!ERR_MissionRules.ContactFresh(report.ObservedAt, now)) continue;
+			foreach (ERR_HQUnit unit : m_Units)
+			{
+				if (assigned >= limit) return;
+				if (unit.Assignment || unit.PendingOrder || !unit.Eligible(m_Mode) || !unit.Radio) continue;
+				if (vector.DistanceXZ(unit.Group.GetOrigin(), report.Position) > radius) continue;
+				SCR_AIGroupPerception perception = unit.Utility.m_Perception;
+				if (perception && !perception.m_aTargets.IsEmpty()) continue;
+				ERR_HQRoute route = m_Network.Route(unit.Radio, true);
+				if (!route) continue;
+				unit.PendingOrder = report.Snapshot();
+				unit.Downlink = route;
+				route.MessageId = m_Journal.Message();
+				route.Payload = "order from report M" + report.MessageId.ToString();
+				assigned++;
+			}
+		}
+	}
+
+	override void Tick(float now)
+	{
+		if (!Replication.IsServer()) return;
+		if (now >= m_NextNetwork) { IndexRadios(); m_NextNetwork = now + 5000; }
+		for (int i = m_Contacts.Count() - 1; i >= 0; i--)
+			if (!ERR_MissionRules.ContactFresh(m_Contacts[i].ObservedAt, now)) m_Contacts.Remove(i);
+		for (int i = m_Units.Count() - 1; i >= 0; i--)
+		{
+			ERR_HQUnit unit = m_Units[i];
+			if (unit.Uplink)
+			{
+				int delivered = unit.Uplink.Advance(now, m_Journal);
+				if (delivered == 1) Accept(unit.PendingReport, now);
+				if (delivered != 0) { unit.Uplink = null; unit.PendingReport = null; }
+			}
+			if (unit.Downlink)
+			{
+				int delivered = unit.Downlink.Advance(now, m_Journal);
+				if (delivered == 1) DeliverOrder(unit, now);
+				else if (delivered < 0) unit.Release();
+			}
+			if (!unit.Group && !unit.Uplink) { unit.Release(); m_Units.Remove(i); continue; }
+			Observe(unit, now);
+		}
+		if (now >= m_NextAssignment) { Assign(now); m_NextAssignment = now + 5000; }
+		m_Mortars.Tick(now);
+		m_Journal.Flush();
+	}
+
+	override void Stop()
+	{
+		m_Mortars.Stop();
+		foreach (ERR_HQUnit unit : m_Units) unit.Release();
+		m_Units.Clear();
+		m_Contacts.Clear();
+		m_Network.Clear();
+		m_Journal.Write("STOP", "HQ stopped; tactical orders released");
+		m_Journal.Flush();
+	}
+}
+
+modded class ERR_GameMode
+{
+	protected override ERR_CommandService CreateCommandService() { return new ERR_HQ(this); }
+}
@@ -0,0 +1,101 @@
+// Server-owned audit stream. The file contains every event; chat reads a bounded
+// recent-history window with explicit gap notices for clients that fall behind.
+class ERR_HQJournal
+{
+	protected ref array<string> m_Recent = {};
+	protected ref array<string> m_Pending = {};
+	protected int m_Sequence;
+	protected int m_Message;
+	protected static int s_Part;
+	protected static int s_Session;
+	protected string m_Session;
+
+	void ERR_HQJournal()
+	{
+		s_Session++;
+		m_Session = string.Format("%1-%2", System.GetUnixTime(), s_Session);
+	}
+	protected float m_RetryAt;
+	protected int m_Lost;
+
+	string Path()
+	{
+		if (s_Part == 0)
+			return "$logs:rereintroduced-hq.log";
+		return "$logs:rereintroduced-hq-" + s_Part.ToString() + ".log";
+	}
+
+	int Message()
+	{
+		return ++m_Message;
+	}
+
+	int Sequence()
+	{
+		return m_Sequence;
+	}
+
+	void Write(string kind, string message, int messageId = 0)
+	{
+		if (!Replication.IsServer())
+			return;
+		float seconds = GetGame().GetWorld().GetWorldTime() / 1000;
+		string line = string.Format("#%1 t=%2s M%3 %4 %5", ++m_Sequence, Math.Round(seconds * 10) / 10.0, messageId, kind, message) + " [session=" + m_Session + "]";
+		if (m_Recent.Count() >= 300)
+			m_Recent.Remove(0);
+		m_Recent.Insert(line);
+		if (m_Pending.Count() < 4096)
+			m_Pending.Insert(line);
+		else
+			m_Lost++;
+	}
+
+	void Read(int after, out array<string> lines, out int cursor, int limit = 8)
+	{
+		lines.Clear();
+		cursor = Math.Clamp(after, 0, m_Sequence);
+		int first = m_Sequence - m_Recent.Count();
+		if (cursor < first)
+		{
+			lines.Insert(string.Format("HQ log: %1 older entries are outside chat history; see %2", first - cursor, Path()));
+			cursor = first;
+		}
+		int characters;
+		for (int i = cursor - first; i < m_Recent.Count() && lines.Count() < Math.Clamp(limit, 1, 40); i++)
+		{
+			// Bound each menu RPC without skipping unread records. Chat still
+			// requests eight; the live menu can drain a busy journal faster.
+			if (characters + m_Recent[i].Length() > 16000 && !lines.IsEmpty())
+				break;
+			lines.Insert(m_Recent[i]);
+			characters += m_Recent[i].Length();
+			cursor++;
+		}
+	}
+
+	void Flush()
+	{
+		if (m_Pending.IsEmpty() || !Replication.IsServer())
+			return;
+		float now = GetGame().GetWorld().GetWorldTime();
+		if (now < m_RetryAt)
+			return;
+		FileHandle file = FileIO.OpenFile(Path(), FileMode.APPEND);
+		if (!file)
+		{
+			m_RetryAt = now + 30000;
+			PrintFormat("Escapists AI [HQ log]: cannot open %1; retry in 30s, chat history remains available", Path(), level: LogLevel.ERROR);
+			return;
+		}
+		foreach (string line : m_Pending)
+			file.WriteLine(line);
+		if (m_Lost > 0)
+			file.WriteLine(string.Format("HQ log: %1 entries lost while file was unavailable and buffer full", m_Lost));
+		bool rotate = file.GetLength() >= 5242880;
+		file.Close();
+		m_Pending.Clear();
+		m_Lost = 0;
+		if (rotate)
+			s_Part++;
+	}
+}
@@ -0,0 +1,241 @@
+// Radio propagation is simulated using actual living carriers and inventory.
+// A manpack is the HQ uplink; short-range hops are limited to 500 m and three
+// retransmissions. No virtual relay is fabricated when the network is broken.
+class ERR_HQRadioNode
+{
+	IEntity Carrier;
+	SCR_AIGroup Group;
+	int UnitId;
+	int Capability;
+	protected float m_CheckedAt = -1;
+	protected int m_LiveCapability;
+
+	bool Valid(bool manpack = false)
+	{
+		ERR_GameMode factions = ERR_GameMode.Get();
+		if (!Carrier || !Group || Group.GetPlayerCount(true) > 0 || !factions || Group.GetFaction() != factions.EnemyFaction() || ERR_Actors.Group(Carrier) != Group)
+			return false;
+		int required = 1;
+		if (manpack)
+			required = 2;
+		float now = GetGame().GetWorld().GetWorldTime();
+		if (m_CheckedAt < 0 || now < m_CheckedAt || now - m_CheckedAt >= 1000)
+		{
+			m_CheckedAt = now;
+			m_LiveCapability = ERR_HQRadio.Capability(Carrier);
+		}
+		return m_LiveCapability >= required;
+	}
+
+	string Label()
+	{
+		return "unit " + UnitId.ToString();
+	}
+}
+
+class ERR_HQRoute
+{
+	ref array<ref ERR_HQRadioNode> Nodes = {};
+	bool Downlink;
+	int Cursor;
+	bool Sending;
+	float Due;
+	vector SentFrom;
+	float StartedAt = -1;
+	int MessageId;
+	string Payload;
+	bool Failed;
+
+	// -1 failed, 0 travelling, 1 delivered. Each hop really gates delivery.
+	int Advance(float now, ERR_HQJournal journal)
+	{
+		if (Failed)
+			return -1;
+		if (StartedAt < 0)
+		{
+			StartedAt = now;
+			if (Downlink)
+				Cursor = -1; // first leg is HQ to the manpack
+		}
+		if (now - StartedAt > 30000)
+			return Fail(journal, "route timed out");
+		int target = Cursor + 1;
+		if (Sending)
+		{
+			if (now < Due)
+				return 0;
+			if (target < Nodes.Count())
+			{
+				if (!Nodes[target].Valid(Downlink && target == 0))
+					return Fail(journal, "receiving carrier lost radio, died or changed ownership");
+				if (Cursor >= 0 && vector.DistanceXZ(SentFrom, Nodes[target].Carrier.GetOrigin()) > 500)
+					return Fail(journal, "receiver moved beyond the 500m link");
+				journal.Write("RECEIVE", Nodes[target].Label() + " received from " + SenderLabel(), MessageId);
+			}
+			else
+				journal.Write("RECEIVE", "HQ received from " + SenderLabel(), MessageId);
+			Cursor++;
+			Sending = false;
+			if ((!Downlink && Cursor >= Nodes.Count()) || (Downlink && Cursor == Nodes.Count() - 1))
+				return 1;
+			target = Cursor + 1;
+		}
+		if (Nodes.IsEmpty())
+			return Fail(journal, "no physical radio route");
+		if (Cursor >= 0 && !Nodes[Cursor].Valid(!Downlink && Cursor == Nodes.Count() - 1))
+			return Fail(journal, "transmitting carrier lost radio, died or changed ownership");
+		string recipient = "HQ";
+		string link = "long-range";
+		if (target < Nodes.Count())
+		{
+			if (!Nodes[target].Valid(Downlink && target == 0))
+				return Fail(journal, "next relay unavailable");
+			recipient = Nodes[target].Label();
+			if (Cursor >= 0)
+			{
+				SentFrom = Nodes[Cursor].Carrier.GetOrigin();
+				float distance = vector.DistanceXZ(SentFrom, Nodes[target].Carrier.GetOrigin());
+				if (distance > 500)
+					return Fail(journal, "next relay beyond 500m");
+				link = Math.Round(distance).ToString() + "m short-range";
+			}
+		}
+		journal.Write("TRANSMIT", SenderLabel() + " -> " + recipient + " (" + link + ")", MessageId);
+		Sending = true;
+		Due = now + 2000;
+		return 0;
+	}
+
+	protected string SenderLabel()
+	{
+		if (Cursor < 0)
+			return "HQ";
+		return Nodes[Cursor].Label();
+	}
+
+	protected int Fail(ERR_HQJournal journal, string reason)
+	{
+		Failed = true;
+		journal.Write("LOST", reason + "; " + Payload, MessageId);
+		return -1;
+	}
+}
+
+class ERR_HQNetwork
+{
+	protected ref array<ref ERR_HQRadioNode> m_Nodes = {};
+	protected ref array<int> m_Parents = {};
+	protected ref array<int> m_Depths = {};
+	protected ref map<IEntity, int> m_Indices = new map<IEntity, int>();
+	protected ref map<string, ref array<int>> m_Cells = new map<string, ref array<int>>();
+	bool Overflow;
+
+	void Clear()
+	{
+		m_Nodes.Clear();
+		m_Parents.Clear();
+		m_Depths.Clear();
+		m_Indices.Clear();
+		m_Cells.Clear();
+		Overflow = false;
+	}
+
+	protected string Cell(int x, int z)
+	{
+		return string.Format("%1:%2", x, z);
+	}
+
+	void Add(IEntity carrier, SCR_AIGroup group, int unitId, int capability)
+	{
+		if (m_Indices.Contains(carrier))
+			return;
+		if (m_Nodes.Count() >= 2048)
+		{
+			Overflow = true;
+			return;
+		}
+		ERR_HQRadioNode node = new ERR_HQRadioNode();
+		node.Carrier = carrier;
+		node.Group = group;
+		node.UnitId = unitId;
+		node.Capability = capability;
+		int index = m_Nodes.Count();
+		m_Nodes.Insert(node);
+		m_Indices.Insert(carrier, index);
+		m_Parents.Insert(-2);
+		m_Depths.Insert(99);
+		vector position = carrier.GetOrigin();
+		string key = Cell(Math.Floor(position[0] / 500), Math.Floor(position[2] / 500));
+		array<int> cell = m_Cells.Get(key);
+		if (!cell)
+		{
+			cell = {};
+			m_Cells.Insert(key, cell);
+		}
+		cell.Insert(index);
+	}
+
+	void Build()
+	{
+		array<int> queue = {};
+		int checks;
+		for (int root = 0; root < m_Nodes.Count(); root++)
+		{
+			if (m_Nodes[root].Capability == 2)
+			{
+				m_Parents[root] = -1;
+				m_Depths[root] = 0;
+				queue.Insert(root);
+			}
+		}
+		for (int head = 0; head < queue.Count(); head++)
+		{
+			int from = queue[head];
+			if (m_Depths[from] >= 3)
+				continue;
+			vector position = m_Nodes[from].Carrier.GetOrigin();
+			int x = Math.Floor(position[0] / 500);
+			int z = Math.Floor(position[2] / 500);
+			for (int dx = -1; dx <= 1; dx++)
+			{
+				for (int dz = -1; dz <= 1; dz++)
+				{
+					array<int> neighbors = m_Cells.Get(Cell(x + dx, z + dz));
+					if (!neighbors)
+						continue;
+					foreach (int candidate : neighbors)
+					{
+						if (++checks > 100000)
+						{
+							Overflow = true;
+							return;
+						}
+						if (m_Parents[candidate] != -2 || vector.DistanceXZ(position, m_Nodes[candidate].Carrier.GetOrigin()) > 500)
+							continue;
+						m_Parents[candidate] = from;
+						m_Depths[candidate] = m_Depths[from] + 1;
+						queue.Insert(candidate);
+					}
+				}
+			}
+		}
+	}
+
+	ERR_HQRoute Route(IEntity caller, bool downlink = false)
+	{
+		int index;
+		if (!m_Indices.Find(caller, index) || m_Parents[index] == -2)
+			return null;
+		ERR_HQRoute route = new ERR_HQRoute();
+		route.Downlink = downlink;
+		while (index >= 0)
+		{
+			if (downlink)
+				route.Nodes.InsertAt(m_Nodes[index], 0);
+			else
+				route.Nodes.Insert(m_Nodes[index]);
+			index = m_Parents[index];
+		}
+		return route;
+	}
+}
@@ -0,0 +1,199 @@
+// These samples exist only at intake. HQ never revisits their entity loadouts.
+class ERR_HQVisualContact
+{
+	IEntity Entity;
+	vector Position;
+	float ObservedAt;
+	bool Escapist;
+	string Travel = "unknown";
+	string Weapon = "unknown";
+}
+
+class ERR_HQObservation
+{
+	// Require current native line of sight before reading visible equipment.
+	static bool IsClearSighting(float age, float traceFraction, float exposure)
+	{
+		return age >= 0 && age <= 0.5 && traceFraction >= 1 && exposure > 0;
+	}
+
+	static bool CanIdentifyWeapon(float distance, float exposure)
+	{
+		return distance >= 0 && distance <= 150 && exposure >= 0.5;
+	}
+
+	static string WeaponCategory(EWeaponType type)
+	{
+		switch (type)
+		{
+			case EWeaponType.WT_HANDGUN: return "pistol";
+			case EWeaponType.WT_RIFLE: return "rifle";
+			case EWeaponType.WT_SNIPERRIFLE: return "sniper rifle";
+			case EWeaponType.WT_MACHINEGUN: return "machine gun";
+			case EWeaponType.WT_ROCKETLAUNCHER: return "rocket launcher";
+			case EWeaponType.WT_GRENADELAUNCHER: return "grenade launcher";
+			case EWeaponType.WT_FRAGGRENADE: return "grenade";
+			case EWeaponType.WT_SMOKEGRENADE: return "smoke grenade";
+		}
+		return "unidentified weapon";
+	}
+
+	static ERR_HQVisualContact Capture(BaseTarget target, float now)
+	{
+		if (!target || target.GetTargetCategory() != ETargetCategory.ENEMY || !IsClearSighting(target.GetTimeSinceSeen(), target.GetTraceFraction(), target.GetExposure()))
+			return null;
+		DamageManagerComponent damage = target.GetDamageManagerComponent();
+		if (damage && damage.IsDestroyed())
+			return null;
+		IEntity entity = target.GetTargetEntity();
+		if (!entity)
+			return null;
+		ERR_HQVisualContact seen = new ERR_HQVisualContact();
+		seen.Entity = entity;
+		seen.Position = target.GetLastSeenPosition();
+		seen.ObservedAt = now - target.GetTimeSinceSeen() * 1000;
+		SCR_ChimeraCharacter character = SCR_ChimeraCharacter.Cast(entity);
+		if (character)
+		{
+			if (GetGame().GetPlayerManager())
+				seen.Escapist = GetGame().GetPlayerManager().GetPlayerIdFromControlledEntity(entity) > 0;
+			seen.Travel = "on foot";
+			if (CompartmentAccessComponent.GetVehicleIn(entity))
+				seen.Travel = "in vehicle";
+			// Read only the drawn weapon; never enumerate weapons or inventory.
+			if (CanIdentifyWeapon(target.GetDistance(), target.GetExposure()))
+			{
+				CharacterControllerComponent controller = CharacterControllerComponent.Cast(entity.FindComponent(CharacterControllerComponent));
+				if (controller)
+				{
+					IEntity heldItem = controller.GetCurrentItemInHands();
+					BaseWeaponComponent weapon;
+					if (heldItem)
+						weapon = BaseWeaponComponent.Cast(heldItem.FindComponent(BaseWeaponComponent));
+					seen.Weapon = "none drawn";
+					if (weapon)
+						seen.Weapon = WeaponCategory(weapon.GetWeaponType());
+				}
+			}
+		}
+		else if (Vehicle.Cast(entity))
+		{
+			seen.Travel = "vehicle";
+			if (target.GetUnitType() == EAIUnitType.UnitType_Aircraft)
+				seen.Travel = "aircraft";
+		}
+		return seen;
+	}
+
+	static void Gather(SCR_AIGroupUtilityComponent utility, float now, out array<ref ERR_HQVisualContact> samples)
+	{
+		samples.Clear();
+		if (!utility)
+			return;
+		array<BaseTarget> visible = {};
+		utility.ERR_HQGetVisualTargets(visible);
+		foreach (BaseTarget target : visible)
+		{
+			ERR_HQVisualContact seen = Capture(target, now);
+			if (!seen)
+				continue;
+			ERR_HQVisualContact existing;
+			foreach (ERR_HQVisualContact sample : samples)
+			{
+				if (sample.Entity == seen.Entity)
+				{
+					existing = sample;
+					break;
+				}
+			}
+			if (!existing)
+			{
+				if (samples.Count() < 64)
+					samples.Insert(seen);
+			}
+			else if (seen.ObservedAt > existing.ObservedAt || (seen.ObservedAt == existing.ObservedAt && existing.Weapon == "unknown" && seen.Weapon != "unknown"))
+			{
+				existing.Position = seen.Position;
+				existing.ObservedAt = seen.ObservedAt;
+				existing.Travel = seen.Travel;
+				existing.Weapon = seen.Weapon;
+			}
+		}
+	}
+
+	static void Describe(ERR_HQReport report, array<ref ERR_HQVisualContact> samples, float now)
+	{
+		// New observations must not silently inherit old equipment/travel details.
+		report.SeenEscapists = -1;
+		report.TravelMode = "unknown";
+		report.SeenWeapons = "unknown";
+		report.DetailsObservedAt = -1;
+		if (report.Distress)
+			return;
+		ERR_HQVisualContact anchor;
+		foreach (ERR_HQVisualContact sample : samples)
+		{
+			if (sample.Entity == report.Target && now - sample.ObservedAt >= 0 && now - sample.ObservedAt <= 500)
+			{
+				anchor = sample;
+				break;
+			}
+		}
+		if (!anchor)
+			return;
+		report.DetailsObservedAt = anchor.ObservedAt;
+		report.TravelMode = anchor.Travel;
+		report.SeenWeapons = anchor.Weapon;
+		array<IEntity> counted = {};
+		array<string> weapons = {};
+		string travel;
+		foreach (ERR_HQVisualContact sighting : samples)
+		{
+			if (!sighting.Escapist || !sighting.Entity || counted.Contains(sighting.Entity) || now - sighting.ObservedAt < 0 || now - sighting.ObservedAt > 500 || vector.DistanceXZ(anchor.Position, sighting.Position) > 100)
+				continue;
+			counted.Insert(sighting.Entity);
+			if (travel.IsEmpty())
+				travel = sighting.Travel;
+			else if (travel != sighting.Travel)
+				travel = "mixed travel";
+			if (sighting.Weapon != "unknown" && !weapons.Contains(sighting.Weapon) && weapons.Count() < 4)
+				weapons.Insert(sighting.Weapon);
+		}
+		if (counted.IsEmpty())
+			return; // A visible vehicle does not reveal its hidden occupants.
+		report.SeenEscapists = counted.Count();
+		// A vehicle anchor remains a vehicle report, even with people near it.
+		if (anchor.Escapist)
+			report.TravelMode = travel;
+		report.SeenWeapons = "unknown";
+		if (!weapons.IsEmpty())
+		{
+			report.SeenWeapons = weapons[0];
+			for (int i = 1; i < weapons.Count(); i++)
+				report.SeenWeapons += ", " + weapons[i];
+		}
+	}
+}
+
+modded class SCR_AIGroupUtilityComponent
+{
+	void ERR_HQGetVisualTargets(out array<BaseTarget> targets)
+	{
+		targets.Clear();
+		foreach (SCR_AIInfoComponent info : m_aInfoComponents)
+		{
+			if (!info || !info.m_Perception)
+				continue;
+			AIAgent observer = AIAgent.Cast(info.GetOwner());
+			if (!observer || !ERR_Actors.CanFight(observer.GetControlledEntity()))
+				continue;
+			array<BaseTarget> own = {};
+			info.m_Perception.GetTargetsList(own, ETargetCategory.ENEMY);
+			foreach (BaseTarget target : own)
+			{
+				if (target && ERR_HQObservation.IsClearSighting(target.GetTimeSinceSeen(), target.GetTraceFraction(), target.GetExposure()))
+					targets.Insert(target);
+			}
+		}
+	}
+}
@@ -0,0 +1,144 @@
+// A radio's category is protected in the stock gadget component.
+modded class SCR_RadioComponent
+{
+	bool ERR_IsHQManpack()
+	{
+		return m_iRadioCategory == ERadioCategory.MANPACK;
+	}
+}
+
+class ERR_HQRadio
+{
+	// 0: no radio, 1: basic radio, 2: manpack. Inventory is checked live.
+	static int Capability(IEntity character)
+	{
+		if (!ERR_Actors.CanFight(character))
+			return 0;
+		InventoryStorageManagerComponent inventory = InventoryStorageManagerComponent.Cast(character.FindComponent(InventoryStorageManagerComponent));
+		if (!inventory)
+			return 0;
+		array<IEntity> items = {};
+		inventory.GetItems(items);
+		int result;
+		foreach (IEntity item : items)
+		{
+			if (!item || !item.FindComponent(BaseRadioComponent))
+				continue;
+			result = 1;
+			SCR_RadioComponent gadget = SCR_RadioComponent.Cast(item.FindComponent(SCR_RadioComponent));
+			if (gadget && gadget.ERR_IsHQManpack())
+				return 2;
+		}
+		return result;
+	}
+}
+
+// HQ uses entity identity only for matching observations, never for its origin.
+// Visible details are captured at intake and copied as scalar snapshots.
+// Reports and orders contain immutable observed coordinates and timestamps.
+class ERR_HQReport
+{
+	int MessageId;
+	IEntity Target;
+	SCR_AIGroup Source;
+	vector Position;
+	vector Velocity;
+	float ObservedAt = -1;
+	float LastSent = -60000;
+	float PerceptionStamp = -1;
+	bool HasVelocity;
+	bool Engaged;
+	bool Distress;
+	int SeenEscapists = -1;
+	string TravelMode = "unknown";
+	string SeenWeapons = "unknown";
+	float DetailsObservedAt = -1;
+
+	ERR_HQReport Snapshot()
+	{
+		ERR_HQReport copy = new ERR_HQReport();
+		copy.MessageId = MessageId;
+		copy.Target = Target;
+		copy.Source = Source;
+		copy.Position = Position;
+		copy.Velocity = Velocity;
+		copy.ObservedAt = ObservedAt;
+		copy.Engaged = Engaged;
+		copy.Distress = Distress;
+		copy.HasVelocity = HasVelocity;
+		copy.SeenEscapists = SeenEscapists;
+		copy.TravelMode = TravelMode;
+		copy.SeenWeapons = SeenWeapons;
+		copy.DetailsObservedAt = DetailsObservedAt;
+		return copy;
+	}
+
+	string TravelDirection()
+	{
+		if (!HasVelocity)
+			return "unknown";
+		if (Velocity.Length() < 0.5)
+			return "stationary";
+		float x = Math.AbsFloat(Velocity[0]);
+		float z = Math.AbsFloat(Velocity[2]);
+		string northSouth = "N";
+		string eastWest = "E";
+		if (Velocity[2] < 0)
+			northSouth = "S";
+		if (Velocity[0] < 0)
+			eastWest = "W";
+		if (x < z * 0.414214)
+			return northSouth;
+		if (z < x * 0.414214)
+			return eastWest;
+		return northSouth + eastWest;
+	}
+
+	string Description(float now, bool brief = false)
+	{
+		if (Distress)
+			return string.Format("Distress at friendly X=%1 Z=%2; enemy details unknown (%3s ago)", Math.Round(Position[0]), Math.Round(Position[2]), Math.Round(Math.Max(0, now - ObservedAt) / 1000));
+		string count = "count unknown";
+		if (SeenEscapists >= 0)
+			count = "at least " + SeenEscapists.ToString() + " spotted nearby";
+		string motion = "speed/direction unknown";
+		if (HasVelocity)
+		{
+			float speed = Math.Round(Velocity.Length() * 10) / 10.0;
+			float azimuth = Math.Atan2(Velocity[0], Velocity[2]) * Math.RAD2DEG;
+			if (azimuth < 0)
+				azimuth += 360;
+			int heading = Math.Round(azimuth);
+			motion = string.Format("%1 km/h, azimuth %2 degrees (%3)", Math.Round(speed * 3.6), heading % 360, TravelDirection());
+		}
+		string details = count + "; " + TravelMode + "; " + motion + "; seen weapons: " + SeenWeapons;
+		if (brief)
+			return details;
+		string velocity = "unknown";
+		if (HasVelocity)
+			velocity = string.Format("[%1,%2] m/s", Math.Round(Velocity[0] * 10) / 10.0, Math.Round(Velocity[2] * 10) / 10.0);
+		return string.Format("X=%1 Z=%2: %3; vector X/Z=%4 (%5s ago)", Math.Round(Position[0]), Math.Round(Position[2]), details, velocity, Math.Round(Math.Max(0, now - ObservedAt) / 1000));
+	}
+
+	static vector Predict(vector position, vector velocity, float seconds)
+	{
+		vector offset = velocity * Math.Clamp(seconds, 0, 20);
+		offset[1] = 0;
+		if (offset.Length() > 300)
+			offset = offset.Normalized() * 300;
+		return position + offset;
+	}
+
+	int Priority(float now)
+	{
+		if (Distress)
+			return 0;
+		if (now - ObservedAt <= 15000)
+		{
+			if (Engaged)
+				return 3;
+			return 2;
+		}
+		return 1;
+	}
+}
@@ -0,0 +1,31 @@
+// An idle rotor or zero speed alone is normal during takeoff, landing and reload.
+// Confirm prolonged grounding, but recognize actual loss of flight capability.
+class ERR_HelicopterAvailability
+{
+	protected float m_fGroundedSince = -1;
+
+	string Check(float now, float spawnedAt, bool destroyed, bool disabled, bool livingPilot, bool playerControlled, bool servicing, float height, float speed)
+	{
+		if (destroyed) return "destroyed";
+		if (now - spawnedAt < 20000)
+		{
+			m_fGroundedSince = -1;
+			return "";
+		}
+		if (disabled) return "engine, rotor or airframe disabled";
+		if (playerControlled)
+		{
+			m_fGroundedSince = -1;
+			return "";
+		}
+		if (!livingPilot) return "no living pilot";
+		if (servicing || height > 5 || speed > 2)
+		{
+			m_fGroundedSince = -1;
+			return "";
+		}
+		if (m_fGroundedSince < 0) m_fGroundedSince = now;
+		if (now - m_fGroundedSince >= 60000) return "grounded for 60 seconds";
+		return "";
+	}
+}
@@ -0,0 +1,461 @@
+// Migrated from the independently authored AI extension; successor-owned physical groups.
+// Each site/phase has its own repeat limiter. Changed reasons and lifecycle
+// events are immediate; only identical polling results are summarized.
+class ERR_MortarTraceState
+{
+	string LastReason;
+	float NextLog;
+	int Suppressed;
+
+	bool Due(string reason, float now)
+	{
+		if (reason != LastReason || now >= NextLog)
+		{
+			LastReason = reason;
+			NextLog = now + 30000;
+			return true;
+		}
+		Suppressed++;
+		return false;
+	}
+}
+
+class ERR_MortarBattery
+{
+	static const ResourceName GUN = "{D1FFE458E8AC4BDB}Prefabs/Weapons/Mortars/2B14/Mortar_2B14.et";
+	static const ResourceName SHELL = "{98EC9C526AFBA282}Prefabs/Weapons/Ammo/Ammo_Shell_82mm_HE_O832DU.et";
+	static const ResourceName CREW = "{86E565387A634103}Prefabs/Characters/Campaign/Final/OPFOR/USSR_Army/Regular/Campaign_USSR_Player_MortarCrew.et";
+	static const ResourceName RADIO_OPERATOR = "{612F43A4D5AE765F}Prefabs/Characters/Factions/OPFOR/USSR_Army/Character_USSR_RTO.et";
+	IEntity RadioOperator;
+	IEntity Gun;
+	SCR_AIGroup Group;
+	ref SCR_AIStaticArtilleryActivity Activity;
+	ref ERR_HQReport Report;
+	ref ERR_HQRoute RadioOrder;
+	ref ERR_HQReport PendingRadioReport;
+	ref ERR_HQReport PendingSupplyReport;
+	protected ref ERR_MortarReadiness m_Readiness;
+	protected ref ERR_MortarSupplyTransfer m_Transfer;
+	protected ref array<IEntity> m_AttemptedShells = {};
+	protected bool m_Stopped;
+	vector Position;
+	vector Impact;
+	vector AimOffset;
+	int AimedShot = -1;
+	float FlightTime;
+	float AimedAt = -1;
+	float AirspaceUntil;
+	vector AirspaceImpact;
+	float AirspaceRadius = 600;
+	float OrderedAt;
+	float NextOrder;
+	float SpawnedAt;
+	bool StartupActivated;
+	bool Released;
+	bool Rejected;
+	bool Claimed; // keeps the world slot occupied after the battery is destroyed
+	int SiteId;
+	int OrderId;
+	int RadioId;
+	int SourceId;
+	int OrderShots;
+	int TotalShots;
+	bool CommandOpen;
+	string LastFailure;
+	string SpawnFailure;
+	vector LastCandidate;
+	ref map<string, int> SearchCounts = new map<string, int>();
+	ref map<string, ref ERR_MortarTraceState> Traces = new map<string, ref ERR_MortarTraceState>();
+
+	void Audit(string kind, string detail)
+	{
+		ERR_HQ.Event("MORTAR " + kind, string.Format("site=%1 order=%2 radio=M%3 source=M%4 position=%5; %6", SiteId, OrderId, RadioId, SourceId, Position, detail), RadioId);
+	}
+
+	void Trace(string phase, string reason, string detail)
+	{
+		ERR_MortarTraceState state;
+		if (!Traces.Find(phase, state))
+		{
+			state = new ERR_MortarTraceState();
+			Traces.Insert(phase, state);
+		}
+		string previous = state.LastReason;
+		if (!state.Due(reason, GetGame().GetWorld().GetWorldTime()))
+			return;
+		Audit(phase, string.Format("reason=%1; %2; previous=%3 repeated polls omitted=%4", reason, detail, previous, state.Suppressed));
+		state.Suppressed = 0;
+	}
+
+	void FlushTraces()
+	{
+		foreach (string phase, ERR_MortarTraceState state : Traces)
+		{
+			if (state.Suppressed > 0)
+				Audit("REPEATS", string.Format("phase=%1 reason=%2 repeated polls omitted=%3", phase, state.LastReason, state.Suppressed));
+		}
+		Traces.Clear();
+	}
+
+	string OperationalReason()
+	{
+		if (m_Stopped) return "battery stopped";
+		if (!Gun) return "gun missing";
+		if (!SpawnFailure.IsEmpty()) return SpawnFailure;
+		if (!Group || !Group.GetGroupUtilityComponent()) return "crew group missing";
+		if (Group.GetFaction() != ERR_GameMode.Get().EnemyFaction()) return "crew changed faction";
+		if (Group.GetPlayerCount(true) > 0) return "player in crew group";
+		if (Group.GetAgentsCount() == 0) return "crew group empty";
+		DamageManagerComponent damage = DamageManagerComponent.Cast(Gun.FindComponent(DamageManagerComponent));
+		if (damage && damage.IsDestroyed()) return "gun destroyed";
+		return "";
+	}
+
+	void BeginRequest(ERR_HQReport report, float now)
+	{
+		Cancel("superseded by new HQ order");
+		FlushTraces();
+		OrderId++;
+		RadioId = 0;
+		SourceId = report.MessageId;
+		OrderShots = 0;
+		Released = false;
+		CommandOpen = true;
+		OrderedAt = now;
+		LastFailure = "";
+		Audit("COMMAND", string.Format("requested rounds=%1 HE radius=%2m; %3", ERR_MortarSalvo.ROUNDS, ERR_MortarSalvo.RADIUS_METRES, report.Description(now)));
+	}
+
+	void ObserveProjectile(IEntity projectileEntity, IEntity firingCharacter, bool playerGunner)
+	{
+		if (!projectileEntity)
+		{
+			Audit("FIRE CALLBACK", "native OnWeaponFired had no projectile; no confirmed shot counted");
+			return;
+		}
+		TotalShots++;
+		if (CommandOpen && Released && !playerGunner)
+		{
+			OrderShots++;
+			// Only a physical projectile unlocks the next load. It must be aimed again.
+			Released = false;
+			AimedAt = -1;
+			Audit("FIRED", string.Format("physical projectile=%1 origin=%2 order shots=%3 total shots=%4 predicted impact=%5 predicted flight=%6s gunner=%7 (impact not observed)", projectileEntity, projectileEntity.GetOrigin(), OrderShots, TotalShots, Impact, FlightTime, firingCharacter));
+		}
+		else
+			Audit("FIRED UNASSIGNED", string.Format("physical projectile=%1 origin=%2 player gunner=%3 order open=%4 committed=%5 total shots=%6; no active HQ order attribution", projectileEntity, projectileEntity.GetOrigin(), playerGunner, CommandOpen, Released, TotalShots));
+	}
+
+	void ReserveShellAirspace(float now)
+	{
+		// Enclose every still-airborne shell, including an earlier, longer flight.
+		// A later round must not move/shrink the existing exclusion or deadline.
+		if (now >= AirspaceUntil)
+		{
+			AirspaceImpact = Impact;
+			AirspaceRadius = 600;
+		}
+		AirspaceRadius = Math.Max(AirspaceRadius, vector.DistanceXZ(AirspaceImpact, Impact) + 600);
+		AirspaceUntil = Math.Max(AirspaceUntil, now + (FlightTime + 10) * 1000);
+	}
+
+	bool SpawnFailed(string reason)
+	{
+		SpawnFailure = reason;
+		Audit("DEPLOY FAILED", string.Format("reason=%1 claimed=%2 gun=%3 group=%4", reason, Claimed, Gun, Group));
+		return false;
+	}
+
+	void SearchResult(vector candidate, string reason)
+	{
+		LastCandidate = candidate;
+		int count;
+		SearchCounts.Find(reason, count);
+		SearchCounts.Set(reason, count + 1);
+	}
+
+	void SiteStatus(float now)
+	{
+		if (!SearchCounts.IsEmpty())
+		{
+			string counts;
+			foreach (string reason, int count : SearchCounts) counts += string.Format("%1=%2; ", reason, count);
+			Audit("SITE SEARCH", string.Format("candidate counts since last summary: %1 last candidate=%2", counts, LastCandidate));
+			SearchCounts.Clear();
+		}
+		int agents, living;
+		int actionState = -1;
+		if (Group)
+		{
+			array<AIAgent> crew = {};
+			Group.GetAgents(crew);
+			agents = crew.Count();
+			foreach (AIAgent agent : crew)
+			{
+				if (agent && ERR_Actors.CanFight(agent.GetControlledEntity())) living++;
+			}
+		}
+		if (Activity) actionState = Activity.GetActionState();
+		bool connected;
+		ERR_HQ hq = ERR_HQ.Get();
+		if (hq && Group) connected = hq.MortarConnected(Group);
+		Audit("SITE STATUS", string.Format("claimed=%1 startup=%2 operational=%3 crew agents=%4 fighting=%5 inventory HE=%6 radio connected=%7 cooldown remaining=%8s", Claimed, StartupActivated, Operational(), agents, living, CountShells(), connected, Math.Max(0, NextOrder - now) / 1000));
+		Audit("ORDER STATUS", string.Format("open=%1 route pending=%2 native action=%3 shell committed=%4 order shots=%5 total shots=%6 age=%7s last failure=%8", CommandOpen, RadioOrder != null, actionState, Released, OrderShots, TotalShots, Math.Max(0, now - OrderedAt) / 1000, LastFailure));
+		if (!SpawnFailure.IsEmpty()) Audit("PARTIAL DEPLOYMENT", SpawnFailure);
+		if (!Operational()) Trace("SITE BLOCK", OperationalReason(), "spawn failure=" + SpawnFailure);
+	}
+
+	bool Operational()
+	{
+		return OperationalReason().IsEmpty();
+	}
+
+	int CountShells()
+	{
+		if (!Group)
+			return 0;
+		int count;
+		array<IEntity> items = {};
+		array<AIAgent> agents = {};
+		Group.GetAgents(agents);
+		foreach (AIAgent agent : agents)
+		{
+			if (!agent || !ERR_Actors.CanFight(agent.GetControlledEntity()))
+				continue;
+			InventoryStorageManagerComponent inventory = InventoryStorageManagerComponent.Cast(agent.GetControlledEntity().FindComponent(InventoryStorageManagerComponent));
+			if (!inventory)
+				continue;
+			ERR_Inventory.AppendUnique(inventory, items);
+		}
+		foreach (IEntity item : items)
+			if (item && item.GetPrefabData() && item.GetPrefabData().GetPrefabName() == SHELL) count++;
+		return count;
+	}
+
+	void Bind(int siteId, SCR_AIGroup group, IEntity gun, float now)
+	{
+		SiteId = siteId;
+		Group = group;
+		Gun = gun;
+		Position = gun.GetOrigin();
+		SpawnedAt = now;
+		Claimed = true;
+		m_Readiness = new ERR_MortarReadiness(this);
+	}
+
+
+	int InventoryShells(InventoryStorageManagerComponent inventory)
+	{
+		if (!inventory)
+			return 0;
+		int count;
+		array<IEntity> items = {};
+		ERR_Inventory.Items(inventory, items);
+		foreach (IEntity item : items)
+		{
+			if (item && item.GetPrefabData() && item.GetPrefabData().GetPrefabName() == SHELL)
+				count++;
+		}
+		return count;
+	}
+
+	bool Stopped() { return m_Stopped; }
+	bool SupplyPending() { return m_Transfer && m_Transfer.Unresolved(); }
+	bool SupplyAuthorized(float now)
+	{
+		if (!Replication.IsServer() || m_Stopped || !StartupActivated || !Operational() || !CommandOpen || !ERR_HQ.MissionActive()) return false;
+		ERR_MortarSystem system = ERR_MortarSystem.Get();
+		if (!system || system.FindGun(Gun) != this) return false;
+		ERR_HQReport suppliedReport = Report;
+		if (!suppliedReport) suppliedReport = PendingSupplyReport;
+		return ERR_MortarPrediction.Fresh(suppliedReport, now);
+	}
+	void Stop()
+	{
+		if (m_Stopped) return;
+		m_Stopped = true;
+		Cancel("HQ stopped");
+		if (m_Readiness) m_Readiness.Stop();
+	}
+
+	ERR_MortarSupplyState SupplyState(float now)
+	{
+		// Observe an existing native operation even after its order was canceled.
+		// No second request may race an unresolved transfer on this battery.
+		if (m_Transfer)
+		{
+			ERR_MortarSupplyState observed = m_Transfer.Poll(now);
+			if (m_Transfer.CapturedOrder() == OrderId)
+			{
+				if (observed == ERR_MortarSupplyState.READY) m_Transfer = null;
+				return observed;
+			}
+			if (m_Transfer.Unresolved()) return ERR_MortarSupplyState.FAILED;
+			m_Transfer = null;
+		}
+		if (!SupplyAuthorized(now)) return SupplyStateFailed("current HQ order, crew or report is unavailable");
+		SCR_AIVehicleUsageComponent usage = SCR_AIVehicleUsageComponent.Cast(Gun.FindComponent(SCR_AIVehicleUsageComponent));
+		IEntity gunner;
+		if (usage && usage.GetTurretCompartmentSlot())
+			gunner = usage.GetTurretCompartmentSlot().GetOccupant();
+		array<AIAgent> agents = {};
+		Group.GetAgents(agents);
+		float nearest = float.MAX;
+		if (!gunner)
+		{
+			foreach (AIAgent candidate : agents)
+			{
+				if (!candidate || candidate.GetControlledEntity() == RadioOperator || !ERR_Actors.CanFight(candidate.GetControlledEntity()))
+					continue;
+				float distance = vector.DistanceXZ(Gun.GetOrigin(), candidate.GetControlledEntity().GetOrigin());
+				if (distance < nearest)
+				{
+					nearest = distance;
+					gunner = candidate.GetControlledEntity();
+				}
+			}
+		}
+		if (!gunner) return SupplyStateFailed("no fighting gunner found");
+		if (ERR_Actors.Group(gunner) != Group) return SupplyStateFailed("turret occupant belongs to another group");
+		if (!ERR_Actors.CanFight(gunner)) return SupplyStateFailed("gunner cannot fight");
+		InventoryStorageManagerComponent destination = InventoryStorageManagerComponent.Cast(gunner.FindComponent(InventoryStorageManagerComponent));
+		if (!destination)
+			return SupplyStateFailed("gunner inventory missing");
+		if (InventoryShells(destination) > 0)
+			return ERR_MortarSupplyState.READY;
+		int nearbyDonors, donorShells, storageRejected;
+		array<IEntity> consideredShells = {};
+		foreach (AIAgent bearer : agents)
+		{
+			if (!bearer || !ERR_Actors.CanFight(bearer.GetControlledEntity()))
+				continue;
+			IEntity donor = bearer.GetControlledEntity();
+			if (donor == gunner || vector.DistanceXZ(donor.GetOrigin(), gunner.GetOrigin()) > 12)
+				continue;
+			InventoryStorageManagerComponent inventory = InventoryStorageManagerComponent.Cast(donor.FindComponent(InventoryStorageManagerComponent));
+			if (!inventory)
+				continue;
+			nearbyDonors++;
+			array<IEntity> items = {};
+			ERR_Inventory.Items(inventory, items);
+			foreach (IEntity item : items)
+			{
+				if (!item || !item.GetPrefabData() || item.GetPrefabData().GetPrefabName() != SHELL)
+					continue;
+				if (consideredShells.Contains(item) || m_AttemptedShells.Contains(item)) continue;
+				consideredShells.Insert(item);
+				donorShells++;
+				BaseInventoryStorageComponent storage = destination.FindStorageForItem(item, EStoragePurpose.PURPOSE_DEPOSIT);
+				if (!storage) { storageRejected++; continue; }
+				m_AttemptedShells.Insert(item); // even rejected/ambiguous requests are never retried
+				m_Transfer = new ERR_MortarSupplyTransfer(this, donor, gunner, item, storage, now);
+				if (!m_Transfer.Begin(now)) return SupplyStateFailed("exact shell transfer request rejected; no retry");
+				Audit("AMMO TRANSFER", string.Format("one exact-item move pending donor=%1 gunner=%2 shell=%3 order=%4; awaiting callback AND physical destination", donor, gunner, item, OrderId));
+				return ERR_MortarSupplyState.PENDING;
+			}
+		}
+		return SupplyStateFailed(string.Format("gunner empty; fighting donors within 12m=%1 unattempted HE=%2 destination storage rejected=%3", nearbyDonors, donorShells, storageRejected));
+	}
+
+	// Compatibility for existing native callers; request acceptance is NOT ready.
+	bool SupplyGunner() { return SupplyState(GetGame().GetWorld().GetWorldTime()) == ERR_MortarSupplyState.READY; }
+	protected ERR_MortarSupplyState SupplyStateFailed(string reason)
+	{
+		SupplyFailed(reason);
+		return ERR_MortarSupplyState.FAILED;
+	}
+
+	bool SupplyFailed(string reason)
+	{
+		LastFailure = reason;
+		Audit("AMMO FAILED", reason);
+		return false;
+	}
+
+	void Cancel(string reason = "cancel requested")
+	{
+		if (CommandOpen)
+		{
+			FlushTraces();
+			Audit("ORDER END", string.Format("reason=%1 observed shots=%2 shell committed=%3 elapsed=%4s last failure=%5", reason, OrderShots, Released, (GetGame().GetWorld().GetWorldTime() - OrderedAt) / 1000, LastFailure));
+		}
+		CommandOpen = false;
+		RadioOrder = null;
+		PendingRadioReport = null;
+		PendingSupplyReport = null;
+		if (m_Transfer) m_Transfer.Invalidate();
+		Report = null;
+		AimedAt = -1;
+		if (Activity)
+			Activity.Complete();
+		Activity = null;
+	}
+
+	// Idle distant batteries still report through HQ's scheduler. Their native
+	// AI needs full detail while firing or when players can interact with them.
+	protected void UpdateCrewDetail(float now, bool firing = false)
+	{
+		if (!Group || Group.GetPlayerCount(true) > 0)
+			return;
+		bool active = firing || Activity != null || ERR_MortarSystem.NearPlayer(Position);
+		int lod = -1;
+		if (active)
+			lod = 0;
+		if (Group.GetPermanentLOD() != lod)
+			Group.SetPermanentLOD(lod);
+		if (active && !Group.IsAIActivated())
+			Group.ActivateAI();
+		array<AIAgent> agents = {};
+		Group.GetAgents(agents);
+		foreach (AIAgent agent : agents)
+		{
+			if (!agent || EntityUtils.IsPlayer(agent.GetControlledEntity()))
+				continue;
+			if (agent.GetPermanentLOD() != lod)
+				agent.SetPermanentLOD(lod);
+			if (active && !agent.IsAIActivated() && ERR_Actors.CanFight(agent.GetControlledEntity()))
+				agent.ActivateAI();
+		}
+	}
+
+	void Update(float now)
+	{
+		if (m_Stopped) return;
+		if (!StartupActivated)
+		{
+			if (!SpawnFailure.IsEmpty()) return;
+			if (!m_Readiness) { SpawnFailed("initial support readiness owner missing"); return; }
+			ERR_MortarSupplyState startup = m_Readiness.Poll(now);
+			if (startup != ERR_MortarSupplyState.READY) return;
+			StartupActivated = true;
+		}
+		if (m_Transfer) m_Transfer.Poll(now);
+		if (!Operational())
+		{
+			Cancel(OperationalReason());
+			return;
+		}
+		if (Activity)
+		{
+			Trace("ACTIVITY", string.Format("native state=%1", Activity.GetActionState()), string.Format("age=%1s aim age=%2s committed=%3 shots=%4", (now - OrderedAt) / 1000, (now - AimedAt) / 1000, Released, OrderShots));
+			if (Activity.GetActionState() == EAIActionState.FAILED) Cancel("native artillery activity FAILED");
+			else if (Activity.GetActionState() == EAIActionState.COMPLETED) Cancel("native artillery activity COMPLETED (shot count is separate)");
+			else if (now - OrderedAt > ERR_MortarSalvo.TIMEOUT_MS) Cancel("120s artillery salvo timeout");
+		}
+		if (StartupActivated)
+			UpdateCrewDetail(now);
+	}
+
+	void Order(ERR_HQReport report, float now)
+	{
+		if (m_Stopped || !StartupActivated || !Operational() || !CommandOpen || Activity || !ERR_MortarPrediction.Fresh(report, now)) return;
+		Report = report.Snapshot();
+		OrderedAt = now;
+		NextOrder = now + 30000;
+		Released = false;
+		UpdateCrewDetail(now, true);
+		Activity = new SCR_AIStaticArtilleryActivity(Group.GetGroupUtilityComponent(), null, report.Position, SCR_EAIArtilleryAmmoType.HIGH_EXPLOSIVE, ERR_MortarSalvo.ROUNDS);
+		Group.GetGroupUtilityComponent().AddAction(Activity);
+		Audit("AIM", string.Format("native activity created; latest source=M%1 observed=%2", report.MessageId, report.Description(now)));
+	}
+}
@@ -0,0 +1,231 @@
+// The dedicated manpack operator has no mortar-shell backpack. Preserve the
+// native chooser and its caller's original index for every eligible gunner.
+modded class SCR_AIStaticArtilleryActivity
+{
+	protected override AIAgent FindBestAgentForArtillery(notnull array<AIAgent> agents, notnull IEntity artilleryEntity, out int outIndex)
+	{
+		ERR_MortarSystem system = ERR_MortarSystem.Get();
+		ERR_MortarBattery battery;
+		if (system) battery = system.FindGun(artilleryEntity);
+		if (!battery) return super.FindBestAgentForArtillery(agents, artilleryEntity, outIndex);
+		array<AIAgent> gunners = {};
+		foreach (AIAgent agent : agents)
+		{
+			if (agent && agent.GetControlledEntity() != battery.RadioOperator && ERR_Actors.CanFight(agent.GetControlledEntity()))
+				gunners.Insert(agent);
+		}
+		int filteredIndex;
+		AIAgent selected = super.FindBestAgentForArtillery(gunners, artilleryEntity, filteredIndex);
+		outIndex = -1;
+		if (selected) outIndex = agents.Find(selected);
+		return selected;
+	}
+}
+
+// Leave all other artillery (including player-operated captured guns) native.
+modded class SCR_AIGetArtilleryAimDistanceCompensation
+{
+	override ENodeResult EOnTaskSimulate(AIAgent owner, float dt)
+	{
+		IEntity gun;
+		GetVariableIn(PORT_ARTILLERY_ENTITY, gun);
+		ERR_MortarSystem system = ERR_MortarSystem.Get();
+		ERR_MortarBattery battery;
+		if (system)
+			battery = system.FindGun(gun);
+		if (!battery)
+			return super.EOnTaskSimulate(owner, dt);
+		battery.AimedAt = -1;
+		float now = GetGame().GetWorld().GetWorldTime();
+		ERR_HQReport report = system.Latest(battery, now);
+		if (!ERR_HQ.MissionActive()) { system.Withhold(battery, "aim: mission inactive"); return ENodeResult.FAIL; }
+		if (!battery.CommandOpen || battery.OrderShots >= ERR_MortarSalvo.ROUNDS) { system.Withhold(battery, "aim: salvo complete or order closed"); return ENodeResult.FAIL; }
+		if (battery.Released) { system.Withhold(battery, "aim: waiting for committed projectile"); return ENodeResult.FAIL; }
+		if (!report) { system.Withhold(battery, "aim: " + system.ContactFailure(battery)); return ENodeResult.FAIL; }
+		battery.Trace("AIM START", "solving moving intercept", string.Format("latest source=M%1; %2", report.MessageId, report.Description(now)));
+		ResourceName ammo;
+		GetVariableIn(PORT_AMMO_PREFAB, ammo);
+		if (ammo != ERR_MortarBattery.SHELL) { system.Withhold(battery, "unsupported ammunition prefab", ammo); return ENodeResult.FAIL; }
+		Resource resource = Resource.Load(ammo);
+		if (!resource || !resource.IsValid() || !resource.GetResource()) { system.Withhold(battery, "shell resource load failed", ammo); return ENodeResult.FAIL; }
+		IEntitySource source = resource.GetResource().ToEntitySource();
+		if (!source) { system.Withhold(battery, "shell resource has no entity source", ammo); return ENodeResult.FAIL; }
+		array<float> coefficients = {};
+		GetAmmoInitialSpeedCoefficients(ammo, coefficients);
+		if (coefficients.IsEmpty())
+			coefficients.Insert(1.0);
+		float minimum, maximum;
+		GetVerticalAimLimits(gun, minimum, maximum);
+		float flight = 30;
+		float offset;
+		int charge;
+		vector impact;
+		vector salvoOffset = ERR_MortarSalvo.Offset(battery.SiteId, battery.OrderId, battery.OrderShots);
+		bool converged;
+		// Iterate the moving intercept using the native shell's flight time.
+		// Reject non-convergence rather than fire with an arbitrary lead time.
+		for (int iteration = 0; iteration < 4; iteration++)
+		{
+			if (!ERR_MortarPrediction.Predict(report, now, flight + 2, impact)) { system.Withhold(battery, "aim prediction: " + ERR_MortarPrediction.FailureReason, string.Format("flight lead=%1s; %2", flight + 2, report.Description(now))); return ENodeResult.FAIL; }
+			if (!system.OutsideSettlements(impact)) { system.Withhold(battery, "aim target inside settlement exclusion", system.SettlementReason); return ENodeResult.FAIL; }
+			impact += salvoOffset;
+			impact[1] = SCR_TerrainHelper.GetTerrainY(impact);
+			float distance = vector.DistanceXZ(gun.GetOrigin(), impact);
+			float altitude = impact[1] - gun.GetOrigin()[1];
+			if (distance < 350 || distance > 4000) { system.Withhold(battery, "predicted impact out of range", string.Format("iteration=%1 distance=%2m impact=%3 allowed=350..4000m", iteration, distance, impact)); return ENodeResult.FAIL; }
+			bool reachable;
+			float calculated;
+			for (int i = 0; i < coefficients.Count(); i++)
+			{
+				if (!BallisticTable.GetAimHeightOfProjectileAltitudeFromSource(distance, offset, calculated, source, altitude, coefficients[i]))
+					continue;
+				float tangent = (offset + altitude) / distance;
+				if (calculated <= 0 || calculated > 75 || tangent < Math.Tan(minimum) || tangent > Math.Tan(maximum))
+					continue;
+				charge = i;
+				reachable = true;
+				break;
+			}
+			if (!reachable) { system.Withhold(battery, "no native ballistic solution within elevation/flight-time limits", string.Format("iteration=%1 distance=%2 altitude=%3 charges=%4 elevation radians=%5..%6 flight limit=75s", iteration, distance, altitude, coefficients.Count(), minimum, maximum)); return ENodeResult.FAIL; }
+			converged = Math.AbsFloat(calculated - flight) < 1;
+			flight = calculated;
+			if (converged)
+				break;
+		}
+		if (!converged) { system.Withhold(battery, "moving intercept did not converge in four iterations"); return ENodeResult.FAIL; }
+		if (!system.Safe(battery, impact, flight + 2)) { system.Withhold(battery, "aim impact safety rejected", system.SafetyReason); return ENodeResult.FAIL; }
+		battery.Impact = impact;
+		battery.AimOffset = salvoOffset;
+		battery.AimedShot = battery.OrderShots;
+		battery.FlightTime = flight;
+		battery.AimedAt = now;
+		battery.LastFailure = "";
+		battery.Trace("AIM SOLUTION", "ready", string.Format("predicted impact=%1 flight=%2s charge index=%3 aim height offset=%4m latest source=M%5", impact, flight, charge, offset, report.MessageId));
+		vector aim = impact + Vector(0, offset, 0);
+		SetVariableOut(PORT_AIM_POS, aim);
+		SetVariableOut(PORT_INIT_SPEED_ID, charge);
+		return ENodeResult.SUCCESS;
+	}
+}
+
+modded class SCR_AIShootStaticArtillery
+{
+	override ENodeResult EOnTaskSimulate(AIAgent owner, float dt)
+	{
+		IEntity gun;
+		GetVariableIn(PORT_ARTILLERY_ENTITY, gun);
+		ERR_MortarSystem system = ERR_MortarSystem.Get();
+		ERR_MortarBattery battery;
+		if (system)
+			battery = system.FindGun(gun);
+		if (battery && !system.AllowShot(battery))
+		{
+			battery.Trace("SHOOT NODE", "authorization rejected", battery.LastFailure);
+			return ENodeResult.FAIL;
+		}
+		ENodeResult result = super.EOnTaskSimulate(owner, dt);
+		if (battery)
+			battery.Trace("SHOOT NODE", string.Format("native result=%1", result), "authorization passed; node result does not confirm a physical shot");
+		return result;
+	}
+}
+
+modded class SCR_MortarMuzzleComponent
+{
+	protected override void TransferShellToMortar()
+	{
+		ERR_MortarSystem system = ERR_MortarSystem.Get();
+		ERR_MortarBattery battery;
+		if (system && m_CharController && !EntityUtils.IsPlayer(m_CharController.GetOwner()))
+			battery = system.FindGun(GetOwner());
+		if (battery)
+		{
+			// The loading animation takes time. Recheck at the actual transfer,
+			// before native inventory insertion triggers the physical projectile.
+			if (!system.AllowShot(battery))
+			{
+				if (m_ShellComponent)
+				{
+					m_ShellComponent.GetOnShellUsed().Remove(TransferShellToMortar);
+					m_ShellComponent.SetLoadedState(false);
+				}
+				CharacterAnimationComponent animation = m_CharController.GetAnimationComponent();
+				if (animation && animation.GetCommandHandler())
+					animation.GetCommandHandler().FinishItemUse(false);
+				battery.Audit("ABORT", "final shell transfer rejected; " + battery.LastFailure);
+				return;
+			}
+			battery.Released = true;
+			battery.ReserveShellAirspace(GetGame().GetWorld().GetWorldTime());
+			battery.Audit("SHELL COMMIT", string.Format("final safety passed; gunner=%1 predicted impact=%2 flight=%3s; invoking native transfer, awaiting projectile event", m_CharController.GetOwner(), battery.Impact, battery.FlightTime));
+		}
+		super.TransferShellToMortar();
+	}
+
+	override void OnWeaponFired(IEntity effectEntity, BaseMuzzleComponent muzzle, IEntity projectileEntity)
+	{
+		IEntity firingCharacter;
+		if (m_CharController) firingCharacter = m_CharController.GetOwner();
+		super.OnWeaponFired(effectEntity, muzzle, projectileEntity);
+		ERR_MortarSystem system = ERR_MortarSystem.Get();
+		ERR_MortarBattery battery;
+		if (system)
+			battery = system.FindGun(GetOwner());
+		if (!battery)
+			return;
+		bool playerGunner;
+		if (firingCharacter) playerGunner = EntityUtils.IsPlayer(firingCharacter);
+		battery.ObserveProjectile(projectileEntity, firingCharacter, playerGunner);
+	}
+}
+
+// The native tree normally re-aims only every five shots (and skips the first
+// re-aim). Each salvo shell needs its own spread point and fresh authorization.
+modded class SCR_AIStaticArtilleryBehavior
+{
+	ERR_MortarBattery ERR_GetMortarBattery()
+	{
+		ERR_MortarSystem system = ERR_MortarSystem.Get();
+		if (!system) return null;
+		return system.FindGun(m_ArtilleryEntity.m_Value);
+	}
+}
+
+modded class SCR_AIStaticArtilleryBehavior_ShootingLogic
+{
+	override ENodeResult EOnTaskSimulate(AIAgent owner, float dt)
+	{
+		ERR_MortarBattery battery;
+		SCR_AIStaticArtilleryBehavior behavior;
+		if (m_Utility)
+		{
+			behavior = SCR_AIStaticArtilleryBehavior.Cast(m_Utility.GetExecutedAction());
+			if (behavior) battery = behavior.ERR_GetMortarBattery();
+		}
+		if (battery)
+		{
+			int gate = ERR_MortarSupplyRules.CycleGate(battery.CommandOpen, battery.OrderShots, behavior.GetShotCount(), ERR_MortarSalvo.ROUNDS, ERR_MortarSupplyState.READY);
+			if (gate < 0) return ENodeResult.FAIL;
+			if (gate == 0) return ENodeResult.RUNNING;
+			// Native super increments the behavior counter. Wait BEFORE calling it,
+			// so repeated pending ticks cannot count the same projectile twice.
+			if (battery.OrderShots < ERR_MortarSalvo.ROUNDS)
+			{
+				ERR_MortarSupplyState supply = battery.SupplyState(GetGame().GetWorld().GetWorldTime());
+				if (supply == ERR_MortarSupplyState.PENDING) return ENodeResult.RUNNING;
+				if (supply == ERR_MortarSupplyState.FAILED)
+				{
+					ERR_MortarSystem system = ERR_MortarSystem.Get();
+					if (system) system.Withhold(battery, "next native load lacks confirmed physical gunner ammunition");
+					return ENodeResult.FAIL;
+				}
+			}
+		}
+		ENodeResult result = super.EOnTaskSimulate(owner, dt);
+		if (battery && result == ENodeResult.SUCCESS)
+		{
+			SetVariableOut(PORT_AIMING_NEEDED, true);
+		}
+		return result;
+	}
+}
@@ -0,0 +1,131 @@
+// All target coordinates come from delivered HQ observations, never a player's
+// current transform. Road projection stops at an unknown junction/road end.
+class ERR_MortarPrediction
+{
+	// Read immediately after a failed synchronous prediction; no extra world scan.
+	static string FailureReason;
+	// Includes observation uplink, HQ downlink and native aiming. All stages
+	// retain the original observation time; radio delivery never renews it.
+	static const float MAX_REPORT_AGE_MS = 60000;
+
+	static bool Fresh(ERR_HQReport report, float now)
+	{
+		return report && report.Target && !report.Distress && now >= report.ObservedAt && now - report.ObservedAt <= MAX_REPORT_AGE_MS && report.TravelMode != "aircraft";
+	}
+
+	static bool Reject(string reason)
+	{
+		FailureReason = reason;
+		return false;
+	}
+
+	static vector ClosestOnSegment(vector point, vector start, vector end)
+	{
+		vector segment = end - start;
+		segment[1] = 0;
+		vector offset = point - start;
+		offset[1] = 0;
+		float lengthSq = segment.LengthSq();
+		if (lengthSq < 0.01)
+			return start;
+		return vector.Lerp(start, end, Math.Clamp(vector.Dot(offset, segment) / lengthSq, 0, 1));
+	}
+
+	static bool FollowRoad(array<vector> points, vector observed, vector velocity, float seconds, out vector impact)
+	{
+		if (!points || points.Count() < 2)
+			return Reject("road polyline has fewer than two points");
+		int segment = -1;
+		float closest = 20;
+		vector projected;
+		for (int i = 0; i < points.Count() - 1; i++)
+		{
+			vector candidate = ClosestOnSegment(observed, points[i], points[i + 1]);
+			float distance = vector.DistanceXZ(candidate, observed);
+			if (distance < closest)
+			{
+				closest = distance;
+				segment = i;
+				projected = candidate;
+			}
+		}
+		if (segment < 0)
+			return Reject("observed vehicle is not within 20m of a road segment");
+		vector forward = points[segment + 1] - points[segment];
+		forward[1] = 0;
+		forward.Normalize();
+		vector travel = velocity;
+		travel[1] = 0;
+		float speed = travel.Length();
+		travel.Normalize();
+		float alignment = vector.Dot(forward, travel);
+		if (Math.AbsFloat(alignment) < 0.7)
+			return Reject("vehicle heading crosses road; alignment below 0.7");
+		int step = 1;
+		int next = segment + 1;
+		if (alignment < 0)
+		{
+			step = -1;
+			next = segment;
+		}
+		float remaining = speed * seconds;
+		vector position = projected;
+		while (next >= 0 && next < points.Count())
+		{
+			float length = vector.DistanceXZ(position, points[next]);
+			if (length >= remaining && length > 0.01)
+			{
+				impact = vector.Lerp(position, points[next], remaining / length);
+				return true;
+			}
+			remaining -= length;
+			position = points[next];
+			next += step;
+		}
+		return Reject("prediction reaches unknown road end/junction");
+	}
+
+	static bool Predict(ERR_HQReport report, float now, float flightSeconds, out vector impact)
+	{
+		FailureReason = "";
+		if (!report) return Reject("target report missing");
+		if (report.Distress) return Reject("distress report cannot authorize fire");
+		if (now < report.ObservedAt) return Reject("observation timestamp is in the future");
+		if (now - report.ObservedAt > MAX_REPORT_AGE_MS) return Reject("observation older than 60s");
+		float seconds = (now - report.ObservedAt) / 1000 + flightSeconds;
+		if (seconds < 0 || seconds > 90)
+			return Reject("observation age plus flight outside 0..90s");
+		if (report.TravelMode == "aircraft") return Reject("aircraft target unsupported");
+		if (report.TravelMode == "mixed travel") return Reject("mixed travel cannot be predicted");
+		impact = report.Position;
+		if (!report.HasVelocity || report.Velocity.Length() < 0.5)
+			return true;
+		if (report.Velocity.Length() * seconds > 1800)
+			return Reject("predicted travel exceeds 1800m");
+		bool vehicle = report.TravelMode == "vehicle" || report.TravelMode == "in vehicle";
+		if (vehicle)
+		{
+			SCR_AIWorld world = SCR_AIWorld.Cast(GetGame().GetAIWorld());
+			if (!world || !world.GetRoadNetworkManager())
+				return Reject("road network unavailable");
+			BaseRoad road;
+			float roadDistance;
+			world.GetRoadNetworkManager().GetClosestRoad(report.Position, road, roadDistance, skipNavlinks: true);
+			if (!road) return Reject("no road near reported vehicle position");
+			if (roadDistance > 20) return Reject("reported vehicle farther than 20m from road");
+			array<vector> points = {};
+			road.GetPoints(points);
+			return FollowRoad(points, report.Position, report.Velocity, seconds, impact);
+		}
+		impact += report.Velocity * seconds;
+		return true;
+	}
+
+	static bool ThreatensFriendly(vector impact, vector position, vector velocity, float flightSeconds)
+	{
+		velocity[1] = 0;
+		vector future = position + velocity * Math.Clamp(flightSeconds, 0, 90);
+		// Protect the entire predicted path, not only where a soldier is now.
+		return vector.DistanceXZ(impact, ClosestOnSegment(impact, position, future)) <= 100;
+	}
+}
@@ -0,0 +1,177 @@
+enum ERR_MortarSupplyState { FAILED = -1, PENDING, READY }
+
+class ERR_MortarSupplyRules
+{
+ static int CycleGate(bool commandOpen, int confirmedShots, int behaviorShots, int limit, int supplyState)
+ {
+  if (!commandOpen) return -1;
+  if (confirmedShots <= behaviorShots) return 0;
+  if (confirmedShots < limit) return supplyState;
+  return 1;
+ }
+}
+
+class ERR_MortarInitialItem : ScriptedInventoryOperationCallback
+{
+ bool Finished;
+ bool Succeeded;
+ protected void Finish(bool success) { if (!Finished) { Finished = true; Succeeded = success; } }
+ protected override void OnComplete() { Finish(true); }
+ protected override void OnFailed() { Finish(false); }
+ protected override void OnAllComplete() { Finish(true); }
+ protected override void OnAllFailed() { Finish(false); }
+ void Rejected() { Finish(false); }
+}
+
+// One finite allocation, after the ENTIRE original support crew exists. Failed
+// or stopped setup retains physical assets and retires only its pending spawn intent.
+class ERR_MortarReadiness
+{
+ protected ERR_MortarBattery m_Battery;
+ protected ref array<IEntity> m_Members = {};
+ protected ref array<ref ERR_MortarInitialItem> m_Operations = {};
+ protected bool m_Allocated;
+ protected bool m_Ready;
+ protected bool m_Stopped;
+ protected bool m_Retired;
+ protected int m_RequestedShells;
+ void ERR_MortarReadiness(ERR_MortarBattery battery) { m_Battery = battery; }
+ static ERR_MortarSupplyState Population(int physical, int gunners, int operators, bool complete, bool expired)
+ {
+  if (physical > 4 || gunners > 3 || operators > 1) return ERR_MortarSupplyState.FAILED;
+  if (physical == 4 && gunners == 3 && operators == 1 && complete && !expired) return ERR_MortarSupplyState.READY;
+  if (expired) return ERR_MortarSupplyState.FAILED;
+  return ERR_MortarSupplyState.PENDING;
+ }
+ static bool AllocationValid(int shells) { return shells >= 0 && shells <= 9; }
+ int RequestedShells() { return m_RequestedShells; }
+ bool Ready() { return m_Ready && !m_Stopped; }
+ void Stop()
+ {
+  if (m_Stopped) return;
+  m_Stopped = true;
+  if (m_Ready || m_Retired || !m_Battery || !m_Battery.Group || !Replication.IsServer()) return;
+  m_Retired = true;
+  // As in Core initial guard cleanup: stopping the current request alone does
+  // not retire the native group's still-authored future expansion intent.
+  RetireGroup(m_Battery.Group);
+ }
+ static void RetireGroup(SCR_AIGroup group)
+ {
+  if (!group || !Replication.IsServer()) return;
+  group.SetSpawnImmediately(false);
+  group.m_aUnitPrefabSlots = new array<ResourceName>();
+  if (!GetGame()) return;
+  ChimeraAIWorld world = ChimeraAIWorld.Cast(GetGame().GetAIWorld());
+  if (world) world.PurgeSpawnRequestsForGroup(group);
+ }
+
+ protected ERR_MortarSupplyState Fail(string reason)
+ {
+  m_Battery.SpawnFailed(reason);
+  Stop();
+  return ERR_MortarSupplyState.FAILED;
+ }
+ protected bool Allocate()
+ {
+  m_Allocated = true; // before native requests; never refill or retry a failure
+  foreach (IEntity actor : m_Members)
+  {
+   if (actor == m_Battery.RadioOperator) continue;
+   InventoryStorageManagerComponent inventory = InventoryStorageManagerComponent.Cast(actor.FindComponent(InventoryStorageManagerComponent));
+   int existing = m_Battery.InventoryShells(inventory);
+   if (!AllocationValid(existing)) return false;
+   if (ERR_HQRadio.Capability(actor) == 0 && !inventory.TrySpawnPrefabToStorage("{E1A5D4B878AA8980}Prefabs/Items/Equipment/Radios/Radio_R148.et"))
+    m_Battery.Audit("RADIO EQUIP", "optional crew handset did not fit; dedicated manpack remains required");
+   for (int i = existing; i < 9; i++)
+   {
+    ERR_MortarInitialItem operation = new ERR_MortarInitialItem();
+    m_Operations.Insert(operation);
+    m_RequestedShells++;
+    if (!inventory.TrySpawnPrefabToStorage(ERR_MortarBattery.SHELL, purpose: EStoragePurpose.PURPOSE_DEPOSIT, cb: operation))
+    {
+     operation.Rejected();
+     return false;
+    }
+   }
+  }
+  return true;
+ }
+ ERR_MortarSupplyState Poll(float now)
+ {
+  if (m_Stopped || !Replication.IsServer() || !m_Battery || m_Battery.Stopped()) return ERR_MortarSupplyState.FAILED;
+  if (m_Ready) return ERR_MortarSupplyState.READY;
+  SCR_AIGroup group = m_Battery.Group;
+  ERR_GameMode mode = ERR_GameMode.Get();
+  if (!mode || !group || !m_Battery.Gun || group.GetFaction() != mode.EnemyFaction() || group.GetPlayerCount(true) > 0) return Fail("initial support group/gun/faction changed");
+  DamageManagerComponent damage = DamageManagerComponent.Cast(m_Battery.Gun.FindComponent(DamageManagerComponent));
+  if (!damage || damage.IsDestroyed()) return Fail("initial support gun missing damage manager or destroyed");
+  bool expired = now < m_Battery.SpawnedAt || now - m_Battery.SpawnedAt >= 90000;
+  array<AIAgent> agents = {}; group.GetAgents(agents);
+  array<IEntity> physical = {};
+  int gunners, operators;
+  IEntity operatorActor;
+  foreach (AIAgent agent : agents)
+  {
+   if (!agent || !agent.GetControlledEntity()) continue;
+   IEntity actor = agent.GetControlledEntity();
+   if (physical.Contains(actor)) return Fail("initial support group reports duplicate physical actor");
+   physical.Insert(actor);
+   if (!ERR_Actors.CanFight(actor) || SCR_FactionManager.SGetFaction(actor) != mode.EnemyFaction() || !actor.GetPrefabData()) return Fail("initial support actor unavailable or has wrong faction/resource");
+   ResourceName prefab = actor.GetPrefabData().GetPrefabName();
+   if (prefab == ERR_MortarBattery.CREW) gunners++;
+   else if (prefab == ERR_MortarBattery.RADIO_OPERATOR) { operators++; operatorActor = actor; }
+   else return Fail("initial support actor does not belong to authored crew catalog");
+  }
+  ERR_MortarSupplyState population = Population(physical.Count(), gunners, operators, group.IsExpandComplete(), expired);
+  if (population == ERR_MortarSupplyState.FAILED) return Fail("initial four-person support population incomplete/invalid within 90 seconds");
+  if (population == ERR_MortarSupplyState.PENDING) return population;
+  if (m_Allocated)
+  {
+   foreach (IEntity original : m_Members)
+    if (!physical.Contains(original)) return Fail("initial support member replaced after finite allocation");
+  }
+  foreach (IEntity member : physical)
+  {
+   InventoryStorageManagerComponent inventory = InventoryStorageManagerComponent.Cast(member.FindComponent(InventoryStorageManagerComponent));
+   if (!inventory) return ERR_MortarSupplyState.PENDING;
+   if (!m_Allocated && member != operatorActor && m_Battery.InventoryShells(inventory) < 9 && !inventory.CanInsertResource(ERR_MortarBattery.SHELL, EStoragePurpose.PURPOSE_DEPOSIT)) return ERR_MortarSupplyState.PENDING;
+  }
+  if (ERR_HQRadio.Capability(operatorActor) != 2) return ERR_MortarSupplyState.PENDING;
+  // Preserve the existing earliest activation delay, but it is not readiness.
+  if (now - m_Battery.SpawnedAt < 10000) return ERR_MortarSupplyState.PENDING;
+  if (!m_Allocated)
+  {
+   if (!group.GetGroupUtilityComponent() || !group.GetGroupUtilityComponent().m_VehicleMgr) return ERR_MortarSupplyState.PENDING;
+   SCR_AIVehicleUsageComponent usage = SCR_AIVehicleUsageComponent.Cast(m_Battery.Gun.FindComponent(SCR_AIVehicleUsageComponent));
+   if (!usage || !group.GetGroupUtilityComponent().m_VehicleMgr.TryAddVehicle(usage)) return Fail("native support gun registration failed");
+   m_Members.Copy(physical); m_Battery.RadioOperator = operatorActor;
+   if (!Allocate()) return Fail("finite initial support shell allocation rejected; no retry");
+   return ERR_MortarSupplyState.PENDING; // never accept mutation-frame readiness
+  }
+  foreach (ERR_MortarInitialItem operation : m_Operations)
+  {
+   if (!operation.Finished) return ERR_MortarSupplyState.PENDING;
+   if (!operation.Succeeded) return Fail("finite initial support shell operation failed; no retry");
+  }
+  foreach (IEntity equipped : m_Members)
+  {
+   InventoryStorageManagerComponent inventory = InventoryStorageManagerComponent.Cast(equipped.FindComponent(InventoryStorageManagerComponent));
+   int shells = m_Battery.InventoryShells(inventory);
+   if (equipped == operatorActor)
+   {
+    if (shells != 0) return Fail("dedicated initial manpack operator unexpectedly carries mortar shells");
+   }
+   else if (shells != 9) return ERR_MortarSupplyState.PENDING;
+  }
+  if (m_Battery.CountShells() != 27) return ERR_MortarSupplyState.PENDING;
+  m_Ready = true;
+  group.ActivateAI();
+  foreach (AIAgent readyAgent : agents)
+  {
+   if (readyAgent) { readyAgent.SetPermanentLOD(0); readyAgent.ActivateAI(); }
+  }
+  m_Battery.Audit("CREW READY", string.Format("four original physical members, one manpack, 27 confirmed HE; new shell requests=%1; allocation permanently closed", m_RequestedShells));
+  return ERR_MortarSupplyState.READY;
+ }
+}
@@ -0,0 +1,16 @@
+// One delivered HQ order drives a continuous native loading/firing cycle.
+class ERR_MortarSalvo
+{
+	static const int ROUNDS = 8;
+	static const float RADIUS_METRES = 40;
+	static const float TIMEOUT_MS = 120000;
+
+	static vector Offset(int site, int order, int shot)
+	{
+		// Stable throughout one ballistic solve; successive shells cover the disk
+		// instead of clustering on the same point or changing every iteration.
+		float radius = RADIUS_METRES * Math.Sqrt((shot + 1.0) / ROUNDS);
+		float angle = (site * 53 + order * 97 + shot * 137.5) * Math.DEG2RAD;
+		return Vector(Math.Sin(angle) * radius, 0, Math.Cos(angle) * radius);
+	}
+}
@@ -0,0 +1,108 @@
+class ERR_MortarSupplyCallback : ScriptedInventoryOperationCallback
+{
+ ERR_MortarSupplyTransfer Transfer;
+ protected override void OnComplete() { if (Transfer) Transfer.Acknowledge(true); }
+ protected override void OnFailed() { if (Transfer) Transfer.Acknowledge(false); }
+}
+
+// Exact-item native transaction. Callbacks only record outcomes; the HQ tick
+// authorizes progress after checking actual inventory ownership and the order.
+class ERR_MortarSupplyTransfer
+{
+ protected ERR_MortarBattery m_Battery;
+ protected IEntity m_Gun;
+ protected SCR_AIGroup m_Group;
+ protected IEntity m_Donor;
+ protected IEntity m_Gunner;
+ protected IEntity m_Shell;
+ protected InventoryStorageManagerComponent m_Source;
+ protected InventoryStorageManagerComponent m_Destination;
+ protected BaseInventoryStorageComponent m_Storage;
+ protected ref ERR_MortarSupplyCallback m_Callback;
+ protected int m_Order;
+ protected int m_Acknowledgement;
+ protected float m_Deadline;
+ protected bool m_Accepted;
+ protected bool m_Invalidated;
+ protected bool m_Resolved;
+ protected bool m_Ready;
+ void ERR_MortarSupplyTransfer(ERR_MortarBattery battery, IEntity donor, IEntity gunner, IEntity shell, BaseInventoryStorageComponent storage, float now)
+ {
+  m_Battery = battery; m_Gun = battery.Gun; m_Group = battery.Group;
+  m_Donor = donor; m_Gunner = gunner; m_Shell = shell; m_Storage = storage;
+  m_Order = battery.OrderId; m_Deadline = now + 8000;
+  m_Source = InventoryStorageManagerComponent.Cast(donor.FindComponent(InventoryStorageManagerComponent));
+  m_Destination = InventoryStorageManagerComponent.Cast(gunner.FindComponent(InventoryStorageManagerComponent));
+ }
+ static bool Authority(bool valid, bool invalidated, int capturedOrder, int currentOrder)
+ {
+  return valid && !invalidated && capturedOrder == currentOrder;
+ }
+ static bool Proven(bool callbackComplete, bool sourceContains, bool destinationContains, bool exactSlot)
+ {
+  return callbackComplete && !sourceContains && destinationContains && exactSlot;
+ }
+ protected bool Contains(InventoryStorageManagerComponent inventory)
+ {
+  if (!inventory || !m_Shell) return false;
+  array<IEntity> items = {}; ERR_Inventory.Items(inventory, items);
+  return items.Contains(m_Shell);
+ }
+ protected bool Valid(float now)
+ {
+  if (!m_Battery || !Authority(m_Battery.SupplyAuthorized(now), m_Invalidated, m_Order, m_Battery.OrderId)) return false;
+  if (m_Battery.Gun != m_Gun || m_Battery.Group != m_Group || !m_Donor || !m_Gunner || m_Donor == m_Gunner || !m_Shell || !m_Source || !m_Destination || !m_Storage) return false;
+  if (!ERR_Actors.CanFight(m_Donor) || !ERR_Actors.CanFight(m_Gunner) || ERR_Actors.Group(m_Donor) != m_Group || ERR_Actors.Group(m_Gunner) != m_Group) return false;
+  Faction faction = m_Group.GetFaction();
+  if (SCR_FactionManager.SGetFaction(m_Donor) != faction || SCR_FactionManager.SGetFaction(m_Gunner) != faction || vector.Distance(m_Donor.GetOrigin(), m_Gunner.GetOrigin()) > 12) return false;
+  SCR_AIVehicleUsageComponent usage = SCR_AIVehicleUsageComponent.Cast(m_Gun.FindComponent(SCR_AIVehicleUsageComponent));
+  if (!usage || !usage.GetTurretCompartmentSlot()) return false;
+  IEntity occupant = usage.GetTurretCompartmentSlot().GetOccupant();
+  return !occupant || occupant == m_Gunner;
+ }
+ void Acknowledge(bool success)
+ {
+  if (m_Acknowledgement != 0) return;
+  if (success) m_Acknowledgement = 1;
+  else m_Acknowledgement = -1;
+ }
+ bool Begin(float now)
+ {
+  if (m_Callback || !Replication.IsServer() || !Valid(now) || !Contains(m_Source) || Contains(m_Destination)) return false;
+  m_Callback = new ERR_MortarSupplyCallback(); m_Callback.Transfer = this;
+  // Do not use callback.GetItem(): the native contract excludes Move operations.
+  m_Accepted = m_Source.TryMoveItemToStorage(m_Shell, m_Storage, -1, m_Callback);
+  if (!m_Accepted) { Acknowledge(false); m_Resolved = true; }
+  return m_Accepted;
+ }
+ void Invalidate() { m_Invalidated = true; m_Ready = false; }
+ bool Unresolved() { return m_Accepted && !m_Resolved; }
+ int CapturedOrder() { return m_Order; }
+ ERR_MortarSupplyState Poll(float now)
+ {
+  if (!Replication.IsServer()) return ERR_MortarSupplyState.FAILED;
+  bool valid = Valid(now);
+  bool sourceContains = Contains(m_Source);
+  bool destinationContains = Contains(m_Destination);
+  bool exactSlot;
+  InventoryItemComponent item;
+  if (m_Shell) item = InventoryItemComponent.Cast(m_Shell.FindComponent(InventoryItemComponent));
+  if (item && item.GetParentSlot()) exactSlot = item.GetParentSlot().GetStorage() == m_Storage;
+  bool proven = Proven(m_Acknowledgement == 1, sourceContains, destinationContains, exactSlot);
+  if (proven || m_Acknowledgement < 0) m_Resolved = true;
+  // A successful callback without physical destination proof is ambiguous.
+  // Keep it reserved through timeout/cancellation; never start a second move.
+  if (!valid || now >= m_Deadline)
+  {
+   m_Invalidated = true; m_Ready = false;
+   return ERR_MortarSupplyState.FAILED;
+  }
+  if (proven)
+  {
+   m_Ready = true;
+   return ERR_MortarSupplyState.READY;
+  }
+  if (m_Acknowledgement < 0 || !m_Accepted) return ERR_MortarSupplyState.FAILED;
+  return ERR_MortarSupplyState.PENDING;
+ }
+}
@@ -0,0 +1,244 @@
+// Owned and ticked by HQ. Initial assets are authored once; losses are never replaced.
+class ERR_MortarSystem
+{
+ protected ERR_HQ m_HQ;
+ protected ref array<ref ERR_MortarBattery> m_Batteries = {};
+ protected ref ERR_SettlementSafety m_Settlements = new ERR_SettlementSafety();
+ protected bool m_Prepared;
+ protected bool m_Stopped;
+ protected float m_NextDecision;
+ string SafetyReason;
+ string SettlementReason;
+
+ void ERR_MortarSystem(ERR_HQ hq) { m_HQ = hq; }
+ static ERR_MortarSystem Get()
+ {
+  ERR_HQ hq = ERR_HQ.Get();
+  if (!hq || !Replication.IsServer()) return null;
+  return hq.Mortars();
+ }
+ static bool NearPlayer(vector position)
+ {
+  array<IEntity> players = {};
+  ERR_Actors.Players(players);
+  foreach (IEntity player : players)
+   if (vector.DistanceXZ(player.GetOrigin(), position) <= 1200) return true;
+  return false;
+ }
+ bool Prepare()
+ {
+  if (!Replication.IsServer() || m_Prepared || m_Stopped) return false;
+  m_Prepared = true;
+  vector position = ERR_Actors.Ground("6000 0 7000");
+  if (position[1] < 1) return false;
+  IEntity gun = ERR_Actors.Spawn(ERR_MortarBattery.GUN, position);
+  SCR_AIGroup group = SCR_AIGroup.Cast(ERR_Actors.Spawn(MortarGroup(), ERR_Actors.Ground(position + "0 0 4")));
+  if (!gun || !group)
+  {
+   ERR_Actors.DeleteSpawned(gun);
+   ERR_MortarReadiness.RetireGroup(group);
+   ERR_Actors.DeleteSpawned(group);
+   return false;
+  }
+  if (group.GetFaction() != ERR_GameMode.Get().EnemyFaction())
+  {
+   ERR_Actors.DeleteSpawned(gun);
+   ERR_MortarReadiness.RetireGroup(group);
+   ERR_Actors.DeleteSpawned(group);
+   return false;
+  }
+  FactionAffiliationComponent affiliation = FactionAffiliationComponent.Cast(gun.FindComponent(FactionAffiliationComponent));
+  if (affiliation) affiliation.SetAffiliatedFaction(ERR_GameMode.Get().EnemyFaction());
+  ERR_MortarBattery battery = new ERR_MortarBattery();
+  battery.Bind(1, group, gun, GetGame().GetWorld().GetWorldTime());
+  m_Batteries.Insert(battery);
+  ERR_GameMode mode = ERR_GameMode.Get();
+  mode.Own(gun);
+  mode.RegisterGroup(group);
+  m_HQ.ReserveGroup(group);
+  battery.Audit("DEPLOY", "authored gun and four-person crew; finite ammunition initialization pending");
+  return true;
+ }
+ static ResourceName MortarGroup() { return "{B84C05941C4C81B8}Prefabs/ERR/MortarCrew.et"; }
+ ERR_MortarBattery FindGun(IEntity gun)
+ {
+  foreach (ERR_MortarBattery battery : m_Batteries)
+   if (gun && battery.Gun == gun) return battery;
+  return null;
+ }
+ ERR_MortarBattery FindGroup(SCR_AIGroup group)
+ {
+  foreach (ERR_MortarBattery battery : m_Batteries)
+   if (group && battery.Group == group) return battery;
+  return null;
+ }
+ ERR_HQReport Latest(ERR_MortarBattery battery, float now)
+ {
+  // Only the coordinates actually delivered to this battery are available.
+  // A newer HQ contact cannot update a gun's knowledge without another downlink.
+  if (!battery || !ERR_MortarPrediction.Fresh(battery.Report, now)) return null;
+  return battery.Report;
+ }
+ string ContactFailure(ERR_MortarBattery battery)
+ {
+  if (!battery.Report) return "no delivered target report";
+  return "delivered target report expired or invalid";
+ }
+ bool OutsideSettlements(vector impact)
+ {
+  bool clear = m_Settlements.OutsideSettlements(impact);
+  SettlementReason = m_Settlements.SettlementReason;
+  return clear;
+ }
+ bool Safe(ERR_MortarBattery battery, vector impact, float flight)
+ {
+  SafetyReason = "clear";
+  if (!battery.Operational()) { SafetyReason = battery.OperationalReason(); return false; }
+  if (!OutsideSettlements(impact)) { SafetyReason = SettlementReason; return false; }
+  if (SCR_TerrainHelper.GetTerrainY(impact) < 0) { SafetyReason = "impact below Everon sea level"; return false; }
+  Faction faction = battery.Group.GetFaction();
+  if (!faction) { SafetyReason = "battery faction missing"; return false; }
+  array<IEntity> friendlies = {};
+  m_HQ.PhysicalForces(friendlies);
+  foreach (IEntity entity : friendlies)
+  {
+   Faction friendly = SCR_FactionManager.SGetFaction(entity);
+   if (!friendly || faction.IsFactionEnemy(friendly) || !ERR_Actors.Alive(entity)) continue;
+   vector velocity;
+   IEntity moving = CompartmentAccessComponent.GetVehicleIn(entity);
+   if (!moving) moving = entity;
+   if (moving.GetPhysics()) velocity = moving.GetPhysics().GetVelocity();
+   if (ERR_MortarPrediction.ThreatensFriendly(impact, entity.GetOrigin(), velocity, flight))
+   {
+    SafetyReason = "friendly physical force can enter the impact area";
+    return false;
+   }
+  }
+  return true;
+ }
+ bool Withhold(ERR_MortarBattery battery, string reason, string detail = "")
+ {
+  battery.LastFailure = reason + "; " + detail;
+  battery.Trace("WITHHELD", reason, detail);
+  // Finish the activity from the next HQ tick, never from inside its own node.
+  battery.Rejected = true;
+  return false;
+ }
+ bool AllowShot(ERR_MortarBattery battery)
+ {
+  float now = GetGame().GetWorld().GetWorldTime();
+  if (m_Stopped || !ERR_HQ.MissionActive()) return Withhold(battery, "mission inactive or HQ stopped");
+  if (!battery.Operational()) return Withhold(battery, battery.OperationalReason());
+  if (!battery.CommandOpen || battery.OrderShots >= ERR_MortarSalvo.ROUNDS) return Withhold(battery, "salvo complete or order closed");
+  if (battery.Released) return Withhold(battery, "waiting for committed projectile");
+  if (battery.AimedShot != battery.OrderShots || battery.AimedAt < 0 || now - battery.AimedAt > 10000) return Withhold(battery, "fresh aim solution required");
+  ERR_HQReport report = Latest(battery, now);
+  if (!report) return Withhold(battery, ContactFailure(battery));
+  vector updated;
+  if (!ERR_MortarPrediction.Predict(report, now, battery.FlightTime, updated)) return Withhold(battery, ERR_MortarPrediction.FailureReason);
+  updated += battery.AimOffset;
+  if (vector.DistanceXZ(updated, battery.Impact) > 60) return Withhold(battery, "predicted target left aimed impact area");
+  if (!OutsideSettlements(updated)) return Withhold(battery, SettlementReason);
+  if (!Safe(battery, battery.Impact, battery.FlightTime)) return Withhold(battery, SafetyReason);
+  return true;
+ }
+ protected void AdvanceOrder(ERR_MortarBattery battery, float now)
+ {
+  if (battery.RadioOrder)
+  {
+   int deliveredState = battery.RadioOrder.Advance(now, m_HQ.Journal());
+   if (deliveredState == 0) return;
+   ERR_HQReport delivered = battery.PendingRadioReport;
+   battery.RadioOrder = null;
+   battery.PendingRadioReport = null;
+   if (deliveredState < 0 || !ERR_MortarPrediction.Fresh(delivered, now) || !battery.Operational() || battery.Activity || !battery.CommandOpen)
+   {
+    battery.Cancel("radio delivery, report freshness or battery availability failed");
+    battery.NextOrder = now + 10000;
+    return;
+   }
+   battery.PendingSupplyReport = delivered;
+  }
+  if (!battery.PendingSupplyReport) return;
+  if (!battery.CommandOpen || !ERR_MortarPrediction.Fresh(battery.PendingSupplyReport, now) || !battery.Operational() || battery.Activity)
+  {
+   battery.Cancel("delivered order expired or became unavailable while awaiting physical ammunition");
+   battery.NextOrder = now + 10000;
+   return;
+  }
+  ERR_MortarSupplyState supply = battery.SupplyState(now);
+  if (supply == ERR_MortarSupplyState.PENDING) return;
+  if (supply == ERR_MortarSupplyState.FAILED)
+  {
+   battery.Cancel("physical gunner ammunition unavailable or transfer failed");
+   battery.NextOrder = now + 10000;
+   return;
+  }
+  ERR_HQReport ready = battery.PendingSupplyReport;
+  battery.PendingSupplyReport = null;
+  battery.Order(ready, now);
+ }
+
+ void Tick(float now)
+ {
+  if (m_Stopped || !Replication.IsServer()) return;
+  foreach (ERR_MortarBattery battery : m_Batteries)
+  {
+   if (battery.Rejected && !battery.Released)
+   {
+    battery.Cancel("native aim or firing authorization rejected");
+    battery.NextOrder = now + 10000;
+   }
+   battery.Rejected = false;
+   battery.Update(now);
+   AdvanceOrder(battery, now);
+  }
+  if (now < m_NextDecision) return;
+  m_NextDecision = now + 10000;
+  array<ref ERR_HQReport> reports = {};
+  m_HQ.SupportContacts(reports, now);
+  ERR_MortarBattery selected;
+  ERR_HQReport target;
+  float distance = float.MAX;
+  foreach (ERR_MortarBattery battery : m_Batteries)
+  {
+   if (!battery.StartupActivated || !battery.Operational() || battery.Activity || battery.RadioOrder || battery.PendingSupplyReport || battery.SupplyPending() || now < battery.NextOrder || battery.CountShells() == 0) continue;
+   foreach (ERR_HQReport report : reports)
+   {
+    float candidate = vector.DistanceXZ(battery.Position, report.Position);
+    if (candidate < 350 || candidate > 4000 || candidate >= distance || !OutsideSettlements(report.Position)) continue;
+    selected = battery;
+    target = report;
+    distance = candidate;
+   }
+  }
+  if (!selected || !target) return;
+  ERR_HQRoute route = m_HQ.Downlink(selected.Group, "MORTAR ORDER", target.Description(now), target.MessageId);
+  if (!route) return;
+  selected.BeginRequest(target, now);
+  selected.RadioId = route.MessageId;
+  selected.RadioOrder = route;
+  selected.PendingRadioReport = target.Snapshot();
+  m_NextDecision = now + 20000;
+ }
+ void AppendGuns(array<IEntity> entities)
+ {
+  foreach (ERR_MortarBattery battery : m_Batteries)
+   if (battery.Gun && !entities.Contains(battery.Gun)) entities.Insert(battery.Gun);
+ }
+ string Status()
+ {
+  int ready, shells;
+  foreach (ERR_MortarBattery battery : m_Batteries)
+  {
+   if (battery.StartupActivated && battery.Operational()) ready++;
+   shells += battery.CountShells();
+  }
+  return string.Format("mortars %1/%2; HE shells %3", ready, m_Batteries.Count(), shells);
+ }
+ void Stop()
+ {
+  m_Stopped = true;
+  foreach (ERR_MortarBattery battery : m_Batteries) battery.Stop();
+ }
+}
@@ -0,0 +1,241 @@
+#ifdef WORKBENCH
+// Explicit synthetic observation only. Delivery, HQ scheduling and native fire
+// are unchanged; this helper never writes directly into the HQ contact list.
+modded class ERR_HQ
+{
+ int ERR_QueueMortarFixtureReport(SCR_AIGroup source, IEntity target, vector position, float now)
+ {
+  if (!ERR_NativeMortarFiringProbe.Enabled() || !target || !m_Contacts.IsEmpty()) return 0;
+  foreach (ERR_HQUnit unit : m_Units)
+  {
+   if (unit.Group != source || !unit.ReservedForSupport || !unit.Radio || unit.Uplink || unit.PendingReport) continue;
+   ERR_HQRoute route = m_Network.Route(unit.Radio);
+   if (!route || route.Nodes.IsEmpty()) return 0;
+   ERR_HQReport report = new ERR_HQReport();
+   report.MessageId = m_Journal.Message(); report.Target = target; report.Source = source;
+   report.Position = position; report.ObservedAt = now; report.DetailsObservedAt = now;
+   report.HasVelocity = true; report.Velocity = vector.Zero;
+   report.TravelMode = "on foot"; report.SeenEscapists = 1; report.SeenWeapons = "fixture observation";
+   route.MessageId = report.MessageId; route.Payload = "EXPLICIT SYNTHETIC OBSERVATION: " + report.Description(now);
+   unit.PendingReport = report; unit.Uplink = route;
+   m_Journal.Write("FIXTURE REPORT", route.Payload, report.MessageId);
+   return report.MessageId;
+  }
+  return 0;
+ }
+ void ERR_RemoveMortarFixtureReport(IEntity target)
+ {
+  if (!target) return;
+  for (int i = m_Contacts.Count() - 1; i >= 0; i--)
+   if (m_Contacts[i].Target == target) m_Contacts.Remove(i);
+  foreach (ERR_HQUnit unit : m_Units)
+  {
+   if (unit.PendingReport && unit.PendingReport.Target == target) { unit.PendingReport = null; unit.Uplink = null; }
+   if ((unit.PendingOrder && unit.PendingOrder.Target == target) || (unit.Assignment && unit.Assignment.Target == target)) unit.Release();
+  }
+ }
+}
+
+// Observe only the actual native event. Node SUCCESS, accepted inventory moves
+// and committed shell loading are never counted as physical projectiles.
+modded class SCR_MortarMuzzleComponent
+{
+ override void OnWeaponFired(IEntity effectEntity, BaseMuzzleComponent muzzle, IEntity projectileEntity)
+ {
+  ERR_NativeMortarFiringProbe probe = ERR_NativeMortarFiringProbe.Active();
+  if (probe) probe.NativeProjectile(GetOwner(), projectileEntity);
+  super.OnWeaponFired(effectEntity, muzzle, projectileEntity);
+ }
+}
+
+class ERR_NativeMortarFiringProbe
+{
+ protected static ERR_NativeMortarFiringProbe s_Active;
+ protected ERR_GameMode m_Mode;
+ protected ERR_MortarBattery m_Battery;
+ protected IEntity m_Gun;
+ protected SCR_AIGroup m_Group;
+ protected IEntity m_Target;
+ protected vector m_Impact;
+ protected ref array<IEntity> m_Crew = {};
+ protected ref array<IEntity> m_InitialShells = {};
+ protected ref array<IEntity> m_Projectiles = {};
+ protected int m_Source;
+ protected int m_Order;
+ protected int m_Step;
+ protected int m_Events;
+ protected int m_StoppedShells;
+ protected float m_Deadline;
+ protected float m_NextDiagnostic;
+ protected float m_StopUntil;
+ protected bool m_Unsafe;
+ protected bool m_BadProjectile;
+ protected bool m_SawUplink;
+ protected bool m_SawDownlink;
+ protected bool m_SawActivity;
+ protected bool m_Stopped;
+ protected string m_BadReason;
+
+ static bool Enabled()
+ {
+  string enabled, outcome;
+  return Replication.IsServer() && System.GetCLIParam("errSmoke", enabled) && enabled == "1" && System.GetCLIParam("errSmokeOutcome", outcome) && outcome == "mortar-fire";
+ }
+ static ERR_NativeMortarFiringProbe Active() { return s_Active; }
+ void ERR_NativeMortarFiringProbe(ERR_GameMode mode)
+ {
+  m_Mode = mode;
+  m_Deadline = GetGame().GetWorld().GetWorldTime() + 180000;
+  if (Enabled() && !s_Active) s_Active = this;
+ }
+ protected bool Check(bool condition, string detail)
+ {
+  if (condition) { Print("ERR SMOKE PASS: mortar firing " + detail); return true; }
+  Print("ERR SMOKE FAIL: mortar firing " + detail, LogLevel.ERROR); Stop(); return false;
+ }
+ protected void Shells(out array<IEntity> shells)
+ {
+  shells.Clear();
+  foreach (IEntity actor : m_Crew)
+  {
+   if (!actor) continue;
+   InventoryStorageManagerComponent inventory = InventoryStorageManagerComponent.Cast(actor.FindComponent(InventoryStorageManagerComponent));
+   array<IEntity> items = {}; ERR_Inventory.Items(inventory, items);
+   foreach (IEntity item : items)
+    if (item && item.GetPrefabData() && item.GetPrefabData().GetPrefabName() == ERR_MortarBattery.SHELL && !shells.Contains(item)) shells.Insert(item);
+  }
+ }
+ protected bool CheckNoOccupants(IEntity entity)
+ {
+  if (ChimeraCharacter.Cast(entity) || Vehicle.Cast(entity)) { m_Unsafe = true; return false; }
+  return true;
+ }
+ protected bool EmptyImpact(vector position)
+ {
+  m_Unsafe = false;
+  GetGame().GetWorld().QueryEntitiesByAABB(position - "200 5000 200", position + "200 5000 200", CheckNoOccupants, null, EQueryEntitiesFlags.ALL);
+  return !m_Unsafe;
+ }
+ protected bool SelectImpact(ERR_MortarSystem system)
+ {
+  // Bounded candidate survey: no clearance assumption from coordinates alone.
+  array<vector> offsets = {"-800 0 -600", "-600 0 -800", "0 0 -1000", "600 0 -800", "-1000 0 0", "800 0 -600", "-800 0 600", "0 0 1000"};
+  foreach (vector offset : offsets)
+  {
+   vector candidate = ERR_Actors.Ground(m_Battery.Position + offset);
+   if (candidate[1] < 1 || !EmptyImpact(candidate) || !system.Safe(m_Battery, candidate, 75)) continue;
+   bool clear = true;
+   for (int shot = 0; shot < ERR_MortarSalvo.ROUNDS; shot++)
+   {
+    vector spread = ERR_Actors.Ground(candidate + ERR_MortarSalvo.Offset(m_Battery.SiteId, m_Battery.OrderId + 1, shot));
+    if (!system.Safe(m_Battery, spread, 75)) { clear = false; break; }
+   }
+   if (!clear) continue;
+   m_Impact = candidate;
+   PrintFormat("ERR MORTAR FIXTURE IMPACT: position=%1 batteryDistance=%2; no characters/vehicles in 400m square; production settlement/friendly exclusions passed", candidate, vector.DistanceXZ(candidate, m_Battery.Position));
+   return true;
+  }
+  return false;
+ }
+ protected void Diagnose(float now)
+ {
+  if (now < m_NextDiagnostic) return;
+  m_NextDiagnostic = now + 5000;
+  if (!m_Battery) { Print("ERR MORTAR FIXTURE: waiting for one authored battery"); return; }
+  PrintFormat("ERR MORTAR FIXTURE: step=%1 startup=%2 source=M%3 observedEvents=%4 ready=%5 failure=%6", m_Step, m_Battery.StartupActivated, m_Source, m_Events, m_Battery.Operational(), m_Battery.SpawnFailure);
+  m_Battery.SiteStatus(now);
+ }
+ void NativeProjectile(IEntity gun, IEntity projectile)
+ {
+  if (m_Stopped || !m_Battery || gun != m_Gun) return;
+  if (!projectile) { m_BadProjectile = true; m_BadReason = "native fired event has no physical projectile"; return; }
+  if (m_Projectiles.Contains(projectile)) { m_BadProjectile = true; m_BadReason = "same physical projectile observed twice"; return; }
+  m_Projectiles.Insert(projectile); m_Events++;
+  float now = GetGame().GetWorld().GetWorldTime();
+  if (m_Step != 1 || !m_Battery.CommandOpen || !m_Battery.Released || m_Battery.SourceId != m_Source || m_Battery.AimedAt < 0 || now - m_Battery.AimedAt > 10000 || m_Battery.FlightTime <= 0)
+  { m_BadProjectile = true; m_BadReason = "projectile lacks this delivered order and fresh native aim/commit"; }
+  PrintFormat("ERR MORTAR FIXTURE PROJECTILE: event=%1 entity=%2 origin=%3 order=%4 source=M%5 aimAge=%6 flight=%7; impact is not measured", m_Events, projectile, projectile.GetOrigin(), m_Battery.OrderId, m_Battery.SourceId, now - m_Battery.AimedAt, m_Battery.FlightTime);
+ }
+ int Tick(float now)
+ {
+  if (m_Stopped) return -1;
+  if (!Enabled() || s_Active != this || !m_Mode || !m_Mode.Active()) { Check(false, "explicit active fixture context retained"); return -1; }
+  ERR_HQ hq = ERR_HQ.Get();
+  ERR_MortarSystem system;
+  if (hq) system = hq.Mortars();
+  if (!system) { Check(false, "real HQ mortar service available"); return -1; }
+  if (!m_Battery)
+  {
+   array<IEntity> guns = {}; system.AppendGuns(guns);
+   if (guns.Count() == 1) { m_Gun = guns[0]; m_Battery = system.FindGun(m_Gun); }
+  }
+  Diagnose(now);
+  if (now >= m_Deadline) { Check(false, "bounded deadline; inspect readiness/route/activity/aim diagnostics"); return -1; }
+  if (m_BadProjectile) { Check(false, m_BadReason); return -1; }
+  if (!m_Battery) return 0;
+  if (!m_Battery.SpawnFailure.IsEmpty()) { Check(false, "battery startup failed: " + m_Battery.SpawnFailure); return -1; }
+  if (m_Step == 0)
+  {
+   if (!m_Battery.StartupActivated || !m_Battery.Operational() || !hq.MortarConnected(m_Battery.Group)) return 0;
+   m_Group = m_Battery.Group;
+   if (!Check(m_Group && m_Group.IsExpandComplete() && m_Group.GetAgentsCount() == 4 && m_Battery.TotalShots == 0 && m_Battery.OrderId == 0 && !m_Battery.CommandOpen && !m_Battery.Activity && !m_Battery.RadioOrder, "untasked original gun and complete four-person crew start without shots")) return -1;
+   array<AIAgent> agents = {}; m_Group.GetAgents(agents);
+   foreach (AIAgent agent : agents)
+   {
+    IEntity actor; if (agent) actor = agent.GetControlledEntity();
+    if (!Check(ERR_Actors.CanFight(actor) && !m_Crew.Contains(actor), "initial physical crew member is conscious and unique")) return -1;
+    m_Crew.Insert(actor);
+   }
+   if (!Check(m_Battery.RadioOperator && ERR_HQRadio.Capability(m_Battery.RadioOperator) == 2, "dedicated actual manpack supplies the radio route")) return -1;
+   Shells(m_InitialShells);
+   if (!Check(m_InitialShells.Count() == 27 && m_Battery.CountShells() == 27, "exactly 27 distinct physical initial HE shells")) return -1;
+   if (!Check(SelectImpact(system), "bounded candidate survey finds an unoccupied production-safe impact area")) return -1;
+   m_Target = ERR_Actors.Spawn(ERR_Resources.IntelFolder(), m_Impact);
+   if (!Check(m_Target != null, "fixture-owned inert report identity exists; no enemy perception is claimed")) return -1;
+   m_Source = hq.ERR_QueueMortarFixtureReport(m_Group, m_Target, m_Impact, now);
+   if (!Check(m_Source > 0, "synthetic observation enters actual existing radio uplink once")) return -1;
+   m_SawUplink = true; m_Deadline = now + 90000; m_Step = 1; return 0;
+  }
+  if (m_Battery.Gun != m_Gun || m_Battery.Group != m_Group) { Check(false, "original gun and crew identity retained"); return -1; }
+  if (!EmptyImpact(m_Impact)) { Check(false, "impact exclusion stays unoccupied before native firing/cancellation"); return -1; }
+  array<IEntity> remaining = {}; Shells(remaining);
+  foreach (IEntity item : remaining)
+   if (!m_InitialShells.Contains(item)) { Check(false, "no replacement HE shell appears after initialization"); return -1; }
+  if (m_Step == 1)
+  {
+   if (m_Battery.RadioOrder && m_Battery.SourceId == m_Source) { m_SawDownlink = true; m_Order = m_Battery.OrderId; }
+   if (m_Battery.Activity && m_Battery.Report && m_Battery.Report.MessageId == m_Source) m_SawActivity = true;
+   if (m_Battery.OrderId > 1 || (m_Battery.SourceId != 0 && m_Battery.SourceId != m_Source)) { Check(false, "one unchanged fixture source creates only one HQ order"); return -1; }
+   if (m_Events == 0) return 0;
+   if (!Check(m_Events == 1 && m_Battery.TotalShots == 1 && m_Battery.OrderShots == 1 && !m_Battery.Released && m_SawUplink && m_SawDownlink && m_SawActivity && m_Order == 1, "one physical projectile follows real uplink/downlink, native activity and fresh aim")) return -1;
+   if (!Check(remaining.Count() == 26 && m_Battery.CountShells() == 26, "one fired projectile consumes one of 27 original inventory shells")) return -1;
+   // Cancel on this later fixture tick, never reentrantly inside the firing node.
+   hq.ERR_RemoveMortarFixtureReport(m_Target);
+   system.Stop(); system.Stop();
+   if (!Check(!m_Battery.CommandOpen && !m_Battery.Activity && !m_Battery.RadioOrder, "explicit support Stop closes native order and route idempotently")) return -1;
+   m_StoppedShells = remaining.Count(); m_StopUntil = now + 12000; m_Deadline = m_StopUntil + 2000; m_Step = 2; return 0;
+  }
+  if (now < m_StopUntil) return 0;
+  if (!Check(m_Battery.TotalShots == 1 && m_Events == 1 && m_Battery.OrderId == m_Order && remaining.Count() == m_StoppedShells && !m_Battery.CommandOpen && !m_Battery.Activity && !m_Battery.RadioOrder, "stopped service issues no duplicate order, projectile or replenishment over 12 seconds")) return -1;
+  array<AIAgent> finalCrew = {}; m_Group.GetAgents(finalCrew);
+  if (!Check(finalCrew.Count() == 4 && m_Battery.Gun == m_Gun, "original group and gun retain four crew")) return -1;
+  foreach (AIAgent finalAgent : finalCrew)
+   if (!Check(finalAgent && m_Crew.Contains(finalAgent.GetControlledEntity()) && ERR_Actors.CanFight(finalAgent.GetControlledEntity()), "final conscious crew entity belongs to original physical roster")) return -1;
+  Stop(); return 1;
+ }
+ void Stop()
+ {
+  if (m_Stopped) return;
+  m_Stopped = true;
+  ERR_HQ hq = ERR_HQ.Get();
+  if (hq)
+  {
+   hq.ERR_RemoveMortarFixtureReport(m_Target);
+   if (m_Battery && m_Battery.SourceId == m_Source && m_Source > 0) m_Battery.Cancel("mortar firing fixture cleanup");
+  }
+  ERR_Actors.DeleteSpawned(m_Target); m_Target = null;
+  if (s_Active == this) s_Active = null;
+ }
+ void ~ERR_NativeMortarFiringProbe() { Stop(); }
+}
+#endif
@@ -0,0 +1,87 @@
+#ifdef WORKBENCH
+// Test access only: trigger the real delivered-order method on an existing
+// registered squad. Radio transit is intentionally not simulated by this test.
+modded class ERR_HQ
+{
+ bool ERR_TestPatrolSearch(SCR_AIGroup group, out AIWaypoint search)
+ {
+  foreach (ERR_HQUnit unit : m_Units)
+  {
+   if (unit.Group != group) continue;
+   if (unit.Assignment || unit.PendingOrder || unit.Waypoint || !unit.Eligible(m_Mode)) return false;
+   ERR_HQReport order = new ERR_HQReport();
+   order.Position = group.GetOrigin() + "40 0 0";
+   order.ObservedAt = GetGame().GetWorld().GetWorldTime();
+   order.MessageId = m_Journal.Message();
+   unit.PendingOrder = order;
+   DeliverOrder(unit, order.ObservedAt);
+   search = unit.Waypoint;
+   return search && unit.Assignment == order;
+  }
+  return false;
+ }
+ bool ERR_TestPatrolRelease(SCR_AIGroup group, AIWaypoint search)
+ {
+  foreach (ERR_HQUnit unit : m_Units)
+  {
+   if (unit.Group != group || unit.Waypoint != search) continue;
+   unit.Release();
+   return !unit.Assignment && !unit.PendingOrder && !unit.Waypoint;
+  }
+  return false;
+ }
+}
+
+class ERR_NativePatrolHQProbe
+{
+ protected ERR_GameMode m_Mode;
+ protected ERR_SiteRuntime m_Site;
+ protected AIWaypoint m_Search;
+ protected ref array<AIWaypoint> m_Baseline = {};
+ protected int m_Step;
+ protected float m_Wait;
+ void ERR_NativePatrolHQProbe(ERR_GameMode mode) { m_Mode = mode; }
+ protected bool Check(bool condition, string detail)
+ {
+  if (condition) { Print("ERR SMOKE PASS: patrol HQ " + detail); return true; }
+  Print("ERR SMOKE FAIL: patrol HQ " + detail, LogLevel.ERROR); return false;
+ }
+ int Tick(float now)
+ {
+  if (now < m_Wait) return 0;
+  ERR_HQ hq = ERR_HQ.Get();
+  if (!Check(hq != null, "real HQ available")) return -1;
+  if (m_Step == 0)
+  {
+   m_Site = m_Mode.Sites().Find("everon-outpost-1");
+   if (!Check(m_Site && m_Site.Group && m_Site.PatrolCycle, "existing outpost route available")) return -1;
+   m_Site.Group.GetWaypoints(m_Baseline);
+   if (!Check(!m_Baseline.IsEmpty() && hq.ERR_TestPatrolSearch(m_Site.Group, m_Search), "real delivered-order method assigns existing squad")) return -1;
+   m_Step = 1; m_Wait = now + 750; return 0;
+  }
+  if (m_Step == 1)
+  {
+   array<AIWaypoint> queue = {};
+   m_Site.Group.GetWaypoints(queue);
+   if (!Check(m_Search && !queue.IsEmpty() && queue[0] == m_Search && m_Site.Group.GetCurrentWaypoint() == m_Search, "Search preempts native patrol")) return -1;
+   foreach (AIWaypoint waypoint : m_Baseline)
+    if (!Check(queue.Contains(waypoint), "preempted baseline route remains queued")) return -1;
+   if (!Check(hq.ERR_TestPatrolRelease(m_Site.Group, m_Search), "real HQ release removes only its assignment")) return -1;
+   m_Step = 2; m_Wait = now + 750; return 0;
+  }
+  if (m_Step == 2)
+  {
+   AIWaypoint current = m_Site.Group.GetCurrentWaypoint();
+   if (!Check(current && (current == m_Site.PatrolCycle || m_Site.PatrolWaypoints.Contains(current)), "native patrol resumes after Search release")) return -1;
+   m_Step = 3; return 1;
+  }
+  return 1;
+ }
+ void Stop()
+ {
+  ERR_HQ hq = ERR_HQ.Get();
+  if (hq && m_Site && m_Search) hq.ERR_TestPatrolRelease(m_Site.Group, m_Search);
+ }
+ void ~ERR_NativePatrolHQProbe() { Stop(); }
+}
+#endif
@@ -0,0 +1,63 @@
+// Vanilla named settlements supply exclusion areas; no original mission location system.
+// Shared town/village exclusion for mortar impacts, roadblocks and mine sites.
+// Fixed distance from mapped settlement centres, independent of mission
+// activation radii. Scattered buildings and props are not settlements.
+class ERR_SettlementSafety
+{
+	static const float RADIUS = 200;
+	string SettlementReason;
+	protected vector m_SafeImpact;
+	protected bool m_SettlementNear;
+	protected vector m_LastSettlementImpact;
+	protected float m_LastSettlementCheck = -1;
+	protected bool m_LastSettlementClear;
+
+	bool OutsideSettlements(vector impact)
+	{
+		float now = GetGame().GetWorld().GetWorldTime();
+		if (m_LastSettlementCheck >= 0 && now >= m_LastSettlementCheck && now - m_LastSettlementCheck < 1000 && vector.DistanceXZ(impact, m_LastSettlementImpact) == 0)
+			return m_LastSettlementClear;
+		m_LastSettlementCheck = now;
+		m_LastSettlementImpact = impact;
+		m_LastSettlementClear = false;
+		m_SafeImpact = impact;
+		m_SettlementNear = false;
+		SettlementReason = "clear";
+		// Also cover named native map settlements, independent of whether the
+		// mission placed a garrison marker there. Generic building entities also
+		// include deer stands, bridge pillars, rubble and electrical cabinets.
+		// Broad vertical bounds keep the 200m distance horizontal on hills.
+		GetGame().GetWorld().QueryEntitiesByAABB(impact - Vector(RADIUS, 5000, RADIUS), impact + Vector(RADIUS, 5000, RADIUS), CheckSettlement, FilterSettlement, EQueryEntitiesFlags.ALL);
+		m_LastSettlementClear = !m_SettlementNear;
+		return m_LastSettlementClear;
+	}
+
+	protected bool FilterSettlement(IEntity entity)
+	{
+		return entity && entity.FindComponent(MapDescriptorComponent);
+	}
+
+	protected bool CheckSettlement(IEntity entity)
+	{
+		float radius;
+		MapDescriptorComponent descriptor = MapDescriptorComponent.Cast(entity.FindComponent(MapDescriptorComponent));
+		if (descriptor)
+		{
+			int type = descriptor.GetBaseType();
+			if (type == EMapDescriptorType.MDT_NAME_CITY)
+				radius = RADIUS;
+			else if (type == EMapDescriptorType.MDT_NAME_TOWN)
+				radius = RADIUS;
+			else if (type == EMapDescriptorType.MDT_NAME_VILLAGE || type == EMapDescriptorType.MDT_NAME_SETTLEMENT)
+				radius = RADIUS;
+		}
+		if (radius > 0 && vector.DistanceXZ(m_SafeImpact, entity.GetOrigin()) <= radius)
+		{
+			m_SettlementNear = true;
+			SettlementReason = string.Format("named map settlement entity=%1 position=%2 distance=%3m exclusion=%4m", entity, entity.GetOrigin(), vector.DistanceXZ(m_SafeImpact, entity.GetOrigin()), radius);
+			return false;
+		}
+		return true;
+	}
+
+}
@@ -0,0 +1,9 @@
+modded class ERR_ScenarioComponent
+{
+ protected override bool PrepareAdditionalForces()
+ {
+  if (!super.PrepareAdditionalForces()) return false;
+  ERR_HQ hq = ERR_HQ.Get();
+  return hq && hq.PrepareSupport();
+ }
+}