Skip to content

Sprite Number Display

Display an integer value using digit sprites (0–9).
Supports left or right alignment, and optional zero-padding via an “empty” sprite.

Parameters

Parameter Description
Digits Parent The parent GameObject containing one child per digit. Each child represents a digit slot. Children are used left→right in hierarchy order.
Number The integer value to display (e.g., 0, 42, 1234).
Only digits 0–9 are rendered; negative or decimal values are ignored.
Alignment Choose Left or Right alignment.
• Left – Writes digits from the first child onward, only if Empty Sprite is None.
• Right – Always aligns digits to the right.
Number Sprites (0–9) Assign exactly 10 sprites in order: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9.
These sprites are used to render each digit.
Empty Sprite (optional) Sprite used for blank space.
• Set to None for minimal digits (e.g., display 1 as 1).
• Assign the 0 sprite (or any pad glyph) to show zero-padded numbers (e.g., 001).

Scene Setup

A parent GameObject containing one child per digit slot (e.g., 3 children to display up to 999).

scene setup

Works with:
- 2D Sprites: SpriteRenderer
- UI: UnityEngine.UI.Image

Action Setup

A Sprite List (0–9) used to render each digit.

scene setup

Try it out: Download Sprite Numbers

Behavior & Limits

  • Max digits = number of children under Digits Parent. Extra digits are truncated.
  • Negative values / decimals: not supported - only digits 0–9 are drawn.
  • Zero-padding: use Empty Sprite = 0 sprite to display leading zeros.

Tips

  • Ordering: Children are read left→right by hierarchy index.
  • Spacing: Use Layout Groups (UI) or evenly spaced positions (world sprites).
  • Performance: The action caches digit references per parent for efficiency.
  • UI Raycasts: Disable Raycast Target on Images if digits should not block clicks.
  • Sorting: Adjust sorting layers/orders for SpriteRenderer digits.

Common Pitfalls

  • Fewer than 10 sprites: causes an error; supply all digits 0–9.
  • Too few children: the number will be truncated.
  • Minus or decimal values: not displayed.
  • Left alignment & Empty Sprite: left alignment only applies if Empty Sprite is None.

Error Messages

“Number Sprites must contain 10 sprites: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9.”
→ Check your Number Sprites list to ensure all ten digits are included.