search

🏵️Creating a Badge token

A Badge Token is a simple on-chain collectible or reward that represents an achievement, status, or cosmetic marker for a player. Unlike quests or tasks, it doesn’t track progress or drive gameplay — it's often used for visual trophies, event attendance, or milestone recognition.

At the time of writing, the Creator Portal doesn’t have a dedicated “Badge” template — so you’ll start with an Image template and update the metadata manually.

hashtag
🔹 1. Create a New Badge Token

  • Click “Define New Object”

  • Select your experience from the dropdown

  • Choose the “Image” template (this is used as a base to define a badge)

You’ll now see a basic definition form.

hashtag
🔹 2. Fill Out the Initial Metadata Form

🏷️ Required Fields:

Field
Description

name

Display name of the badge

description

Short description of what the badge is

image

The display icon for the badge

After filling out the form you will be taken to the metadata output.

We need to define this token as a badge. The image template does not contain a type field:

{
  "name": "Badge name",
  "description": "This is a badge",
  "image": "https://image.url"
}

hashtag
🔹 3. Add the "type": "badge" Field

Add the line "type": "badge", (remembering to include the ,) to the metadata

🧾 Final Badge Token Metadata:

📌 Why this matters: The type field tells the in-game wallet and TokenHandlers how to process this token. Without it, the badge will not trigger the correct logic or appear in badge-specific views.

hashtag
🔹 4. Set Price & Transferability

Before minting:

  • Price → Set to 0 for development and testing

  • Transferable:

    • ✅ True for dev/debug (allows deletion/resets)

    • 🚫 False for production (prevents trading badge ownership)

hashtag
🔹 5. Mint the Token

After saving the metadata:

  • Click “Mint”

You’ll return to the Creator dashboard and see the generated Token ID, in this format:

Example:

hashtag
🔹 6. Preview & Access Metadata

  • Click the badge’s image on the dashboard to review metadata

  • You can update metadata at any time using the "Update Metadata" button

The badge token is now ready to be granted via Blueprint or automatically in-game using a Task Flow or Token Handler setup.

PreviousCreating a Quest tokenNextToken Handlers

Last updated