🪙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:3

Component	Description
33139	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.

Type	Purpose
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