Feature: Add low deck count warning

Show a centered deck count above each main deck when 10 or fewer cards remain, using the existing hover-count font and flashing only below 5 cards.

Assets/Scripts/MDPro3/UI/ServantUI/OcgCoreUI.cs

@@ -85,6 +85,15 @@ namespace MDPro3.UI.ServantUI
             m_TextPlaceCount = m_TextPlaceCount != null ? m_TextPlaceCount
             : Manager.GetElement<TextMeshProUGUI>(LABEL_TXT_PLACECOUNT);
 
+        private RectTransform nearLowDeckIndicator;
+        private RectTransform farLowDeckIndicator;
+        private TextMeshProUGUI nearLowDeckCount;
+        private TextMeshProUGUI farLowDeckCount;
+        private static readonly Vector2 NearLowDeckIndicatorOffset = new Vector2(0f, 14f);
+        private static readonly Vector2 FarLowDeckIndicatorOffset = new Vector2(0f, -6f);
+        private const float LowDeckIndicatorSize = 44f;
+        private const float LowDeckIndicatorFontSizeMax = 30f;
+
         #endregion
 
         #region Mono
@@ -173,6 +182,7 @@ namespace MDPro3.UI.ServantUI
             base.ShowEvent();
 
             CloseHint();
+            HideLowDeckCountIndicators();
 
             ButtonStop.gameObject.SetActive(true);
             ButtonPlay.gameObject.SetActive(false);
@@ -182,22 +192,71 @@ namespace MDPro3.UI.ServantUI
             ButtonTiming.gameObject.SetActive(condition == Condition.Duel);
         }
 
+        private void Update()
+        {
+            RefreshLowDeckCountIndicators();
+        }
+
         #region UI Tools
 
-        public void SetHint(string hint)
+        private void EnsureLowDeckCountIndicators()
         {
-            Hint.SetActive(true);
-            TextHint.text = hint;
+            if (nearLowDeckIndicator != null && farLowDeckIndicator != null)
+                return;
+
+            if (nearLowDeckIndicator == null)
+                nearLowDeckIndicator = CreateLowDeckCountIndicator("LowDeckCountNear", out nearLowDeckCount);
+            if (farLowDeckIndicator == null)
+                farLowDeckIndicator = CreateLowDeckCountIndicator("LowDeckCountFar", out farLowDeckCount);
         }
 
-        public void CloseHint()
+        private RectTransform CreateLowDeckCountIndicator(string name, out TextMeshProUGUI indicator)
         {
-            Hint.SetActive(false);
+            var indicatorObject = new GameObject(name, typeof(RectTransform));
+            indicatorObject.transform.SetParent(RectPlaceCount.parent, false);
+            indicatorObject.name = name;
+            indicatorObject.SetActive(false);
+
+            var indicatorRect = indicatorObject.GetComponent<RectTransform>();
+            indicatorRect.anchorMin = RectPlaceCount.anchorMin;
+            indicatorRect.anchorMax = RectPlaceCount.anchorMax;
+            indicatorRect.pivot = new Vector2(0.5f, 0.5f);
+            indicatorRect.sizeDelta = new Vector2(LowDeckIndicatorSize, LowDeckIndicatorSize);
+            indicatorRect.localScale = Vector3.one;
+            indicatorRect.localRotation = Quaternion.identity;
+            indicatorRect.anchoredPosition = Vector2.zero;
+
+            var textObject = new GameObject("Text", typeof(RectTransform), typeof(TextMeshProUGUI));
+            textObject.transform.SetParent(indicatorObject.transform, false);
+            indicator = textObject.GetComponent<TextMeshProUGUI>();
+            indicator.font = TextPlaceCount.font;
+            indicator.fontSharedMaterial = TextPlaceCount.fontSharedMaterial;
+            indicator.fontStyle = TextPlaceCount.fontStyle;
+            indicator.enableAutoSizing = true;
+            indicator.fontSizeMin = 1f;
+            indicator.fontSizeMax = LowDeckIndicatorFontSizeMax;
+            indicator.alignment = TextAlignmentOptions.Center;
+            indicator.color = TextPlaceCount.color;
+            indicator.margin = Vector4.zero;
+            indicator.raycastTarget = false;
+            indicator.rectTransform.anchorMin = Vector2.zero;
+            indicator.rectTransform.anchorMax = Vector2.one;
+            indicator.rectTransform.pivot = new Vector2(0.5f, 0.5f);
+            indicator.rectTransform.anchoredPosition = Vector2.zero;
+            indicator.rectTransform.sizeDelta = Vector2.zero;
+            indicator.rectTransform.localScale = Vector3.one;
+            return indicatorRect;
         }
 
-        public void ShowLocationCount(GPS p)
+        private Vector2 GetLocationCountPosition(GPS p, bool centerDeckCount)
         {
             var position = UIManager.WorldToScreenPoint(Program.instance.camera_.cameraMain, GameCard.GetCardPosition(p));
+            if (centerDeckCount && (p.location & (uint)CardLocation.Deck) > 0)
+            {
+                position += p.controller == 0 ? NearLowDeckIndicatorOffset : FarLowDeckIndicatorOffset;
+                return position;
+            }
+
             if ((p.location & ((uint)CardLocation.Deck + (uint)CardLocation.Extra)) > 0 && p.controller == 0)
                 position.y += 80;
             else if ((p.location & ((uint)CardLocation.Deck + (uint)CardLocation.Extra)) > 0 && p.controller == 1)
@@ -215,19 +274,91 @@ namespace MDPro3.UI.ServantUI
                 RectPlaceCount.localScale = new Vector3(1, 1, 1);
             }
 
-            if (p.controller == 0 && (p.location & (uint)CardLocation.Extra) > 0
-                || p.controller == 1 && (p.location & (uint)CardLocation.Deck) > 0)
+            if (!centerDeckCount)
             {
-                position.x += 20;
-                RectPlaceCount.localScale = new Vector3(1, 1, 1);
+                if (p.controller == 0 && (p.location & (uint)CardLocation.Extra) > 0
+                    || p.controller == 1 && (p.location & (uint)CardLocation.Deck) > 0)
+                {
+                    position.x += 20;
+                    RectPlaceCount.localScale = new Vector3(1, 1, 1);
+                }
+                else if (p.controller == 1 && (p.location & (uint)CardLocation.Extra) > 0
+                    || p.controller == 0 && (p.location & (uint)CardLocation.Deck) > 0)
+                {
+                    position.x -= 20;
+                    RectPlaceCount.localScale = new Vector3(-1, 1, 1);
+                }
             }
-            else if (p.controller == 1 && (p.location & (uint)CardLocation.Extra) > 0
-                || p.controller == 0 && (p.location & (uint)CardLocation.Deck) > 0)
+
+            return position;
+        }
+
+        private void RefreshLowDeckCountIndicators()
+        {
+            if (!gameObject.activeInHierarchy || Program.instance?.ocgcore == null)
             {
-                position.x -= 20;
-                RectPlaceCount.localScale = new Vector3(-1, 1, 1);
+                HideLowDeckCountIndicators();
+                return;
             }
 
+            EnsureLowDeckCountIndicators();
+            RefreshLowDeckCountIndicator(nearLowDeckIndicator, nearLowDeckCount, 0);
+            RefreshLowDeckCountIndicator(farLowDeckIndicator, farLowDeckCount, 1);
+        }
+
+        private void RefreshLowDeckCountIndicator(RectTransform indicatorRoot, TextMeshProUGUI indicator, uint controller)
+        {
+            if (indicatorRoot == null || indicator == null)
+                return;
+
+            var deckCount = Program.instance.ocgcore.GetLocationCardCount(CardLocation.Deck, controller);
+            if (deckCount <= 0 || deckCount > 10)
+            {
+                indicatorRoot.gameObject.SetActive(false);
+                return;
+            }
+
+            var gps = new GPS
+            {
+                controller = controller,
+                location = (uint)CardLocation.Deck
+            };
+            indicatorRoot.anchoredPosition = GetLocationCountPosition(gps, true);
+            indicator.text = deckCount.ToString();
+
+            var alpha = 1f;
+            if (deckCount < 5)
+                alpha = 0.35f + 0.65f * ((Mathf.Sin(Time.unscaledTime * 8f) + 1f) * 0.5f);
+
+            var color = TextPlaceCount.color;
+            color.a = alpha;
+            indicator.color = color;
+            if (!indicatorRoot.gameObject.activeSelf)
+                indicatorRoot.gameObject.SetActive(true);
+        }
+
+        private void HideLowDeckCountIndicators()
+        {
+            if (nearLowDeckIndicator != null)
+                nearLowDeckIndicator.gameObject.SetActive(false);
+            if (farLowDeckIndicator != null)
+                farLowDeckIndicator.gameObject.SetActive(false);
+        }
+
+        public void SetHint(string hint)
+        {
+            Hint.SetActive(true);
+            TextHint.text = hint;
+        }
+
+        public void CloseHint()
+        {
+            Hint.SetActive(false);
+        }
+
+        public void ShowLocationCount(GPS p)
+        {
+            var position = GetLocationCountPosition(p, false);
             TextPlaceCount.rectTransform.localScale = RectPlaceCount.localScale;
             RectPlaceCount.anchoredPosition = position;
             RectPlaceCount.gameObject.SetActive(true);
@@ -565,4 +696,4 @@ namespace MDPro3.UI.ServantUI
 
         #endregion
     }
-}
\ No newline at end of file
+}