Cosmetics, Economy & Loot System

[Ecliptorhizes]

Cosmetics, Economy & Loot System

A full system for players to customize their characters, earn coins from winning fights, and unlock cosmetics through loot boxes or direct purchase.

---

Overview

Players earn in-game coins by winning 1v1 fights. The more wins their opponent has, the higher the reward. Coins can be spent on loot boxes of different rarities, or players can buy coins directly to skip the grind. Unlocked items (weapons, emotes, clothes, music) are equipped in the Cosmetics menu.

---

Rarity System

Tier	Name
1	Common
2	Rare
3	Super Rare
4	Epic
5	Grand
6	Mythic
7	Magnificent
8	Legendary

Items can be: Characters, Weapons, Emotes, Clothes, Music.

---

Economy

Earning Coins

• Win a 1v1 fight → earn coins
• Formula: Base reward + (opponent's wins × multiplier)
• Beating a well-known fighter (high wins) = higher reward

Spending Coins

• Loot boxes – Buy a loot box by rarity (e.g. Epic loot box). Receive a random item of that rarity (weapon, emote, clothes, etc.)
• Coin packs – Buy coins with Robux to skip grinding

---

Shop (Main Menu)

• New Shop button in the main menu
• View coin balance
• Purchase loot boxes with coins (Common, Rare, Epic, etc.)
• Purchase coin packs with Robux

---

Cosmetics Menu

• Character list (unlocked only)
• Per-character customization:
  • Weapon designs
  • Emotes
  • Clothes
• Unlocked items shown with rarity styling
• Locked items grayed out
• Equip and save selections

---

Implementation Status

• Data structure (Rarity enum, CosmeticItem types, ItemRegistry)
• Profile extension (coins, wins, unlockedItems, equippedCosmetics)
• EconomyService (coins, wins, victory rewards)
• ShopService (loot boxes, coin purchase)
• CosmeticsService (equip, unlock checks)
• Shop UI
• Full Cosmetics UI
• Victory reward integration with combat

---

Work in progress – feedback welcome.