🪙NFTs / Tokens
NOTE: The creator portal is in Alpha and only avaliable to specific developers, please talk to your Yuga representative if you have a need to access this.
The ODK Token System provides a unified way to track and synchronize player progress, rewards, achievements, and quests across the blockchain and experience.
Tokens can be used for persistent state, with each token type having a specific purpose and behavior.
🔍 What Is a Token?
In the context of ODK, a token is an on-chain data object that represents something the player owns.
Token are:
Minted and granted via the Creator Portal
Stored in the player’s wallet
Used to trigger or gate gameplay systems
Synced in real-time between web, blockchain, and in-game logic
All tokens follow a consistent format for their Token ID:
<ChainID>:<ContractAddress>:<TokenID>Example:
33139:0x1122334455667788991122334455667788991100:333139
Chain ID (e.g. APECHAIN)
0x...
Contract address for your experience
3
Unique Token ID
🧱 Supported Token Types
Each token is defined by its type field in metadata, which determines how it is handled in-game. This type is also used by the TokenHandlers map on the player wallet to route token logic.
quest
Sequential multi-task experiences with reward support (See: ODK Quests)
achievement / badge
Recognitions of completion, progress, or milestones
image
Selfie/image tokens — used for storing screenshots or custom UGC
item
Inventory items (experimental or project-specific)
custom
Any developer-defined use case (requires custom TokenHandler)
Each type can have its own UI, reward logic, and flow triggers.
🛠 Where Tokens Fit in Your Project
Tokens can:
Start quest flows (by triggering
BP_ODK_TaskFlow)Unlock achievements or badges
Be displayed in user profiles or overlays
Gate access to in-game systems or areas
Be granted via Blueprint, server-side logic, or web interfaces
📜 Quest Tokens – Multi-step task sequences with XP and rewards
🏆 Achievement Tokens – One-time accomplishments or stats
🎖️ Badge Tokens – Visual trophies or collectibles
🖼️ Image Tokens – Player-submitted images (e.g. selfies, UGC)
⚙️ Custom Token Types – Extending the system for new behaviors
Last updated