Currency System

​

1. Physical Currency (Default)

​

Characteristics

• Stored as items inside player inventory
• Consumes inventory space
• Can be dropped, traded, looted, or stolen
• Visible directly in the inventory UI
• Behaves like any other item (weight, stack limits, etc.)
• Supports multi-denomination via separate item types

​

Best For

• Survival/RPG games where items have physical presence
• Games with weight/encumbrance mechanics
• Systems where thieves, loss, or dropping money is intended
• Worlds where gold should feel tangible

​

Setup

1. Go to your PlayerProfile component in your player controller.
2. Make sure Physical Currency is selected
3. Set a reference to your physical coin item and then set the tag (Items.Currency for example)

​

2. Virtual Currency

​

Characteristics

• No inventory slots used
• Cannot be dropped or stolen
• Easy to save/load (via ISaveable integration)
• Supports multi-denomination display (e.g., “1g 3s 18c”)
• Eliminates bag clutter and change-making logic
• Works well with UI-driven shop systems

​

Multi-Denomination Conversion Example

TotalCoins = 1,318

Gold   = TotalCoins / 10,000       → 1
Silver = (TotalCoins % 10,000) / 100 → 3
Copper = TotalCoins % 100            → 18

Result: "1g 3s 18c"

​

Best For

• MMO-style economies
• Games prioritizing clean UI and simple management
• Systems with heavy trading or automated markets
• Mobile-friendly experiences

​

Setup

1. Go to your PlayerProfile component in your player controller.
2. Make sure Virtual Currency is selected
3. Add the PlayerCurrency component to your player controller
4. Set a reference to your physical coin item and then set the tag (Items.Currency for example)

​

Currency Mode Comparison