added forge addon

addons/forge/nodes/EffectArea3D.cs

@@ -0,0 +1,81 @@
+// Copyright © Gamesmiths Guild.
+
+using System.Diagnostics;
+using Gamesmiths.Forge.Core;
+using Gamesmiths.Forge.Godot.Core;
+using Godot;
+
+namespace Gamesmiths.Forge.Godot.Nodes;
+
+[GlobalClass]
+[Icon("uid://tbuwwf03ikr3")]
+public partial class EffectArea3D : Area3D
+{
+	private EffectApplier? _effectApplier;
+
+	[Export]
+	public Node? EffectOwner { get; set; }
+
+	[Export]
+	public Node? EffectSource { get; set; }
+
+	[Export]
+	public int EffectLevel { get; set; } = 1;
+
+	[Export]
+	public EffectTriggerMode TriggerMode { get; set; }
+
+	private IForgeEntity? OwnerEntity => EffectOwner as IForgeEntity;
+
+	private IForgeEntity? SourceEntity => EffectSource as IForgeEntity;
+
+	public override void _Ready()
+	{
+		if (EffectOwner is not null && EffectOwner is not IForgeEntity)
+		{
+			GD.PushError($"{nameof(EffectOwner)} must implement {nameof(IForgeEntity)}.");
+		}
+
+		base._Ready();
+
+		_effectApplier = new EffectApplier(this);
+
+		switch (TriggerMode)
+		{
+			case EffectTriggerMode.OnEnter:
+				BodyEntered += ApplyEffects;
+				AreaEntered += ApplyEffects;
+				break;
+
+			case EffectTriggerMode.OnExit:
+				BodyExited += ApplyEffects;
+				AreaExited += ApplyEffects;
+				break;
+
+			case EffectTriggerMode.OnStay:
+				BodyEntered += AddEffects;
+				AreaEntered += AddEffects;
+				BodyExited += RemoveEffects;
+				AreaExited += RemoveEffects;
+				break;
+		}
+	}
+
+	private void ApplyEffects(Node3D node)
+	{
+		Debug.Assert(_effectApplier is not null, $"{_effectApplier} should have been initialized on _Ready().");
+		_effectApplier.ApplyEffects(node, OwnerEntity, SourceEntity, EffectLevel);
+	}
+
+	private void AddEffects(Node3D node)
+	{
+		Debug.Assert(_effectApplier is not null, $"{_effectApplier} should have been initialized on _Ready().");
+		_effectApplier.AddEffects(node, OwnerEntity, SourceEntity, EffectLevel);
+	}
+
+	private void RemoveEffects(Node3D node)
+	{
+		Debug.Assert(_effectApplier is not null, $"{_effectApplier} should have been initialized on _Ready().");
+		_effectApplier.RemoveEffects(node);
+	}
+}