🪙 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