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/Transforms.cs

@@ -0,0 +1,171 @@
+#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.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+using OpenRA.Activities;
+using OpenRA.Mods.Common.Activities;
+using OpenRA.Mods.Common.Orders;
+using OpenRA.Traits;
+
+namespace OpenRA.Mods.Common.Traits
+{
+	[Desc("Actor becomes a specified actor type when this trait is triggered.")]
+	public class TransformsInfo : PausableConditionalTraitInfo
+	{
+		[ActorReference]
+		[FieldLoader.Require]
+		[Desc("Actor to transform into.")]
+		public readonly string IntoActor = null;
+
+		[Desc("Offset to spawn the transformed actor relative to the current cell.")]
+		public readonly CVec Offset = CVec.Zero;
+
+		[Desc("Facing that the actor must face before transforming.")]
+		public readonly WAngle Facing = new(384);
+
+		[Desc("Sounds to play when transforming.")]
+		public readonly ImmutableArray<string> TransformSounds = [];
+
+		[Desc("Sounds to play when the transformation is blocked.")]
+		public readonly ImmutableArray<string> NoTransformSounds = [];
+
+		[NotificationReference("Speech")]
+		[Desc("Speech notification to play when transforming.")]
+		public readonly string TransformNotification = null;
+
+		[FluentReference(optional: true)]
+		[Desc("Text notification to display when transforming.")]
+		public readonly string TransformTextNotification = null;
+
+		[NotificationReference("Speech")]
+		[Desc("Speech notification to play when the transformation is blocked.")]
+		public readonly string NoTransformNotification = null;
+
+		[FluentReference(optional: true)]
+		[Desc("Text notification to display when the transformation is blocked.")]
+		public readonly string NoTransformTextNotification = null;
+
+		[CursorReference]
+		[Desc("Cursor to display when able to (un)deploy the actor.")]
+		public readonly string DeployCursor = "deploy";
+
+		[CursorReference]
+		[Desc("Cursor to display when unable to (un)deploy the actor.")]
+		public readonly string DeployBlockedCursor = "deploy-blocked";
+
+		[VoiceReference]
+		public readonly string Voice = "Action";
+
+		public override object Create(ActorInitializer init) { return new Transforms(init, this); }
+	}
+
+	public class Transforms : PausableConditionalTrait<TransformsInfo>, IIssueOrder, IResolveOrder, IOrderVoice, IIssueDeployOrder
+	{
+		readonly Actor self;
+		readonly ActorInfo actorInfo;
+		readonly BuildingInfo buildingInfo;
+		readonly string faction;
+
+		public Transforms(ActorInitializer init, TransformsInfo info)
+			: base(info)
+		{
+			self = init.Self;
+			actorInfo = self.World.Map.Rules.Actors[info.IntoActor];
+			buildingInfo = actorInfo.TraitInfoOrDefault<BuildingInfo>();
+			faction = init.GetValue<FactionInit, string>(self.Owner.Faction.InternalName);
+		}
+
+		public string VoicePhraseForOrder(Actor self, Order order)
+		{
+			return order.OrderString == "DeployTransform" ? Info.Voice : null;
+		}
+
+		public bool CanDeploy()
+		{
+			if (IsTraitPaused || IsTraitDisabled)
+				return false;
+
+			return buildingInfo == null || self.World.CanPlaceBuilding(self.Location + Info.Offset, actorInfo, buildingInfo, self);
+		}
+
+		IEnumerable<Order> ClearBlockersOrders(CPos topLeft)
+		{
+			return AIUtils.ClearBlockersOrders(buildingInfo.Tiles(topLeft).ToList(), self.Owner, self);
+		}
+
+		public Activity GetTransformActivity()
+		{
+			return new Transform(Info.IntoActor)
+			{
+				Offset = Info.Offset,
+				Facing = Info.Facing,
+				Sounds = Info.TransformSounds,
+				Notification = Info.TransformNotification,
+				TextNotification = Info.TransformTextNotification,
+				Faction = faction
+			};
+		}
+
+		public IEnumerable<IOrderTargeter> Orders
+		{
+			get
+			{
+				if (!IsTraitDisabled)
+					yield return new DeployOrderTargeter("DeployTransform", 5,
+						() => CanDeploy() ? Info.DeployCursor : Info.DeployBlockedCursor);
+			}
+		}
+
+		public Order IssueOrder(Actor self, IOrderTargeter order, in Target target, bool queued)
+		{
+			if (order.OrderID == "DeployTransform")
+				return new Order(order.OrderID, self, queued);
+
+			return null;
+		}
+
+		Order IIssueDeployOrder.IssueDeployOrder(Actor self, bool queued)
+		{
+			return new Order("DeployTransform", self, queued);
+		}
+
+		bool IIssueDeployOrder.CanIssueDeployOrder(Actor self, bool queued) { return !IsTraitPaused && !IsTraitDisabled; }
+
+		public void DeployTransform(bool queued)
+		{
+			if (!queued && !CanDeploy())
+			{
+				foreach (var order in ClearBlockersOrders(self.Location + Info.Offset))
+					self.World.IssueOrder(order);
+
+				// Only play the "Cannot deploy here" audio
+				// for non-queued orders
+				foreach (var s in Info.NoTransformSounds)
+					Game.Sound.PlayToPlayer(SoundType.World, self.Owner, s);
+
+				Game.Sound.PlayNotification(self.World.Map.Rules, self.Owner, "Speech", Info.NoTransformNotification, self.Owner.Faction.InternalName);
+				TextNotificationsManager.AddTransientLine(self.Owner, Info.NoTransformTextNotification);
+
+				return;
+			}
+
+			self.QueueActivity(queued, GetTransformActivity());
+		}
+
+		public void ResolveOrder(Actor self, Order order)
+		{
+			if (order.OrderString == "DeployTransform" && !IsTraitPaused && !IsTraitDisabled)
+				DeployTransform(order.Queued);
+		}
+	}
+}