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/Render/WithHarvestOverlay.cs

@@ -0,0 +1,75 @@
+#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 OpenRA.Graphics;
+using OpenRA.Traits;
+
+namespace OpenRA.Mods.Common.Traits.Render
+{
+	[Desc("Displays an overlay whenever resources are harvested by the actor.")]
+	sealed class WithHarvestOverlayInfo : TraitInfo, Requires<RenderSpritesInfo>, Requires<BodyOrientationInfo>
+	{
+		[SequenceReference]
+		[Desc("Sequence name to use")]
+		public readonly string Sequence = "harvest";
+
+		[Desc("Position relative to body")]
+		public readonly WVec LocalOffset = WVec.Zero;
+
+		[PaletteReference]
+		public readonly string Palette = "effect";
+
+		public override object Create(ActorInitializer init) { return new WithHarvestOverlay(init.Self, this); }
+	}
+
+	sealed class WithHarvestOverlay : INotifyHarvestAction
+	{
+		readonly WithHarvestOverlayInfo info;
+		readonly Animation anim;
+		bool visible;
+
+		public WithHarvestOverlay(Actor self, WithHarvestOverlayInfo info)
+		{
+			this.info = info;
+			var rs = self.Trait<RenderSprites>();
+			var body = self.Trait<BodyOrientation>();
+
+			anim = new Animation(self.World, rs.GetImage(self), RenderSprites.MakeFacingFunc(self))
+			{
+				IsDecoration = true
+			};
+
+			anim.Play(info.Sequence);
+			rs.Add(new AnimationWithOffset(anim,
+				() => body.LocalToWorld(info.LocalOffset.Rotate(body.QuantizeOrientation(self.Orientation))),
+				() => !visible,
+				p => ZOffsetFromCenter(self, p, 0)), info.Palette);
+		}
+
+		void INotifyHarvestAction.Harvested(Actor self, string resourceType)
+		{
+			if (visible)
+				return;
+
+			visible = true;
+			anim.PlayThen(info.Sequence, () => visible = false);
+		}
+
+		void INotifyHarvestAction.MovingToResources(Actor self, CPos targetCell) { }
+		void INotifyHarvestAction.MovementCancelled(Actor self) { }
+
+		public static int ZOffsetFromCenter(Actor self, WPos pos, int offset)
+		{
+			var delta = self.CenterPosition - pos;
+			return delta.Y + delta.Z + offset;
+		}
+	}
+}