फ्लोटिंग डैमेज नंबर: हैंडऑफ स्वीकृति और इंजन कार्यान्वयन

जब एक सेकंड में दस हिट पड़ती हैं, तो फ्लोटिंग टेक्स्ट की समस्याएँ शायद ही कभी “बड़े फ़ॉन्ट” से ठीक होती हैं: Editor में शार्प, डिवाइस पर सॉफ्ट; क्रिट रंग काम करता है लेकिन “K” या माइनस गायब है; नंबर HUD बटनों पर बैठ जाते हैं और टैप चुरा लेते हैं; या Instantiate GC में स्पाइक करता है। पॉपअप उच्च-आवृत्ति, अल्पकालिक UI हैं—इन्हें स्थिर HUD से अलग स्वीकार करें।

नीचे Unity UGUI / TextMeshPro (RectTransform, Canvas, sortingOrder) पर केंद्रित है। Godot: Label + Theme / bitmap; Cocos: Label + bitmap font + pool—वही मानदंड और चरण क्रम। स्थिर HUD शेल: इंजन + MCP चेकलिस्ट। प्री-शिप आइटम 3 (“धुंधली आर्ट / डैमेज नंबर”)—Release डिवाइसों पर पुनः परीक्षण करें।

असफलता मानदंड (कोई एक भी = पास नहीं): पठनीयता खराब (धुंधलापन, क्लिप, गायब ग्लिफ़); लक्ष्य डिवाइसों पर कॉम्बैट फ्रेम टाइम बिना-पॉपअप बेसलाइन से स्पष्ट रूप से खराब; पॉपअप raycast चालू रहते हुए आवश्यक टैप अवरुद्ध करते हैं; क्रिट/हील/मिस विज़ुअल डेटा-चालित स्पेक से मेल नहीं खाते; नंबर फ़ॉर्मेटिंग डिज़ाइन टेबल से असंगत (जैसे 1.2K बनाम 1200 मिश्रित)।

---

पहले चुनें: TMP या बिटमैप अंक

परिदृश्य	बेहतर फ़िट	सामान्य नुकसान
अंक + कुछ प्रतीक (0-9 . + - %)	बिटमैप / कस्टम डिजिट मेश	चारसेट अंतराल; गलत फ़िल्टर → धुंधलापन
पूर्ण स्थानीयकृत स्ट्रिंग्स (“Critical”, “Immune”)	TMP + स्ट्रिंग टेबल	अंकों के साथ मिलाने पर चौड़ाई जिटर
भारी आउटलाइन, ग्रेडिएंट, एनिमेटेड स्टाइल	बिटमैप या फ्रेम सीक्वेंस	स्टेट गायब → गलत रंग फ़ॉलबैक
प्रोटोटाइप	डिफ़ॉल्ट TMP SDF	संदर्भ रिज़ॉल्यूशन नहीं → डिवाइस पर सॉफ्ट

यदि डिवाइस धुंधलापन बना रहता है: Canvas Scaler संदर्भ, TMP padding/atlas, बिटमैप Filter Mode (अक्सर Point)—फिर चारसेट या SDF गुणवत्ता। देखें बिटमैप फ़ॉन्ट चारसेट योजना और प्री-शिप आइटम 3।

---

Unity: बनाएँ और स्वीकारें (6 चरण)

1. समर्पित Canvas या स्पष्ट सॉर्ट

• समर्पित Canvas (Screen Space - Camera कॉम्बैट कैमरा के साथ संरेखित) या HUD चाइल्ड लेयर उपयोग करें।
• sortingOrder को वर्ल्ड UI के ऊपर, मोडल पॉपअप के नीचे सेट करें; पॉपअप ग्राफ़िक्स पर raycastTarget = false।
• वर्ल्ड पॉपअप: एक साझा World Canvas—प्रत्येक नंबर के लिए एक Canvas नहीं।

2. ऑब्जेक्ट पूल

• स्क्रीन पर चरम संख्या से अधिक प्रीवार्म करें (स्किल्स से तनाव; अक्सर न्यूनतम 16–32)।
• रीसायकल पर: स्थिति, अल्फा, स्केल, एनिमेशन स्टेट, टेक्स्ट रीसेट करें।
• प्रति-हिट कोई Instantiate/Destroy नहीं।

3. डेटा को प्रस्तुति से अलग करें

• कॉम्बैट DamagePopupEvent उत्सर्जित करता है (मान, प्रकार, वर्ल्ड पॉज़/अटैच पॉइंट, क्रिट फ़्लैग)।
• प्रस्तुति रंग, प्रीफ़िक्स, संक्षेप (K/M/B), कर्व चुनती है।
• डिज़ाइन टेबल प्रकार → स्टाइल Prefab मैप करती है (Normal / Crit / Heal / Miss / Block)।

4. मोशन और पठनीयता

• सामान्य: ऊपर फ्लोट + फ़ेड + हल्का स्केल; 0.4–0.8s; एक ही एंकर पर स्टैगर या क्यू।
• एक ही फ्रेम में मल्टी-हिट: मर्ज करें या ओवरलैप से बचने के लिए 1–2 फ्रेम ऑफ़सेट करें।
• यदि आकार कैमरा दूरी का अनुसरण करता है, तो एक वर्ल्ड स्केल नियम उपयोग करें—UI Canvas स्केल के साथ दो बार न मिलाएँ।

5. चारसेट और फ़ॉर्मेटिंग

• बिटमैप: 0-9 . , + - % x K M B और प्रोजेक्ट संक्षेप नियम सत्यापित करें।
• TMP: फ़ील्ड या स्प्राइट विभाजित करें—फ़ॉन्ट बदलने के लिए एक स्ट्रिंग पर निर्भर न रहें।
• लोकेल ओवरफ़्लो के साथ: पूर्ण स्थानीयकृत वाक्यों को पॉपअप आर्ट के रूप में रास्टराइज़ न करें।

6. डिवाइस स्मोक

• Dev और Release: 30s मॉब स्वार्म, मल्टी-टिक बॉस स्किल, कम-RAM डिवाइस।
• पॉपअप के साथ बनाम बिना फ्रेम टाइम की तुलना करें; क्रिट/हील/मिस प्रत्येक का एक स्क्रीनशॉट लें।
• पास मानदंड Prefab + पूल कॉन्फ़िग में रहते हैं, केवल टेस्ट Scene में नहीं।

---

डिज़ाइन हैंडऑफ (अंक और स्टेट)

डिलीवरी	उपयोग
डिजिट आर्ट या TMP स्टाइल प्रति स्टेट (Normal/Crit/Heal/Miss)	टेबल-चालित Prefab/Material
लक्ष्य रिज़ॉल्यूशन पर आउटलाइन/शैडो	डिवाइस शार्पनेस जाँच
अंकों पर क्रिट/कॉम्बो रंग + आइकन	कोड में हार्ड-कोडेड टिंट से बचें
चारसेट स्कोप (केवल अंक बनाम स्थानीयकृत इकाइयाँ)	बिटमैप या स्ट्रिंग टेबल

डिज़ाइन हैंडऑफ चेकलिस्ट: यदि पॉपअप रास्टर हैं, प्रति-लोकेल या नहीं स्पेक करें; डिफ़ॉल्ट बिटमैप अंक + TMP लेबल।

---

फ़िक्स रूटिंग

लक्षण	संभावित कारण	कार्रवाई	स्वामी
डिवाइस पर सॉफ्ट, Editor में शार्प	Scaler / SDF / बिटमैप फ़िल्टर	संदर्भ रेज़ संरेखित करें; Point फ़िल्टर; SDF padding	इंजीनियरिंग
गायब ग्लिफ़	चारसेट / प्रतीक	चारसेट बढ़ाएँ; या TMP	इंजीनियरिंग + डिज़ाइन
बटन अवरुद्ध	सॉर्ट / raycast	ऑर्डर घटाएँ या raycast अक्षम करें	इंजीनियरिंग
रुकावट	पूल नहीं / बहुत अधिक FX+टेक्स्ट	पूल; समान-फ्रेम पॉप मर्ज करें	इंजीनियरिंग
गलत क्रिट लुक	हार्ड-कोडेड रंग	प्रकार→Prefab; डिज़ाइन स्टेट	इंजीनियरिंग + डिज़ाइन
HUD स्टाइल से अलग	दो फ़ॉन्ट पाइपलाइन	फ़ॉन्ट स्रोत या Theme एकीकृत करें	डिज़ाइन + इंजीनियरिंग

---

FAQ

क्या पॉपअप World Space होने चाहिए?
नहीं। फ़िक्स्ड 2D अक्सर Screen Space - Camera उपयोग करता है; फ्री 3D कैमरा अक्सर World Canvas उपयोग करते हैं। एक चुनें और दस्तावेज़ित करें।

फ़्लेयर के लिए UI पार्टिकल्स?
FX के लिए ठीक है; अंक लोकेल और पूलिंग के लिए Label/TMP/mesh ही रहें।

डैमेज लॉजिक के साथ एक स्क्रिप्ट?
लॉजिक से इवेंट उत्सर्जित करें; टेस्ट और एक्सेसिबिलिटी के लिए प्रस्तुति टॉगल (ShowDamageNumbers)।

बड़े नंबर?
डिज़ाइन से एक फ़ॉर्मेटर नियम; एकल कार्यान्वयन—UI स्क्रिप्ट्स में कॉपी-पेस्ट नहीं।