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
  • What is a Behaviour?
  • General Uses for Behaviour Types
  • Add a Behavior to an Object

Was this helpful?

  1. Game Maker
  2. Docs

Behaviours

A behaviour is a logic bundle that controls an object's actions so you can quickly build custom gameplay with no code.

PreviousMessagesNextNPC - AI Pawns

Last updated 9 months ago

Was this helpful?

Plant, Button, Light, Visual FX behaviours switched to be components in Game Maker 0.10 for more interactive use cases.

What is a Behaviour?

Each object may have ONE behaviour

A behaviour is a bundle of logic that applies action characteristics and identity tags to an object. This controls how it will function in your Experience and how it will be detected by other objects.

OBJECT LOGIC

Behaviours relate to object or Experience actions. An object may have only ONE.

Components relate to player actions. An object may have one of each type.

Behaviours allow you to quickly build dynamic interactions between objects, with many parameters that can be customised to create unique gameplay. No coding experience is needed!

Examples:

Healer chases and heals an object with a specific tag that needs health.

Melee Enemy chases and attacks a specific tag.

Predator chases and attacks Prey as food, which flees Predator and seeks Plant as food.

A Button can be set up to open a Door when players interact with it.

Timed Events can trigger Weather Switcher to change the time of day, sky colours, clouds, stars, etc. in a preset cycle or based on player actions.

General Uses for Behaviour Types

The behaviour groupings below are how they're often used. However, Farmer behaviour simply allows an object to randomly remove other objects in its path from the game. Think outside the box based on what behaviours can do, and you'll dream up amazing custom interactive play in no time!

Tip: You can select multiple objects and change the same parameters simultaneously.

No behaviour applied: The object can be a prop or be interactive if Components are applied.

NPCs

An NPC is usually a person, creature, etc. When this type of behaviour is applied to an object, properties are included to create interactive potential:

Modify object tags and the tags their behaviours are set to detect for custom interactions.

Behaviours

Citizen: Passive walking object, flees Hostile tag by default.

Farmer: Passive walking object, harvests Plant tag and flees Hostile tag by default.

Melee Enemy: Chases and attacks Avatar tag by default. Has Hostile tag by default.

Healer: Restores health. By default it flees Hostile and seeks Friendly and Avatar tags.

Plant: Prey and Farmer seek its default Plant tag. No death visual effects when "killed."

Predator: Chases and attacks Prey and Avatar tags and has Hostile tag by default.

Prey: Passive walking object that seeks Plant tag and flees Hostile tag by default.

Soldier: Passive walking object that attacks when it is attacked or detects a Hostile tag.

CUSTOM INTERACTIONS

Examples:

Experience Management

Animated Decoration: Plays specified animations, each followed by a message.

Actor Property Switcher: Change physics of objects in range during play.

Message Broadcaster: Precisely control how to send a message, can repeat forever.

Timed Events: Sends messages after parent and sub-event timers; linear logic, loops.

Player Engagement

Asker: Pop up box posing a question with 4 answer options that each send a message.

Button: Sends a message upon interaction.

Crowd Event: Emotes or messages reach a collaborative goal; success or fail messages.

STREAMING BEHAVIOURS

Uploading custom content for use with Video and Audio Streaming behaviours is currently limited to The Sandbox and select partners. These behaviours are in development for widespread public use.

Experience Ambience/Feel

Post Process Effects: Visual modifier for the camera with various effects to customise.

Weather Switcher: Changes environmental ambience (sun, stars, clouds, etc).

Add or Destroy Blocks, Assets & Avatars

Asset Spawner: Spawns a specified asset (can offset).

Replace Asset: Switch an asset to a different asset.

Multi: Spawns a specified block in a defined space (3x3 or larger) around the object.

Void: Destroys specified blocks, assets, or avatars within a defined space.

Motion-Based

Bird: Flies clockwise in a circle. Randomise movement with height and width ranges.

Basic Platform: Moves back and forth in any direction, can face the direction of motion.

Door: Plays door animations, allows entry; rotates 90 degrees and back at its pivot point.

Add a Behavior to an Object

One behaviour may be applied to an object to control its actions. Many Components can be applied to an object to make it more interactive.

  1. Left click to select an object. This will open the Properties Panel on the right side of the screen.

  1. Beneath Attributes, click on the Behaviour field where it says NONE or displays the currently applied behaviour.

  1. A window named Select Behaviour will pop up with available options. In this example, we’ll choose the Soldier behaviour. The Select Behaviour window will close, and the chosen behaviour will now appear in the Properties Panel along with its default settings.

In our Soldier behaviour example, default logic is automatically added, including:

  • the Patrol Zone of the entity

  • the Walk Speed, Run Speed, Attack Damage and Attack Speed

  • Tags to Attack is set as Hostile

  • a Health Component which allows the soldier to receive damage if attacked

  • tags so other objects with can detect it with their behaviours

  1. Click the Edit Logic button to see the full Behaviour & Component Parameters for any behaviour and components applied to the object. Here you can see how the object will work in your Experience and customise parameters such as Walk Speed, Tags to Attack, Message sent on death, etc. You can also scroll to the bottom of the object's properties and change its identity tags so it will be detected specific to your game's mechanics. Test your logic frequently by presssing the TAB key to toggle on and off Play mode.

If you need to go back to the default view of the Properties Panel, click the X next to Logic at the top. Your settings will not be lost.

Type
Behaviour
Performance
Max Amt
Perf in Scope

Movement

Bird

Medium

61
null

Movement

Door

null
null

Movement

Advanced Platform

null
null

Movement

Projectile

null
null

Movement

Basic Platform

null
null

null
null

null
null

null
null

Tips: Press CTRL+D to duplicate custom objects or groups of objects. Create if you must build with them repeatedly or want to spawn them during live gameplay.

identity tags, which allow other objects to detect it

tags to detect on nearby objects and respond to (flee, attack, heal, food, or gather)

Create barbarians to attack Soldiers. Apply Melee Enemy behaviour with Tags to Attack set as Soldier. Apply Soldier behaviour to objects (includes Soldier tag).

Create volunteers to remove garbage. Apply Farmer behaviour with Gathering Tags set as Trash. Apply Plant behaviour to various objects, adding the Tag Trash.

Click any object to open the Properties Panel.
Behaviour details are located in the Properties Panel under Attributes.
The behaviour you select is added to object in the Properties Panel.
Edit the object's behaviour, components, and tags in the Properties Panel
Click Edit Logic to inspect and customise the object's behaviour and components
Click the X at the top left to go back to the default Properties Panel view
📖
🏷️
🎯
⚔️
🗑️
#presets