feat: 플레이어 이상상태 HUD 표시 및 디버그 보강

- AbnormalityData에 UI 표시 여부 플래그를 추가하고 이상상태 목록 UI가 이를 반영하도록 정리 - PlayerHUD가 로컬 플레이어의 이상상태 요약 문자열을 런타임에 자동 생성해 표시하도록 확장 - 디버그 메뉴에 기절, 침묵, 집행자의 낙인 적용과 HUD 요약 로그 기능을 추가 - TMP 한글 폰트를 HUD 요약에 재사용하고 관련 폰트 아틀라스를 갱신 - Unity 리프레시, 빌드, 집행자의 낙인 HUD 출력 로그로 동작 검증
2026-03-25 00:05:23 +09:00
parent 42970af621
commit 7a62e6c631
15 changed files with 276 additions and 6033 deletions
--- a/Assets/_Game/Scripts/UI/AbnormalityListUI.cs
+++ b/Assets/_Game/Scripts/UI/AbnormalityListUI.cs
@@ -237,6 +237,9 @@ namespace Colosseum.UI

            foreach (var abnormality in abnormalities)
            {
+                if (abnormality?.Data == null || !abnormality.Data.showInUI)
+                    continue;
+
                var slot = GetSlot();
                if (slot == null) continue;

--- a/Assets/_Game/Scripts/UI/PlayerHUD.cs
+++ b/Assets/_Game/Scripts/UI/PlayerHUD.cs
@@ -1,11 +1,17 @@
 using System;
+using System.Collections.Generic;
+using System.Text;
+
 using UnityEngine;
+using TMPro;
+
+using Colosseum.Abnormalities;
 using Colosseum.Player;

 namespace Colosseum.UI
 {
    /// <summary>
-    /// 플레이어 HUD - 체력/마나 바 관리
+    /// 플레이어 HUD - 체력/마나 바와 이상상태 요약 관리
    /// </summary>
    public class PlayerHUD : MonoBehaviour
    {
@@ -13,11 +19,27 @@ namespace Colosseum.UI
        [SerializeField] private StatBar healthBar;
        [SerializeField] private StatBar manaBar;

+        [Header("Abnormality Summary")]
+        [Tooltip("이상상태 요약 텍스트 (비어 있으면 런타임에 자동 생성)")]
+        [SerializeField] private TMP_Text abnormalitySummaryText;
+
+        [Tooltip("이상상태 요약 텍스트를 자동 생성할지 여부")]
+        [SerializeField] private bool autoCreateAbnormalitySummary = true;
+
        [Header("Target")]
        [Tooltip("자동으로 로컬 플레이어 찾기")]
        [SerializeField] private bool autoFindPlayer = true;

        private PlayerNetworkController targetPlayer;
+        private AbnormalityManager targetAbnormalityManager;
+        private float abnormalityRefreshTimer;
+
+        private const float AbnormalityRefreshInterval = 0.1f;
+
+        /// <summary>
+        /// 현재 HUD에 표시 중인 이상상태 요약 문자열
+        /// </summary>
+        public string CurrentAbnormalitySummary => abnormalitySummaryText != null ? abnormalitySummaryText.text : string.Empty;

        private void Start()
        {
@@ -25,6 +47,8 @@ namespace Colosseum.UI
            {
                FindLocalPlayer();
            }
+
+            EnsureAbnormalitySummaryText();
        }

        private void Update()
@@ -34,6 +58,16 @@ namespace Colosseum.UI
            {
                FindLocalPlayer();
            }
+
+            if (targetAbnormalityManager != null)
+            {
+                abnormalityRefreshTimer += Time.deltaTime;
+                if (abnormalityRefreshTimer >= AbnormalityRefreshInterval)
+                {
+                    abnormalityRefreshTimer = 0f;
+                    UpdateAbnormalitySummary();
+                }
+            }
        }

        private void OnDestroy()
@@ -63,12 +97,14 @@ namespace Colosseum.UI
            UnsubscribeFromEvents();

            targetPlayer = player;
+            targetAbnormalityManager = targetPlayer != null ? targetPlayer.GetComponent<AbnormalityManager>() : null;

            // 새 타겟 구독
            SubscribeToEvents();

            // 초기 값 설정
            UpdateStatBars();
+            UpdateAbnormalitySummary();
        }

        private void SubscribeToEvents()
@@ -78,15 +114,30 @@ namespace Colosseum.UI
            targetPlayer.OnHealthChanged += HandleHealthChanged;
            targetPlayer.OnManaChanged += HandleManaChanged;
            targetPlayer.OnShieldChanged += HandleShieldChanged;
+
+            if (targetAbnormalityManager != null)
+            {
+                targetAbnormalityManager.OnAbnormalityAdded += HandleAbnormalityAdded;
+                targetAbnormalityManager.OnAbnormalityRemoved += HandleAbnormalityRemoved;
+                targetAbnormalityManager.OnAbnormalitiesChanged += HandleAbnormalitiesChanged;
+            }
        }

        private void UnsubscribeFromEvents()
        {
-            if (targetPlayer == null) return;
+            if (targetPlayer != null)
+            {
+                targetPlayer.OnHealthChanged -= HandleHealthChanged;
+                targetPlayer.OnManaChanged -= HandleManaChanged;
+                targetPlayer.OnShieldChanged -= HandleShieldChanged;
+            }

-            targetPlayer.OnHealthChanged -= HandleHealthChanged;
-            targetPlayer.OnManaChanged -= HandleManaChanged;
-            targetPlayer.OnShieldChanged -= HandleShieldChanged;
+            if (targetAbnormalityManager != null)
+            {
+                targetAbnormalityManager.OnAbnormalityAdded -= HandleAbnormalityAdded;
+                targetAbnormalityManager.OnAbnormalityRemoved -= HandleAbnormalityRemoved;
+                targetAbnormalityManager.OnAbnormalitiesChanged -= HandleAbnormalitiesChanged;
+            }
        }

        private void HandleHealthChanged(float oldValue, float newValue)
@@ -113,6 +164,21 @@ namespace Colosseum.UI
            }
        }

+        private void HandleAbnormalityAdded(ActiveAbnormality abnormality)
+        {
+            UpdateAbnormalitySummary();
+        }
+
+        private void HandleAbnormalityRemoved(ActiveAbnormality abnormality)
+        {
+            UpdateAbnormalitySummary();
+        }
+
+        private void HandleAbnormalitiesChanged()
+        {
+            UpdateAbnormalitySummary();
+        }
+
        private void UpdateStatBars()
        {
            if (targetPlayer == null) return;
@@ -127,5 +193,93 @@ namespace Colosseum.UI
                manaBar.SetValue(targetPlayer.Mana, targetPlayer.MaxMana);
            }
        }
+
+        private void EnsureAbnormalitySummaryText()
+        {
+            if (abnormalitySummaryText != null || !autoCreateAbnormalitySummary)
+                return;
+
+            if (transform is not RectTransform parentRect)
+                return;
+
+            GameObject summaryObject = new GameObject("AbnormalitySummaryText", typeof(RectTransform));
+            summaryObject.transform.SetParent(parentRect, false);
+
+            RectTransform rectTransform = summaryObject.GetComponent<RectTransform>();
+            rectTransform.anchorMin = new Vector2(1f, 1f);
+            rectTransform.anchorMax = new Vector2(1f, 1f);
+            rectTransform.pivot = new Vector2(1f, 1f);
+            rectTransform.anchoredPosition = new Vector2(-24f, -120f);
+            rectTransform.sizeDelta = new Vector2(320f, 180f);
+
+            TextMeshProUGUI summaryText = summaryObject.AddComponent<TextMeshProUGUI>();
+            summaryText.fontSize = 18f;
+            summaryText.alignment = TextAlignmentOptions.TopRight;
+            summaryText.textWrappingMode = TextWrappingModes.NoWrap;
+            summaryText.richText = true;
+            summaryText.text = string.Empty;
+
+            TMP_FontAsset summaryFont = healthBar != null && healthBar.FontAsset != null
+                ? healthBar.FontAsset
+                : manaBar != null ? manaBar.FontAsset : null;
+
+            if (summaryFont != null)
+            {
+                summaryText.font = summaryFont;
+            }
+            else if (TMP_Settings.defaultFontAsset != null)
+            {
+                summaryText.font = TMP_Settings.defaultFontAsset;
+            }
+
+            abnormalitySummaryText = summaryText;
+        }
+
+        private void UpdateAbnormalitySummary()
+        {
+            if (abnormalitySummaryText == null)
+            {
+                EnsureAbnormalitySummaryText();
+            }
+
+            if (abnormalitySummaryText == null)
+                return;
+
+            if (targetAbnormalityManager == null)
+            {
+                abnormalitySummaryText.text = string.Empty;
+                return;
+            }
+
+            IReadOnlyList<ActiveAbnormality> activeAbnormalities = targetAbnormalityManager.ActiveAbnormalities;
+            StringBuilder builder = new StringBuilder();
+
+            for (int i = 0; i < activeAbnormalities.Count; i++)
+            {
+                ActiveAbnormality abnormality = activeAbnormalities[i];
+                if (abnormality?.Data == null || !abnormality.Data.showInUI)
+                    continue;
+
+                if (builder.Length > 0)
+                    builder.AppendLine();
+
+                string color = abnormality.Data.isDebuff ? "#FF7070" : "#70D0FF";
+                builder.Append("<color=");
+                builder.Append(color);
+                builder.Append(">");
+                builder.Append(abnormality.Data.abnormalityName);
+
+                if (!abnormality.Data.IsPermanent)
+                {
+                    builder.Append(" ");
+                    builder.Append(Mathf.CeilToInt(Mathf.Max(0f, abnormality.RemainingDuration)));
+                    builder.Append("s");
+                }
+
+                builder.Append("</color>");
+            }
+
+            abnormalitySummaryText.text = builder.ToString();
+        }
    }
 }
--- a/Assets/_Game/Scripts/UI/StatBar.cs
+++ b/Assets/_Game/Scripts/UI/StatBar.cs
@@ -34,6 +34,11 @@ namespace Colosseum.UI
        private float displayValue;
        private float bonusValue;

+        /// <summary>
+        /// 현재 바가 사용하는 폰트 에셋
+        /// </summary>
+        public TMP_FontAsset FontAsset => valueText != null ? valueText.font : null;
+
        /// <summary>
        /// 바 값 설정
        /// </summary>