Files
Emberwild/Assets/GAME/Script/UI/CrosshairManager.cs
T
2026-07-14 14:25:02 +02:00

354 lines
12 KiB
C#

using System.Collections.Generic;
using DG.Tweening;
using TMPro;
using UnityEngine;
using UnityEngine.UI;
using Ashwild.Building;
using Ashwild.Interaction;
using Ashwild.Player;
namespace Ashwild.UI
{
/// <summary>
/// Singleton that drives the crosshair from the interaction hover state. It owns
/// a single icon Image and a prompt label, and swaps between two CrosshairState
/// ScriptableObjects (idle dot vs interact hand) — interpolating sprite, tint and
/// size with a DOTween bump. Pure bus consumer: it never raycasts.
/// </summary>
[DisallowMultipleComponent]
public class CrosshairManager : MonoBehaviour
{
#region Singleton
/// <summary>
/// Global access point; may be null if no crosshair exists in the scene.
/// </summary>
public static CrosshairManager Instance { get; private set; }
#endregion
#region Serialized Fields
[Header("References")]
/// <summary>
/// The single crosshair icon whose sprite, colour and size are driven by the
/// active CrosshairState.
/// </summary>
[SerializeField] private Image icon;
/// <summary>
/// Label under the crosshair filled with the interactable's prompt.
/// </summary>
[SerializeField] private TMP_Text promptLabel;
[Header("Build Cost")]
/// <summary>
/// Container the per-resource cost entries are parented under while a build is being placed.
/// Its own layout (e.g. a HorizontalLayoutGroup) arranges them.
/// </summary>
[SerializeField] private RectTransform costHolder;
/// <summary>
/// Prefab instantiated once per cost line (icon + amount) into the holder. Pooled and reused.
/// </summary>
[SerializeField] private BuildCostEntryUI costEntryPrefab;
[Header("States")]
/// <summary>
/// Look used when nothing is hovered (the plain dot).
/// </summary>
[SerializeField] private CrosshairState idleState;
/// <summary>
/// Look used when aiming at an interactable (the hand).
/// </summary>
[SerializeField] private CrosshairState hoverState;
[Header("Transition")]
/// <summary>
/// Duration of the icon size/colour transition, in seconds.
/// </summary>
[SerializeField] private float transitionDuration = 0.25f;
/// <summary>
/// Easing when growing into the hover state (OutBack gives the springy pop).
/// </summary>
[SerializeField] private Ease hoverEase = Ease.OutBack;
/// <summary>
/// Easing when settling back to the idle state.
/// </summary>
[SerializeField] private Ease idleEase = Ease.OutQuad;
/// <summary>
/// Duration of the prompt label fade, in seconds.
/// </summary>
[SerializeField] private float labelFadeDuration = 0.15f;
#endregion
#region State
/// <summary>
/// Active size tween, cached so it can be killed before restarting.
/// </summary>
private Tween sizeTween;
/// <summary>
/// Active colour tween, cached for the same reason.
/// </summary>
private Tween colorTween;
/// <summary>
/// Active label-fade tween, cached for the same reason.
/// </summary>
private Tween labelTween;
/// <summary>
/// The interactable currently hovered; polled each frame so dynamic prompts
/// (e.g. a cooking station whose food finishes cooking) refresh live.
/// </summary>
private IInteractable currentTarget;
/// <summary>
/// Last prompt shown, kept so the label is only rebuilt when it changes.
/// </summary>
private string currentPrompt;
/// <summary>
/// True while a build's cost is displayed: the prompt label is suppressed and the holder takes
/// over, so a hovered interactable's prompt never fights the cost readout mid-placement.
/// </summary>
private bool isShowingCost;
/// <summary>
/// The instantiated cost entries, pooled and reused across placements — activated up to the
/// current cost's line count and hidden beyond it.
/// </summary>
private readonly List<BuildCostEntryUI> costEntries = new List<BuildCostEntryUI>();
#endregion
#region Unity Lifecycle
/// <summary>
/// Establishes the singleton.
/// </summary>
private void Awake()
{
if (Instance != null && Instance != this)
{
Debug.LogWarning($"[CrosshairManager] Duplicate instance on '{name}' — destroying it.", this);
Destroy(this);
return;
}
Instance = this;
}
/// <summary>
/// Subscribes to hover changes and snaps to the idle state.
/// </summary>
private void OnEnable()
{
PlayerEvents.InteractableHoverChanged += HandleHoverChanged;
PlayerEvents.BuildCostChanged += HandleBuildCostChanged;
ApplyState(idleState, isHover: false, animated: false);
SetLabel(null, animated: false);
}
/// <summary>
/// Unsubscribes — must mirror OnEnable exactly.
/// </summary>
private void OnDisable()
{
PlayerEvents.InteractableHoverChanged -= HandleHoverChanged;
PlayerEvents.BuildCostChanged -= HandleBuildCostChanged;
}
/// <summary>
/// Re-reads the hovered target's prompt each frame so a prompt that changes
/// while the player keeps aiming (cooking finishing, held item swapped) stays
/// in sync. Does nothing while nothing is hovered.
/// </summary>
private void Update()
{
if (currentTarget == null) return;
string prompt = currentTarget.InteractionPrompt;
if (prompt != currentPrompt)
{
currentPrompt = prompt;
if (!isShowingCost) SetLabel(prompt, animated: true);
}
}
/// <summary>
/// Kills any running tween and releases the singleton on teardown.
/// </summary>
private void OnDestroy()
{
KillTweens();
if (Instance == this)
Instance = null;
}
#endregion
#region Event Handlers
/// <summary>
/// Grows to the hover look with the action prompt when a target is hovered,
/// or returns to the idle dot when the hover clears (target is null).
/// </summary>
private void HandleHoverChanged(IInteractable target)
{
bool hovering = target != null;
currentTarget = target;
currentPrompt = hovering ? target.InteractionPrompt : null;
ApplyState(hovering ? hoverState : idleState, hovering, animated: true);
if (!isShowingCost) SetLabel(currentPrompt, animated: true);
}
/// <summary>
/// Shows the active build's cost (hiding the prompt label and filling the holder) while placing,
/// or clears it and restores the normal prompt when the list is null/empty (placement ended).
/// </summary>
private void HandleBuildCostChanged(IReadOnlyList<BuildCostView> cost)
{
if (cost == null || cost.Count == 0)
{
ClearCost();
return;
}
isShowingCost = true;
SetLabel(null, animated: true);
PopulateCost(cost);
}
#endregion
#region Internal Helpers
/// <summary>
/// Applies a CrosshairState to the icon: swaps the sprite immediately, then
/// tweens size and colour (or sets them instantly when not animated).
/// </summary>
private void ApplyState(CrosshairState state, bool isHover, bool animated)
{
if (icon == null) return;
if (state == null)
{
Debug.LogError("[CrosshairManager] A CrosshairState is not assigned.", this);
return;
}
icon.sprite = state.Sprite;
sizeTween?.Kill();
colorTween?.Kill();
if (!animated)
{
icon.rectTransform.sizeDelta = state.Size;
icon.color = state.Color;
return;
}
Ease ease = isHover ? hoverEase : idleEase;
sizeTween = DOTween.To(() => icon.rectTransform.sizeDelta,
v => icon.rectTransform.sizeDelta = v, state.Size, transitionDuration).SetEase(ease);
colorTween = DOTween.To(() => icon.color,
c => icon.color = c, state.Color, transitionDuration);
}
/// <summary>
/// Sets the prompt text and fades the label in (non-null) or out (null).
/// </summary>
private void SetLabel(string prompt, bool animated)
{
if (promptLabel == null) return;
bool show = !string.IsNullOrEmpty(prompt);
if (show)
promptLabel.text = prompt;
labelTween?.Kill();
float target = show ? 1f : 0f;
if (!animated)
{
promptLabel.alpha = target;
return;
}
labelTween = DOTween.To(() => promptLabel.alpha,
a => promptLabel.alpha = a, target, labelFadeDuration);
}
/// <summary>
/// Fills the holder with one entry per cost line, reusing pooled entries and only instantiating
/// when the current build needs more lines than any previous one. Entries beyond this build's
/// count are hidden. Logs and no-ops when the holder or prefab reference is missing.
/// </summary>
private void PopulateCost(IReadOnlyList<BuildCostView> cost)
{
if (costHolder == null || costEntryPrefab == null)
{
Debug.LogError("[CrosshairManager] Cost holder or entry prefab not assigned — cannot show the build cost.", this);
return;
}
for (int i = 0; i < cost.Count; i++)
{
BuildCostEntryUI entry;
if (i < costEntries.Count)
{
entry = costEntries[i];
}
else
{
entry = Instantiate(costEntryPrefab, costHolder);
costEntries.Add(entry);
}
entry.gameObject.SetActive(true);
entry.Set(cost[i].Icon, cost[i].Owned, cost[i].Amount, cost[i].Affordable);
}
for (int i = cost.Count; i < costEntries.Count; i++)
if (costEntries[i] != null) costEntries[i].gameObject.SetActive(false);
}
/// <summary>
/// Hides every cost entry and restores the prompt for whatever is currently hovered. No-op when
/// no cost is being shown.
/// </summary>
private void ClearCost()
{
if (!isShowingCost) return;
isShowingCost = false;
for (int i = 0; i < costEntries.Count; i++)
if (costEntries[i] != null) costEntries[i].gameObject.SetActive(false);
SetLabel(currentPrompt, animated: true);
}
/// <summary>
/// Kills every cached tween so none survive a disable/destroy.
/// </summary>
private void KillTweens()
{
sizeTween?.Kill();
colorTween?.Kill();
labelTween?.Kill();
sizeTween = colorTween = labelTween = null;
}
#endregion
}
}