Initial commit: OpenRA game engine

Fork from OpenRA/OpenRA with one-click launch script (start-ra.cmd)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

OpenRA.Mods.Common/Traits/Sound/AnnounceOnSeen.cs

@@ -0,0 +1,72 @@
+#region Copyright & License Information
+/*
+ * Copyright (c) The OpenRA Developers and Contributors
+ * This file is part of OpenRA, which is free software. It is made
+ * available to you under the terms of the GNU General Public License
+ * as published by the Free Software Foundation, either version 3 of
+ * the License, or (at your option) any later version. For more
+ * information, see COPYING.
+ */
+#endregion
+
+using System;
+using OpenRA.Primitives;
+using OpenRA.Traits;
+
+namespace OpenRA.Mods.Common.Traits.Sound
+{
+	[Desc("Players will be notified when this actor becomes visible to them.",
+		"Requires the 'EnemyWatcher' trait on the player actor.")]
+	public class AnnounceOnSeenInfo : TraitInfo
+	{
+		[Desc("Should there be a radar ping on enemies' radar at the actor's location when they see him")]
+		public readonly bool PingRadar = false;
+
+		[NotificationReference("Speech")]
+		[Desc("Speech notification to play.")]
+		public readonly string Notification = null;
+
+		[FluentReference(optional: true)]
+		[Desc("Text notification to display.")]
+		public readonly string TextNotification = null;
+
+		public readonly bool AnnounceNeutrals = false;
+
+		public override object Create(ActorInitializer init) { return new AnnounceOnSeen(init.Self, this); }
+	}
+
+	public class AnnounceOnSeen : INotifyDiscovered
+	{
+		public readonly AnnounceOnSeenInfo Info;
+
+		readonly Lazy<RadarPings> radarPings;
+
+		public AnnounceOnSeen(Actor self, AnnounceOnSeenInfo info)
+		{
+			Info = info;
+			radarPings = Exts.Lazy(self.World.WorldActor.Trait<RadarPings>);
+		}
+
+		public void OnDiscovered(Actor self, Player discoverer, bool playNotification)
+		{
+			if (!playNotification || discoverer != self.World.RenderPlayer)
+				return;
+
+			// Hack to disable notifications for neutral actors so some custom maps don't need fixing
+			// At this point it's either neutral or an enemy
+			if (!Info.AnnounceNeutrals && !self.AppearsHostileTo(discoverer.PlayerActor))
+				return;
+
+			// Audio notification
+			if (discoverer != null && !string.IsNullOrEmpty(Info.Notification))
+				Game.Sound.PlayNotification(self.World.Map.Rules, discoverer, "Speech", Info.Notification, discoverer.Faction.InternalName);
+
+			if (discoverer != null)
+				TextNotificationsManager.AddTransientLine(discoverer, Info.TextNotification);
+
+			// Radar notification
+			if (Info.PingRadar)
+				radarPings.Value?.Add(() => true, self.CenterPosition, Color.Red, 50);
+		}
+	}
+}