feat: add player-aware world interaction system

src/Features/Interactions/Godot/InteractionPromptController.cs

@@ -0,0 +1,27 @@
+using Game.Godot.Extensions;
+using Godot;
+
+namespace Game.Features.Interactions.Godot;
+
+public partial class InteractionPromptController : CanvasLayer
+{
+    [Export] public Label PromptLabel;
+
+    public override void _Ready()
+    {
+        this.AssertRequiredExports();
+        Clear();
+    }
+
+    public void ShowPrompt(string text)
+    {
+        PromptLabel.Text = text;
+        PromptLabel.Visible = text.Length > 0;
+    }
+
+    public void Clear()
+    {
+        PromptLabel.Text = string.Empty;
+        PromptLabel.Visible = false;
+    }
+}

src/Features/Interactions/Godot/InteractionPromptController.cs.uid

@@ -0,0 +1 @@
+uid://b9r2w6n4f8k1v

src/Features/Interactions/Godot/InteractionRaycaster.cs

@@ -0,0 +1,26 @@
+using Godot;
+
+namespace Game.Features.Interactions.Godot;
+
+public partial class InteractionRaycaster : RayCast3D
+{
+    public T GetTarget<T>() where T : class
+    {
+        if (!IsColliding() || GetCollider() is not Node node)
+        {
+            return null;
+        }
+
+        while (node is not null)
+        {
+            if (node is T target)
+            {
+                return target;
+            }
+
+            node = node.GetParent();
+        }
+
+        return null;
+    }
+}

src/Features/Interactions/Godot/InteractionRaycaster.cs.uid

@@ -0,0 +1 @@
+uid://e4m7k1x8c3q6h

src/Features/Interactions/Godot/InteractionWorldController.cs

@@ -0,0 +1,65 @@
+using System;
+using System.Collections.Generic;
+using Game.Features.Interactions.Contracts;
+using Godot;
+
+namespace Game.Features.Interactions.Godot;
+
+public partial class InteractionWorldController : Node, IInteractionWorld
+{
+    public const string RegistryGroup = "interaction_world_registry";
+
+    private readonly Dictionary<InteractionTargetId, WorldInteractionController> _targets = [];
+
+    public override void _EnterTree()
+    {
+        AddToGroup(RegistryGroup);
+    }
+
+    public void RegisterSceneTargets()
+    {
+        foreach (Node node in GetTree().GetNodesInGroup(WorldInteractionController.InteractionGroup))
+        {
+            if (node is WorldInteractionController target)
+            {
+                Register(target);
+            }
+        }
+    }
+
+    public void Register(WorldInteractionController target)
+    {
+        if (_targets.TryGetValue(target.Id, out WorldInteractionController existing))
+        {
+            if (ReferenceEquals(existing, target))
+            {
+                return;
+            }
+
+            throw new InvalidOperationException($"Duplicate interaction target id: {target.Id}.");
+        }
+
+        _targets.Add(target.Id, target);
+        target.RegisterWith(this);
+    }
+
+    public void Unregister(InteractionTargetId targetId)
+    {
+        _targets.Remove(targetId);
+    }
+
+    public InteractionResult TryInteract(InteractionRequest request)
+    {
+        if (!_targets.TryGetValue(request.TargetId, out WorldInteractionController target))
+        {
+            return InteractionResult.Fail(InteractionStatus.TargetNotFound, $"Target {request.TargetId} was not found.");
+        }
+
+        if (!target.CanInteract)
+        {
+            return InteractionResult.Fail(InteractionStatus.Unavailable, "The target is not currently available.");
+        }
+
+        return target.Execute(request.PlayerId);
+    }
+}

src/Features/Interactions/Godot/InteractionWorldController.cs.uid

@@ -0,0 +1 @@
+uid://f6q1c9m4w7v2n

src/Features/Interactions/Godot/WorldInteractionController.cs

@@ -0,0 +1,52 @@
+using System;
+using Game.Features.Interactions.Contracts;
+using Game.Features.Players.Contracts;
+using Godot;
+
+namespace Game.Features.Interactions.Godot;
+
+public abstract partial class WorldInteractionController : Node3D, IInteractionTarget
+{
+    public const string InteractionGroup = "world_interactions";
+
+    [Export] public string InstanceId;
+    [Export] public string PromptText = "Wejdź w interakcję";
+
+    public InteractionTargetId Id { get; private set; }
+    public virtual bool CanInteract => true;
+    public InteractionPrompt Prompt => new(PromptText);
+
+    private InteractionWorldController _registry;
+
+    public override void _Ready()
+    {
+        Guid id = string.IsNullOrWhiteSpace(InstanceId) ? Guid.NewGuid() : Guid.Parse(InstanceId);
+        Id = new InteractionTargetId(id);
+        AddToGroup(InteractionGroup);
+        RegisterWithAvailableWorld();
+    }
+
+    public override void _ExitTree()
+    {
+        _registry?.Unregister(Id);
+    }
+
+    public void RegisterWith(InteractionWorldController registry)
+    {
+        _registry = registry;
+    }
+
+    public abstract InteractionResult Execute(PlayerId playerId);
+
+    private void RegisterWithAvailableWorld()
+    {
+        foreach (Node node in GetTree().GetNodesInGroup(InteractionWorldController.RegistryGroup))
+        {
+            if (node is InteractionWorldController registry)
+            {
+                registry.Register(this);
+                return;
+            }
+        }
+    }
+}

src/Features/Interactions/Godot/WorldInteractionController.cs.uid

@@ -0,0 +1 @@
+uid://d2r8m5v1q9k4x