Skip to content

📦 Rarity Presentation

Defines how rarity values are presented in UI by mapping numeric values to display names and colors.

🎯 Purpose

Provide a presentation layer for converting rarity values into user-facing labels and colors.

🧩 What Lives Here

  • RarityTheme → abstract ScriptableObject for name and color lookup
  • DefaultRarityTheme → default implementation with common rarity tiers
  • RarityThemeUtil → helper methods for retrieving name and color

⚠️ Important Notes

  • This is a presentation-only layer
  • It does not affect gameplay logic or rarity calculation
  • It does not bind to services or control update timing

🧠 Usage Guidance

Theme abstraction

Rarity values are translated through a theme that defines how they are displayed.

Default behaviour

Default themes provide mappings for common rarity tiers.

If no mapping is found, fallback values may be used.

Utilities

Helper methods provide null-safe access to rarity name and color values.

Runtime flexibility

Themes may be swapped at runtime to change presentation without affecting gameplay systems.

🚫 Not for Production Use

This folder does not:

  • Define rarity values or progression
  • Affect gameplay balance
  • Bind to inventory services or containers
  • Control UI refresh behaviour