LogoLogo
GeneralAccountsPlayersOwnersCreatorsThe Sandbox Website
Creators
Creators
  • 🎆Welcome to the Creator Portal
  • 🟦Learn Creator Basics
    • 🟦Scale & LAND Use
    • 🟦Assets & Equipment
    • 🟦Avatars & Character
    • 🟦Look & Feel
    • 🟦Logic & Gameplay
    • ❓FAQs: Gameplay
    • ❓FAQs: Assets
    • 🧙‍♂️Begin Game Maker (Video Series)
  • The Sandbox Creators Forum
  • The Sandbox DAO
  • 🪙Monetisation
  • Game Maker
    • ✨Create Experiences
    • 🔰Beginners
      • Play/Test
      • Build with Blocks
      • Place Assets
      • Set Object Actions
      • Trigger Logic
      • Craft Quests
      • Set Up Mechanics
      • Build Multiplayer Games
    • Game Maker 0.11 Update
    • 0.11 Upgrade Guide
    • 📖Docs
      • Navigate Game Maker Home
      • Manage Experiences
      • Controls & Shortcuts
      • Build Menus
        • Top Bar
          • Gameplay
        • Side Bar
          • Hierarchy
          • Presets
        • Library & Quick Access Bar
        • Grid System & Snap Tool
        • Properties Panel
      • Using Blocks
      • Using Assets & Objects
        • Behaviour & Component Parameters
        • Tags
        • Messages
      • Behaviours
        • NPC - AI Pawns
          • 🔵Citizen
          • 🔵Farmer
          • 🔵Healer
          • 🔵Melee Enemy
          • 🔵Predator
          • 🔵Prey
          • 🔵Soldier
          • 🔴Friendly NPC
        • Movement
          • 🟡Door
          • 🟡Bird
          • 🔴Basic Platform
          • 🔴Advanced Platform
          • 🔴Projectile
          • 🔴Rotate
        • Basic Logic
          • 🔵Message Broadcaster
          • 🟢Combination Code
          • 🟢Asker
          • 🟢Timed Events
          • 🟡Crowd Event
          • 🔴Spawn Point & Avatar's Feature
        • Modifiers
          • 🔵Actor Property Switcher
          • 🔵Multi
          • 🔵Void
          • 🟢Asset Spawner
          • 🟢Replace Asset
        • Visual
          • 🟢Post Process Effects
          • 🟡Weather Switcher
          • 🟡Animated Decoration
      • Components
        • Actions
          • 🟢Climbable
          • 🟢Avatar Teleport
          • 🟢Collectable
          • 🟢Drop
          • 🟢Slide
          • 🟢Speaker
          • 🔴Pickable
        • Triggers
          • 🟢Plant
          • 🟢Switch
          • 🟢Button
          • 🟢Trigger Volume
        • Status
          • 🟢Toggle
          • 🟢Power Up
          • 🔴Avatar Checkpoint
          • 🔴Health
        • Gameplay
          • 🔵Defeat
          • 🔵Victory
          • 🔴Raycast
        • NFT
          • 🟢NFT Sensor
          • 🟢NFT Image Display
          • 🟢Image Display
          • 🔴NFT Details Display
        • Display
          • 🟢Indicator
          • 🟢Rarity VFX
          • 🟡Visual FX
          • 🟡Light
        • Audio
          • 🟡Play Sound
      • Objectives
      • Game Rules
        • Math
        • Time
        • Comparisons
        • Replace Variable Values
        • Game Screen
        • Triggers
        • Events
      • Build Singleplayer & Multiplayer Logic
      • Quality Guidelines
        • Optimisation
        • Testing
        • Playability
      • Templates
    • 📑Creative Guides
      • 📗Game Rules Guide
        • Point Race
        • Collect Points
        • Time Trial
        • Combo
        • Hunger
        • Poison
        • Shop
      • ⚙️Logic Guide
        • Abilities
        • Equipment Based Logic - On Equip / NFT Sensor
        • Doors & Chests
        • Collectibles
        • Text, Quests & Icons
        • Platforms
        • Victory & Defeat
        • Miscellaneous
        • NFT Inspect
        • Fighting
      • 🏞️Experience Guide
        • Tower Defense
        • Horror / Backrooms
        • Solo Platforming
        • Social Platforming
        • Resource Management
        • Cooking Simulator
        • Survival
        • Action / Adventure
        • Night Clubs & Concerts
        • Virtual Home & Architecture
        • NFT Gallery / In-Game Shop
        • Puzzle Games
        • Social Hubs
        • Simulation
      • 🎲Experience Design Techniques
        • Narrative Design
          • Worldbuilding
          • Storyboard
          • Dialogue
        • Art Design
          • Experience Art Concept
          • Asset Curation
          • Blockout Aesthetics
          • Detailing / Dressing
        • 3D Spatial Layout
          • Rough Base Map
          • Greyboxing / Blockout
        • Game Design
          • Ramp of Difficulty
          • Risk & Reward
          • Game Loops & Decisions
    • 🎬Game Production Guide
      • 🟥Concept
      • 🟧Blockout
      • 🟨Logic
      • 🟩Art
      • 🟦Quality Assurance
      • 🟪Polish
      • ⬜Marketing
    • 🧰Publish Experiences
      • Experience Manager
        • Experience Analytics
        • 🧰Experience Page
          • Content Guide
          • Marketing
          • Create an Experience Trailer
          • Player Engagement
        • Map Location
        • Asset Review
        • Access Restrictions
      • Collaborating With Third Parties
      • ❓FAQs: Experience Publishing
    • 🕘Version Notes & Changelogs
      • Game Maker 0.11
        • ❗0.11 Upgrade Guide
      • Game Maker 0.10
      • Game Maker 0.9
      • Game Maker 0.8
      • Game Maker 0.7
    • ❓FAQs: Game Maker
  • VoxEdit
    • ✨Create Assets
    • 🔰Beginners
    • 📖Docs
      • Navigate VoxEdit Home
      • Controls & Shortcuts
      • Panels & Custom Layouts
      • Block
      • Modeler
        • Use Modes & Tools Together
        • Set the Pivot Point
        • Create Frame Assets
      • Animator
        • Build a Rig
        • Create an Animated Asset
        • Use Inverse Kinematics
      • Templates
      • Quality Guidelines
        • Asset Types & Collisions
        • Asset Scale
        • Node Efficiency
        • Pivot Point & Alignment
        • Animation
        • Visual Quality
        • Asset Name & Description
        • Manage Files & Folders
    • 📑Creative Guides
      • 🧍Asset Guide
        • Structures & Landmarks
          • Basic Building: No Entry
          • Animated Building: No Entry
          • Unanimated Building: Player Entry
          • Landmark
          • Building Facade
          • Structure Component Parts
          • Modular Architecture
        • Humanoids & Animals
        • Vehicles
        • Equipment
        • Art: Statues, Paintings
          • Animated Art Screens
          • Statues
          • Kinetic Art Sculptures
          • Paintings
          • Performance Art
        • Furniture
        • Platforms
        • Doors, Gates, and Windows
          • Multi Design Door Asset
        • Chests & Other Animated Interactions
        • Plants, Trees
        • Objects, Machines
        • Signs & Text
        • Obstacles
        • Create Frame Assets
      • 🎨Art Techniques
        • Asset References
        • 3D Design
          • 🧹Need to Simplify?
          • ✂️Trim All Volumes
          • 🟢Optimize with Texture
          • 🟢Curved Edges: Blocky Style
          • 🟡Break Down Objects
          • 🟡Create Smooth Angled Lines
          • 🟡Circular Shapes: Cross Technique
        • Colour, Texture & Depth
          • 🪅Colour Choice & Strategy
          • 🧱Textures & Materials
    • 🧰Upload Assets to Workspaces
    • 🌟Mint & List Assets to Sell
    • 🕘Changelogs
    • 🔓Open Source Assets
    • ❓FAQs: VoxEdit
  • Creators Program
    • 🏗️Builders' Challenge
      • Rules & Eligibility
      • Earnings & Rewards
      • How to Succeed in the Builders' Challenge
      • ❓FAQs: Builders' Challenge
    • ℹ️Creator Contests
    • 🏆Game Jams
      • Rules & Guidelines
      • Judges & Voting
      • Explore Past Winners
      • ❓FAQs: Game Jams
    • 🏆VoxEdit Contests
      • Rules & Guidelines
      • Judges & Voting
      • Explore Past Winners
      • ❓FAQs: Voxel Art Contests
  • General
    • 📚The Sandbox Documentation
    • 🔄Play, Create & Earn
    • 🗺️Map
    • 🛒Marketplace
    • 🗣️Discord Community
    • 🔗Social Networks, News & Blogs
    • The Sandbox Linktree
    • ❓Help & Contact
Powered by GitBook
LogoLogo

INFO

  • Discord
  • Social, News & Blogs
  • Service Status

PLAY

  • Events
  • Map
  • Avatar

CREATE

  • VoxEdit
  • Game Maker
  • Contests

OWN

  • SAND
  • LAND
  • Staking

Copyright ©The Sandbox. All Rights Reserved.

On this page
  • NFT Sensor [MP]
  • Common Uses
  • Communications
  • Applying NFT Requirements
  • Parameter Notes
  • Potential Use Cases for Varied Gameplay & Monetisation
  • Open a Door for All Players
  • Teleport to VIP Areas & Gameplay
  • Teleport Players to Create Teams
  • Gain a Competitive Edge
  • Cause Multiplayer Mayhem
  • Enjoy Bonus Game Mechanics

Was this helpful?

  1. Game Maker
  2. Docs
  3. Components
  4. NFT

NFT Sensor

New in GM 0.9. GM 0.10 update: add multiple NFTs/collections. GM 0.11 update: new "Equipped" toggle.

PreviousNFTNextNFT Image Display

Last updated 2 months ago

Was this helpful?

COPY/PASTE PARAMETERS

New in GM 0.11! Right click on a behaviour or component to copy. Then open an object, add the same behaviour or component, and right click it to paste identical parameter settings.

Build Singleplayer & Multiplayer Logic - about [SP] or [MP] behaviours or components

The NFT Sensor Component is a powerful tool to detect one or more NFTs in the player's wallet and send a success or failure message to create a variety of results.

There are two methods to detect NFTs:

  • Specify Sandbox NFTs (using the Asset URL from The Sandbox website)

  • Select NFT collections (and in 0.11, you can require certain traits within a collection for success)

Use the condition toggle to require ownership of all NFTs/collections specified or at least one of them.

Send a message to trigger various logic to reward NFT holders.

Common Uses

Monetise premium content in your Experience by gating access to it through NFT ownership.

Grant holders of the NFTs you specify special access to:

  • Exclusive areas of an Experience

  • Unlocked quests or narratives

  • Bonus Power Ups

  • Perks via game mechanics created in Game Rules

  • and more

Communications

Input: multiple messages

Output: success message or fail message (customisable)

Applying NFT Requirements

For the first version of the NFT Sensor component, you may only have one NFT and one Collection as the success/failure criteria using and/or logic.

Add an NFT Token ID

  1. Click on NFT Token ID in the NFT Sensor Component. A window will open where you must add an Asset URL.

  2. Return to Game Maker and paste the URL into the Asset URL box. Click Validate and then Continue.

You can add more and set the AND/OR condition as you wish.

Add a Collection

INFORM PLAYERS TO EQUIP AVATARS

Simply owning an Avatar from a collection integrated with NFT Sensor will not trigger the success message. The avatar must be equipped when triggering the NFT Sensor.

Use the dropdown menu to select an existing Avatar collection on The Sandbox Marketplace.

For the first version of the NFT Sensor component, available collections only include Avatars on The Sandbox Marketplace.

Parameter Notes

New parameters in 0.11 allow you to:

  • Add a purpose and description (which does not affect game logic, but helps you keep track of your game design intent)

  • Only trigger a success message if one or more required NFTs are equipped

  • Add a collection and limit the sensor success only to specified traits

  • AND/OR condition can apply to multiple individual NFT token IDs and multiple collections (or collections with trait filters)

This is by no means an exhaustive list of what's possible with the NFT Sensor component. It's merely a starting point. Keep visiting the Creator Portal as we document new methods of leveraging the NFT Sensor for creative gameplay variations and monetisation.

Open a Door for All Players

Teleport to VIP Areas & Gameplay

Teleport Players to Create Teams

Gain a Competitive Edge

Cause Multiplayer Mayhem

Let NFT holders:

Enjoy Bonus Game Mechanics

While [SP] and [MP] logic layers can NOT communicate with each other, they can both communicate with the Game Rules system!

As long as a player triggers the message to be sent (even if it's the start of a long chain of logic), the player source will be included in the message so the Game Rules system can modify only that player's local variable. Use this to give NFT holders bonus currency for your game world's shops, extra points, bonus time, and more.

SECRET BENEFITS FOR NFT HOLDERS To give players access to secret areas, hidden quests, and other bonuses for owning a specified NFT, use the component to move players who trigger the success message with the [MP] NFT Sensor component.

NFT Sensor [MP]

Require that the player has specified NFTs equipped ()

See below for logic that may be used to create limited access gameplay for NFT holders who trigger the success message.

Open an Asset's page on The Sandbox website (from or by ) and copy the URL. See the image below for an example.

Use your to inform players to equip their Avatars before they start the Experience. It is currently not possible to change Avatars and resume play.

Potential Use Cases for Varied Gameplay & Monetisation

Trigger a [MP] behaviour so the NFT holder can help all players in the Experience get through. Require a different NFT to open each door in a maze for a fun community challenge.

Trigger the new [MP] component to transport the NFT holder to an exclusive area. There, players can trigger extra , , gameplay mechanics built from , and more!

Use the component to split players into different parts of an Experience with a timed challenge using the system or behaviour to see which team can finish first! Create a different theme or art style for each team's playable space to appeal to different player interests. Even better, match the theme of the space with the NFT they need to own.

Spawn a item for a , resources needed to make progress in your gameplay, or equipment to enhance the player's stats. To ensure that only the NFT holder gets these competitive bonuses, teleport them to a secret location to collect these items and then return them to the fray.

In a parkour challenge, you could NFT holders to shortcuts that lead back to the same course they're racing with other players.

Change the game world through the , (camera), , and behaviours.

Trigger to make items appear that anyone can use.

Turn on and off and with the component.

Progress the meter and give all players or those in range fun .

Trigger that apply only to the NFT holder by using (L) in Rules.

📖
🟢
🧠
⛈️
Teleport
see equipment use cases
your inventory
searching the Marketplace
Experience Page
Door
Teleport
quests
Power Ups
Game Rules
Teleport
Game Rules
Crowd Event
Collectable
Power Up
teleport
Actor Property Switcher
Post Process Effects
Visual FX
Weather Switcher
Asset Spawners
Collectable
Power Up
Basic
Advanced Platforms
Toggle Behaviour
Potential Use Cases for Monetisation

If the player does not have all of the required NFTs in their wallet, a window can be set to pop up and show which NFT(s) are required to trigger a success message, including a Marketplace link.

Note: The window does not filter out which NFTs the player already owns.

Crowd Event
Game Rules

local variables
trailing Visual FX
Find the Asset URL on The Sandbox website
In the image above, the NFT Sensor component's success message triggers a popup window created in Rules to inform the player of the perks gained from holding the required NFT. It also triggers a Rule to add 150 to the player's mechanic. The door opens for all players, but the one who opens it gets the bonus perks in this logic setup.
Play Coins