🪙 Token Schema
Defines collectible game tokens that grant items, buffs, currency, or trigger events.
✅ Field Rules & Accepted Values
| Field | Type | Required | Notes |
|---|---|---|---|
| id | string | ✅ Yes | Must be unique across all tokens |
| name | string | ✅ Yes | Used in UI and logs |
| type | enum | ✅ Yes | Only accepts values from token type list below |
| value | number | ❌ No | Required for health, currency, xp_boost, damage_boost |
| grants | string | ❌ No | Required for ability_grant, must match abilities schema |
| sprite | string | ❌ No | Optional image asset path |
| levelId | number | ❌ No | If omitted, token is global |
| description | string | ❌ No | Optional display text |
| duration | number | ❌ No | Only for timed buffs (in seconds) |
| hidden | boolean | ❌ No | If true, must be revealed via logic |