🧙‍♂️Built-in Content

Configs

Countdown

A Countdown Config functions as a countdown timer and is utilized to trigger a node after a specified period. It is comparable to the Delay Modifier; however, Countdown Config offers additional functionality, such as the ability to halt the countdown midway or detect if the countdown has started, been intentionally stopped, or ended.

To configure, initiate the “Start” Effect, which begins the countdown.

Upon completion of the countdown, the “State Changed to: Expired” trigger will activate.

Causes

State Changed to

A listener node that activates when the specified condition is met.

Condition	Stopped: Indicates that the timer has been intentionally halted by invoking the “Stop” Cause. Running: Indicates that the countdown timer has commenced, triggered by the “Start” Cause. Expired: Indicates that the countdown has reached zero.

Value Changed

This triggers whenever there is a change in the countdown.

Interval (seconds)	Defines the time interval at which the output node triggers. For example, if set to 1 second in a 30-second countdown, the node will trigger every 1 second until the countdown completes. Adjusting this value controls how frequently the node executes during the set duration.

Effects

Start

Call this to start the countdown.

Stop

Call this to stop the countdown.

If State is

An if-condition to check if the timer is running, stopped, or has ended.

Condition	Stopped: Indicates that the timer has been intentionally halted by invoking the “Stop” Cause. Running: Indicates that the countdown timer has commenced, triggered by the “Start” Cause. Expired: Indicates that the countdown has reached zero.

Traits

Length in Seconds

The length of the countdown timer.

Datum

A Datum Config serves as a variable—a container for holding a piece of information. It functions like a small storage box for values, commonly used for applications such as displaying scores, life points, countdown timers, and more.

Assigning the Datum in the Datum Viewer’s Datum Dropdown (as shown in the image below) automatically updates the Datum Viewer’s UI display based on the Datum’s CurrentValue.

Causes

Updated

The “Updated” Cause is triggered each time the “Current Value” Trait changes, making it useful for monitoring the latest value stored in the Datum.​

Effects

Modify

Adjusts specific attributes of a Datum, such as "Is Persistent," "Initial Value," and "Current Value."

Traits	Is Persistent: Sets the "Is Persistent" Trait if it will retain the value. Initial Value: Sets the "Initial Value" of the Datum Traits. Current Value: Set the "Current Value" of the Datum Traits.

Is Persistent

Toggles the persistence of the Datum. When checked, the Datum retains its value across sessions.

Val. Bool	The Datum's value will be retained across sessions, preserving its state or not be retained.

Initial Value

Specifies the starting value of the Datum, applied when the Datum is first created or reset.

Val. Float	Set the “Initial Value” Trait for the Datum

Current Value

Represents the active value of the Datum, which can be updated as needed during a session

Val. Float	Set the "Current Value" Trait for the Datum.

Set Datum

Replaces the “Current Value” of the existing Datum with the value of the specified Datum. When this node is called, it will update the current Datum to match the value of the assigned Datum, effectively setting the new “Current Value” to the specified one.

Datum	The Datum that will provide the new value to replace the current value of the target datum.

Set Value

Set the "Current Value" Trait of the Datum.

Value	The specified value to be set as the “Current Value.”

Reset Value

Resets the Datum’s "Current Value".

Add Datum

Increases the “Current Value” of the Datum by the “Current Value” retrieved from another Datum. When this node is called, it takes the “Current Value” from the specified Datum and adds it to the target Datum’s “Current Value”.

Datum	The Datum whose value will be added from the current Datum’s “Current Value”.

Add Value

Increments the “Current Value” by a specified amount. For example, if the Value is set to 2, calling this node will add 2 points to the current value.

Value	Specified amount to increase.

Subtract Datum

Decreases the “Current Value” of the Datum by the “Current Value” retrieved from another Datum. When this node is called, it takes the “Current Value” from the specified Datum and subtracts it from the target Datum’s “Current Value”.

Datum	The Datum whose “Current Value” will be added to the target Datum’s “Current Value”.

Subtract Value

Decrements the “Current Value” by a specified amount. For example, if the Value is set to 2, calling this node will subtract 2 points to the current value.

Multiply Datum

Multiplies the “Current Value” of the Datum by the “Current Value” retrieved from another Datum. When this node is called, it takes the “Current Value” from the specified Datum and multiplies it with the target Datum’s “Current Value”.

Datum	The Datum whose “Current Value” will be used to multiply the target Datum’s “Current Value”.

Multiply Value

Multiplies the “Current Value” by a specified factor. For example, if the factor is set to 3, calling this node will multiply the current value by 3.

Value	Specified factor to be multiplied.

Divide Datum

Divides the “Current Value” of the Datum by the “Current Value” retrieved from another Datum. When this node is called, it takes the “Current Value” from the specified Datum and divides the target Datum’s “Current Value” by this amount.

Datum	The Datum whose “Current Value” will be used to divide the target Datum’s “Current Value”.

Divide Value

Divides the “Current Value” by a specified divisor. For example, if the divisor is set to 4, calling this node will divide the current value by 4.

Value	Specified divisor to be divided.

If Is Equal To Datum

Compares the "Current Value" of the Datum to the "Current Value" of another specified Datum. When this node is called, it checks if the two values are equal and proceeds based on the result. This can be used to trigger specific actions if the values match.

Datum	The Datum whose "Current Value" will be compared to the target Datum’s "Current Value." This Datum provides the reference value for the equality check.

If Is Equal To Value

An if-condition that compares the “Current Value” of a Datum to a specified value. This node has two output sockets: if the condition is true, the left socket’s connected node is triggered; if false, the right socket’s connected node is activated.

Value	Defines the value to compare against the “Current Value.”

If Is Less Than Datum

Compares the "Current Value" of the Datum to the "Current Value" of another specified Datum. When this node is called, it checks if the current value is less than the specified value and proceeds based on the result. This can be used to trigger specific actions if the target value is lower.

Datum	The Datum whose "Current Value" will be compared to the target Datum’s "Current Value." This Datum provides the reference value for the less-than check.

If Is Less Than Value

An if-condition that checks if the “Current Value” of a Datum is less than a specified value. There are two output sockets: if the condition is true, the left socket’s connected node is triggered; if false, the right socket’s connected node is activated.

Value	Defines the value to compare against the “Current Value.”

If Is Greater Than Datum

Compares the "Current Value" of the Datum to the "Current Value" of another specified Datum. When this node is called, it checks if the current value is greater than the specified value and proceeds based on the result. This can be used to trigger specific actions if the target value is higher.

Datum	The Datum whose "Current Value" will be compared to the target Datum’s "Current Value." This Datum provides the reference value for the greater-than check.

If Is Greater Than Value

An if-condition that checks if the “Current Value” of a Datum is greater than a specified value. This node also has two output sockets: if the condition is true, the left socket’s connected node is triggered; if false, the right socket’s connected node is activated.

Value	Defines the value to compare against the “Current Value.”

Traits

Is Persistent	Determines whether the “Current Value” of the Datum remains unchanged even when the Chapter is reloaded or ended. Enabling this option ensures that the “Current Value” does not reset.
Initial Value	Specifies the starting value of the Datum. The value assigned here serves as the initial value.
Current Value	Represents the current value of the Datum, which can be added, subtracted, multiplied, divided, or compared during runtime.

Group

A Group Config organizes multiple Sparks into a single entity, allowing for collective modification. This is useful when, for example, you need to change the visibility of multiple Sparks with a single action.

Effects

Visible

A checkbox that determines the visibility state of the group. When checked, the group is visible; when unchecked, the group is hidden.

Traits

Group Name

Specify an overall name for the Spark Group. This also displays all of the Spark that are under the Group.

Inventory

An Inventory Spark is used to store Spark names in a list, which is particularly useful for displaying items, quests, and similar content.

To add a Spark to the list, attach a Cause on the desired Spark to the “Inventory Add” Effect of the Inventory Config.

To display the list, link the “Changed” Cause of the Inventory Config to an “Update” Effect of an Inventory Viewer Symbol that exists in a Billboard or a ScreenSpace UI.

The maximum number of Spark names that can be stored in the Inventory Config is determined by its “Maximum Items” Trait. If the list reaches this limit, the oldest Spark is removed as the new one is added, following a FIFO (First In, First Out) approach.

Additionally, the list does not accept duplicates, so adding the same Spark again has no effect.

Causes

Changed

Triggers an event when the inventory has been modified. This node detects changes in the inventory, such as items being added or removed.

Effects

Modify

Modify the Traits of the Inventory Spark

Traits	Maximum Items: Sets the "Maximum Items" Trat for the Inventory Spark
Val. Int	Allows to change the value to increase or decrease the inventory's item limit as needed.

Add

Adds an item to the inventory. This node allows you to specify an item to be added, updating the inventory accordingly.

Remove

Removes a specified item from the inventory. This node lets you designate an item and quantity to be removed.

Clear Clears all items from the inventory. This node removes all items and resets the inventory to an empty state, useful for resetting or starting fresh.

Traits

Maximum Items

Defines the maximum number of items that the inventory can hold. Once this limit is reached, no additional items can be added until space is made available.

Modifiers

A Modifier Config is a built-in configuration that cannot be added or removed in the Configs Panel. It manages Chapter-wide controls and features specific to Behavior, including functions like Blackout, Change Chapter, Comment, Spawn Spark, Debug, Delay, Ember, Exit Book, Random, Chapter Started, Stop Audio Channel, and Toggle.

For more detailed information on Modifiers, refer to the Modifiers page under Behavior Nodes.

Randomizer

A Randomizer Config is used to trigger random output sockets within a node. Start by using the “Generate Value” Effect, as shown in the image below. When called, this Effect randomly selects and triggers an output socket. The number of possible outputs can be adjusted using the “Total Values” Trait.

Causes

No Valid Value

This node activates when all "Valid Values" have been used. This prevents the node from reusing values until it is reset or reconfigured, allowing for a unique selection process that ensures each value is used only once per cycle.

Note: This feature only activates when the Require Unique? Trait is checked.

On Last Valid Value

Triggers when the last remaining unique valid value is selected from the set. This node activates right before all values have been exhausted, allowing for specific actions to be taken when only one value remains.

Note: This feature only activates when the Require Unique option is checked.

Effects

Modify

Allows dynamic modification of the Randomizer’s traits, including "Require Unique", "Auto Reset History", "Total Values", and "Valid Values".

Traits	Require Unique?: Toggles unique selection. If true, each value is chosen only once per cycle; if false, values can repeat. Auto Reset History?: Toggles "Auto Reset History." When enabled, it resets selection history after all values are used. Total Values: Sets the total number of values the Randomizer can choose from. Valid Values: Controls the number of values currently available for selection.
Val. Int	Specified value for setting the "Total Values" and "Valid Values" Traits.
Val. Bool	Toggles the "Require Unique?" and "Auto Reset History? Traits". When checked it is enabled if unchecked it is disabled.

Generate Value

Outputs a randomly selected value from a defined range of options. When this node is used, it picks a value at random from a set determined by the "Total Values" Trait.

Reset History

Allowing the clearing of all previously generated values. Each time the node is used, it selects a new random value based on the current settings.

Set Valid Outputs

Configures the "Valid Values" trait of the Randomizer Spark. Activating this node updates or replaces the current set of "Valid Values" for the Randomizer, defining the range of possible outputs.

Valid Outputs	Sets the "Valid Values" of the current Randomizer.

Traits

Required Unique?	Ensures that each value is selected only once per cycle, preventing repetition until all values have been used. When checked, this enables the "On Last Valid Value" trigger to function.
Auto Reset History?	Automatically resets the selection history when all values have been used, allowing the randomizer to begin a new cycle. This can be useful to restart the sequence without manual intervention.
Total Values	Specifies the total number of possible values the Randomizer can select from. Adjust this to set the range of unique values available for random selection.
Valid Values	Displays the count of values currently available for selection. This number will decrease as values are selected (when "Require Unique" is enabled) and will reset when the "Auto Reset History" option is active or when manually reset

Respawn

The Respawn Config is a built-in configuration that cannot be added or removed. It ensures that if the player falls below ground level, they will respawn based on a specified Threshold Type. For instance, with a Distance Threshold, the player will respawn once they fall a certain distance below the ground zero (sea level) area, preventing infinite falling.

State Machine

A State Machine Config is a specialized Spark that tracks and stores a specific state, operating as a simple system to control a sequence of states using numeric values. Each state is represented by a unique number, and the machine transitions between states according to the Effects called. Think of it as a series of steps or levels, each assigned a number, with specific rules governing movement from one step to the next. The default state value is 0.

The “On State” Cause is triggered when the state changes, and state transitions can be managed using the “Go to State” or “Next or Previous State” commands. Conditional logic can also be implemented by using the “If State is” Effect.

IMPORTANT NOTE: OnState Cause Behavior

The OnState Cause is designed to trigger only when the state ID changes to a different value.

Trigger Conditions:

• State Change: The OnState Cause activates when the state ID transitions from one value to another.

  • Examples:

    • Changing from 0 to 1 or 1 to 0 will trigger the Cause.

• No Trigger for Same State: The OnState Cause will not trigger if the new state ID is the same as the previous state ID.

  • Examples:

    • Changing from 0 to 0, 1 to 1, or 2 to 2 will not trigger the Cause.

Special Case:

• Chapter Start: The OnState = 0 Cause is automatically triggered at the start of the chapter.

  • As shown in the GIF, hitting the play button triggers OnState = 0, which then activates the NPC's Converse node.

  

This behavior ensures that OnState only responds to meaningful state changes while providing an automatic trigger for state 0 at chapter initialization.

Causes

On State

A listener node that triggers when a change in state occurs. Note that it does not trigger at the start of the chapter when the state is initially set to 0.

Effects

Go to State

Sets the current state to a specified value.

State Id	The new value to set as the state.

Next State

Increments the state by 1. For example, if the current state is 2, calling this Effect changes the state to 3.

Previous State

Decrements the state by 1. For example, if the current state is 2, calling this Effect changes the state to 1.

If State is

An if-condition to check if the current state equals the specified State Id. If the condition is met, the output socket triggers the connected node. If not, the output socket does not trigger.

State Id	The value to compare with the current state.

State Machine (Named)

The Named State Machine functions similarly to the default State Machine but allows storing customizable strings instead of the default unmodifiable numbers.

With the Named State Machine, states are explicitly defined by their names in the trait. For example, states such as Idle, Talking, and Interacting can be specified, as shown in the image below.

Additionally, the Current State of the Named State Machine is displayed in the Current State Trait within the Traits Panel, allowing for easy tracking of the active state.

IMPORTANT NOTE: OnState Cause Behavior

The OnState Cause is designed to trigger only when the state ID changes to a different value.

Trigger Conditions:

• State Change: The OnState Cause activates when the state ID transitions from one value to another.

  • Examples:

    • Changing from Idle to Talking or Interacting to Idle will trigger the Cause.

• No Trigger for Same State: The OnState Cause will not trigger if the new state ID is the same as the previous state ID.

  • Examples:

    • Changing from Idle to Idle, Talking to Talking, or Interacting to Interacting will not trigger the Cause.

Special Case:

• Chapter Start: The OnState = 0 Cause (or in our example, the Idle state), is automatically activated at the beginning of the chapter.

  • As shown in the GIF, hitting the play button triggers OnState = 0, which then activates the NPC's Converse node.

This behavior ensures that OnState only responds to meaningful state changes while providing an automatic trigger for initial state at chapter initialization.

Causes

On State

A listener node that triggers when a change in state occurs.

State Name	The string to compare with the current state.

Effects

Go to Named State

Sets the current state to a specified value.

State Name	The new value to set as the state.

Next State

Advances to the next state in the list of states defined in the Named State Machine's state list. For instance, if the current state is Idle, triggering this effect will update the state to Talking.

Previous State

Moves to the previous state in the list of states defined in the Named State Machine's state list. For example, if the current state is Interacting, triggering this effect will update the state to Talking.

If State is Named

An if-condition to check if the current state equals the specified State Name. If the condition is met, the output socket triggers the connected node. If not, the output socket does not trigger.

The Named State Machine is an advanced version of the standard State Machine that allows creators to assign custom names to each state, such as "Idle" or "Interacting," instead of using preset numbers. This makes behavior flows easier to understand, organize, and manage—especially in more complex scenes.

Sun

A Sun Config is a built-in configuration that cannot be added or removed from the Configs Panel. It acts as the main light source, with adjustable settings for Brightness (0 - 100%) and Time of Day (0 - 24 hours) to simulate different lighting conditions throughout the day.

Effects

Modify

Allows for dynamic adjustment of the sun’s traits, including "Brightness" and "Time of Day".

Trait	Brightness: Sets the "Brightness" of the Sun Spark. Time of Day: Sets the "Time of Day" of the Sun Spark.

Traits

Brightness (Pct: 0 -100)	Controls the intensity of sunlight as a percentage. A value of 0 represents complete darkness, while 100 represents full brightness.
Time of Day (Hrs: 0 -24)	Sets the current hour in a 24-hour format, which can influence the position and angle of the sun in the environment. For example, setting this to 9 represents 9 AM, while setting it to 18 represents 6 PM.

Audio

An Audio Spark is used to play sound effects or music. It is added to the Configs Panel, and the “Audio” Effect with the State set to Play is called to start the sound effect.

Effects

Modify

Used to adjust specific traits of the Audio Config Spark.

Trait	Loop Audio: The Loop Audio trait of the Spark, determining whether to replay the audio when it finishes.
Val. Bool	Sets the Loop Audio trait to either true (enabled) or false (disabled).

Audio

An Effect that specifies the audio clip to play, pause, stop.

Clip	The audio clip to be played.
State	Play: Set to Play to start the audio when called. Pause: Set to Pause to temporarily stop the audio. Stop: Set to Stop to halt the audio playback completely.
Volume	The desired playback volume, with a maximum of 1.
Solo	When checked, this stops all other currently playing audio except this one.

Change Audio Channel Trait

This Effect changes the audio channel at runtime when activated.

New Channel	These are the available channels to which the audio can be assigned. Dialog1 Dialog2 Dialog3 Music1 Music2 Music3 SoundFX1 SoundFX2 SoundFX3

Traits

Audio Channel	The designated channel for audio playback.
Loop Audio?	Determines whether the audio will repeat after it finishes playing.

Music (legacy)

Music Sparks function similarly to Audio Sparks, except they are permanently looped and cannot be turned off. This feature is set to be deprecated; it is recommended to use the Audio Spark instead and enable the Loop Audio option to serve as background music.

Skies

A Sky Spark is a built-in Config that cannot be added or removed from the Configs Panel. It controls the appearance and lighting effects of the sky, helping to shape the overall atmosphere in the environment.

Effects

Modify

Trait

Ambient Brightness: Modifies the "Ambient Brightness" trait of the Sky, setting the intensity of ambient light. Ambient from Sky: Enables or disables the "Ambient from Sky" trait, which uses the sky's color and lighting to influence the ambient light. Set to true (enabled) or false (disabled) to toggle this effect. Exposure: Adjusts the Exposure trait of the Sky, influencing the overall light intensity.

Val. Float

Sets the Loop Audio trait to either true (enabled) or false (disabled).

Traits

Ambient Brightness	Modifies the ambient light brightness in the environment. This setting enhances visibility and adjusts the mood by raising or lowering the ambient light intensity.
Ambient from Sky	When enabled, this Trait derives the ambient lighting directly from the sky, creating a more natural and consistent lighting effect that matches the sky’s color and conditions.
Exposure	Adjusts the overall exposure level of the sky. Raising the exposure brightens the scene, while lowering it can create a dimmer, overcast effect.

Entities/Drawables

This video shows you how to use Spark Drawables in Bonfire Builder, including the Drawable Surface, Marker, and Eraser. Learn how to create interactive drawing areas where players can sketch directly in the scene, use virtual markers to draw, and erase with precision. These tools are perfect for creative gameplay, note-taking, or collaborative exercises in your Bonfire experiences.

Drawable Surface

The Drawable Surface is a type of Spark that provides a blank "canvas" for rendering. It can be drawn upon using a Marker Spark.

Tip: Expanding Compatibility with Other Sparks

To enable Sparks other than the Marker Spark to draw on the Drawable Surface, use the following approach:

1. Attach the Marker Spark to the desired Spark.

2. Hide the Marker Spark by setting its Color Trait's alpha value to 0.

3. Ensure the Required Held trait of the Marker Spark is unchecked.

This method allows the attached Spark to interact with the Drawable Surface seamlessly while maintaining visual clarity.

Eraser

The Eraser Spark is used to remove or clear elements drawn by the Marker Spark on the Drawable Surface. It operates by targeting and erasing one continuous stroke or line of the drawn ink at a time, ensuring precise removal. Each erasure action is limited to a single uninterrupted path of ink, making it effective for refining or selectively clearing specific portions of the drawing.

Marker

The Marker Spark is used for drawing on a Drawable Surface. It can be customized by adjusting its Pen Color Trait to produce specific colors and transparency effects. It serves as the primary mechanism for interacting with and modifying the Drawable Surface.

Traits (DrawingEntity)

Pen Color	Defines the color of the Marker Spark's "ink" when drawing on the Drawable Surface.
Pen Size	The size of the stroke.
Distance Between Points	The Distance Between Points parameter determines the spacing between consecutive points that make up the stroke. A lower value results in finer, closely spaced points, producing smoother and more precise curves. Conversely, a higher value increases the spacing, causing the stroke to appear segmented with visible straight lines in curved sections. Adjusting this value allows control over the smoothness and continuity of the stroke. The default value is 0.01.
Require Held	The Require Held setting specifies whether the Marker Spark must be actively held by the player to enable drawing on the Drawable Surface. Checked: The player must grab and hold the Marker for it to draw. In VR, this action corresponds to pressing and holding the grip button on the controller. Unchecked: The Marker Spark will draw on the Drawable Surface automatically, regardless of whether it is being held by the player. This setting allows flexibility in how the Marker Spark interacts with the environment, accommodating different use cases and interaction styles.
Max Drawing Distance	The Max Drawing Distance defines the maximum range at which the marker is rendered on a drawable surface. This setting determines how far the pen can draw. Adjusting this value helps control visibility, optimize performance, and refine the drawing experience on the drawable surface. The default value is 0.03.

Entities/Accessories

Watch Band

Commonly paired with the Watch Face, the Watch Band is an Entity Spark that functions as the strap, visually completing the watch attachment.

When the IsAttached trait is set to true, the Watch Band automatically attaches to the player, aligning itself relative to the Watch Face’s attachment. The Body Part trait, available as a dropdown, specifies where the Watch Band should attach. In VR applications, it is typically placed on the player’s left hand.

For a seamless setup, the Watch Band is commonly attached to the same Body Part as the Watch Face, ensuring a natural and realistic appearance in VR experiences.

Traits

Is Attached	Determines whether the Watch Face Spark snaps to the player.
Body Part	Defines which part of the body the Watch Face attaches to.
Offset Position	Adjusts the position of the Watch Face relative to the selected body part.
Offset Rotation	Modifies the rotation of the Watch Face when attached to the player’s body.

Watch Face

Commonly used in VR applications, the Watch Face is an Entity Spark that can be conveniently attached to any part of the player’s body.

When the IsAttached trait is set to true, the Watch Face automatically attaches to the player. The Body Part trait, available as a dropdown, specifies which part of the body the Watch Face should attach to. In VR applications, it is typically placed on the player’s left hand.

Using the If Interacted Effect, interactions with the Watch Face can trigger specific actions, such as spawning a Menu UI when the VR player interacts with it.

Traits

Is Attached	Determines whether the Watch Face Spark snaps to the player.
Body Part	Defines which part of the body the Watch Face attaches to.
Offset Position	Adjusts the position of the Watch Face relative to the selected body part.
Offset Rotation	Modifies the rotation of the Watch Face when attached to the player’s body.

The Watch Face is an interactive Entity Spark commonly used in VR experiences. It attaches directly to a player’s body, typically on the left hand, and can display a Billboard for information and a Button for triggering actions. Designed to enhance immersion, the Watch Face supports interactions such as opening menus, displaying status updates, or unlocking gameplay features through the If Interacted Effect.

Entities/Primitives

Primitives are basic 3D Objects or Sparks, including cubes, spheres, cylinders, and more. They are commonly used for prototyping or creating transparent highlights, such as outlining a box.

Primitives also serve practical applications, such as defining player collider boundaries. By using invisible primitives, areas can be restricted to prevent the player from walking through certain spaces, enhancing scene control and interaction.

Primitives are foundational elements in Bonfire Builder, commonly used for rapid prototyping and scene layout. They can act as invisible barriers by disabling visibility and enabling collision, helping to define navigation paths or block off inaccessible areas. As placeholders, Primitives are easily swapped with final assets, supporting a smooth and flexible development workflow.

Environment

Light

A Light Spark is a Spark that serves as a light source, emitting light within the scene.

Traits

Color Temperature	Adjusts the light’s warmth or coolness, influencing the overall color tone.
Intensity	Controls the brightness of the light.
Type	Point: Emits light in all directions from a single point in space. Spot Light: Emits light in a cone shape, similar to a flashlight or a spotlight. Direction: The Direction trait sets where the light is pointing. Size Inner: Defines the inner cone of the spotlight where the light is at full intensity. Size Outer: Determines the total spread of the spotlight, extending beyond the Size Inner region. Range: Sets how far the spotlight reaches.

The Light Spark is used to add dynamic lighting to your scene in Bonfire Builder. It acts as a light source, allowing you to adjust brightness, color temperature, and range—perfect for setting the mood or highlighting key areas in your environment.

Portal

A Portal Spark is an invisible Spark that is visible only in the Builder and not to the Player. It is used to transport the player between different locations within a project.

Effects

Teleport

Instantly moves the player to the designated Spark location when called.

Destination	The assigned Spark where the player will teleport into.

Traits

Cooldown (s)

The Cooldown in a portal defines the required wait time before it can be used again after teleportation. For example, if the cooldown is set to 5 seconds, the portal remains inactive for that duration before allowing another teleport. This setting helps regulate portal usage and prevents continuous teleportation. The default value is 0.5.

Val. Float	Cooldown value in seconds

Reflection Probe

The Reflection Probe Spark is used to create realistic reflections on shiny surfaces such as gloss, mirrors, and glass within a Chapter. It captures the surrounding environment and applies dynamic reflections to enhance the visual realism of objects.

As demonstrated in the GIF below, when the Reflection Probe Spark is moved, reflections on shiny surfaces—such as grass and the car’s texture—adjust dynamically to the updated position.

The effect produces better results when applied to HiFi (high-fidelity) assets compared to low-poly assets, as HiFi models better support detailed reflective textures.

This Spark is ideal for enhancing realism in scenes that feature reflective or glossy materials.

Traits

Size	Adjusts the range of reflection.

The Reflection Probe Spark captures the surrounding environment to create realistic reflections on shiny surfaces like mirrors, glass, or polished objects. It updates dynamically when moved and works best with high-fidelity assets, making it ideal for enhancing realism in detailed scenes.

Spawn Point

A Spawn Point Spark defines the location where the player will appear when the Chapter restarts. Without this Spark, the player will spawn at the origin (ground zero, position zero for x and y). By using a Spawn Point Spark, you can specify a custom spawn location for the player. Each Chapter can contain only one Spawn Point Spark.

Trigger

A Trigger Spark is an invisible Spark, visible only in the Builder and not to the Player, commonly used as a sensor to activate specific Causes. It supports typical Effects and Causes found in most Sparks, such as Collided or Approached Causes, with the added benefit of being hidden from the player’s view. This makes it ideal for creating surprise elements when the player enters a designated area.

For more information about the Threshold property in “Collided Cause,” refer to the “Collided” section on the Behavior Nodes page.

Persona

Input Control

The Input Control Spark in Bonfire allows developers to define and manage input configurations for different platforms, including:

• Windows/macOS (Keyboard & Mouse)

• Gamepad (Controller Input)

• AR/VR/XR (Virtual Reality or Extended Reality Controllers)

This Spark helps standardize control mappings, ensuring that players can interact with the game world seamlessly, regardless of their device. Below is a breakdown of the different input types and their default mappings based on the screenshot you provided.

The Input Control Config manages input mappings across platforms, including desktop, gamepad, and XR devices. In this setup, the Grab action is remapped from R to G, applying consistently across desktop, mobile, and VR platforms. This ensures unified control inputs and maintains consistent interactions across all devices.

Input Control Mappings

1. Attack Action

• Keyboard: Q

• Gamepad: Button_North

• AR/VR/XR: None (Not mapped by default)

2. Crouch Action

• Keyboard: Alt

• Gamepad: Button_West

• AR/VR/XR: X

3. Grab Action

• Keyboard: R

• Gamepad: Left_Trigger

• AR/VR/XR: Grip

4. Interact Action

• Keyboard: E

• Gamepad: Button_South

• AR/VR/XR: Trigger

5. Jump Action

• Keyboard: Space

• Gamepad: Button_East

• AR/VR/XR: A

6. Laser On/Off Action

• Keyboard: L

• Gamepad: Right_Trigger

• AR/VR/XR: B_Y

How This Works in Bonfire

• These mappings allow users to customize control schemes based on their platform.

• The Input Control Spark is useful for defining input interactions in a Book (Bonfire’s interactive experience system).

• Creators can modify these inputs in Bonfire Builder to match their specific gameplay requirements.

XR Config

Traits

The XR Config Spark allows customization of Hand Collision settings when using the VR Player. This configuration is book-wide, meaning it remains active throughout the entire chapter. Once published, the assigned Hand Collision settings will automatically apply across Bonfire Player Platforms.

Hand Collision	Everything: The VR hands will collide with all Spark colliders and Map objects in the scene. Nothing: The VR hands will not collide with any Sparks or Map objects, allowing them to pass through everything. Sparks: The VR hands will only collide with Spark Entities and will ignore the default map. Maps: The VR hands will only collide with Map objects, ignoring all Sparks in the scene.

Symbols

Common Symbol Traits

Traits found in all symbols

Position	Controls the position of the symbol in the canvas: X: The horizontal pixel distance from the center. Y: The vertical pixel distance from the center.
Size	Controls the dimensions of the button: X: The width of the button in pixels. Y: The height of the button in pixels.
Rotation	Specifies the angle of rotation based on a provided value.
Fixed Ratio	When enabled, maintains a uniform scale for the symbol, ensuring that changes to one axis (X or Y) proportionally adjust the other axis.
Scale	Controls the scale multiplier of the symbol: X: The horizontal scale multiplier for the symbol. Y: The vertical scale multiplier for the symbol. The Scale property independently adjusts the symbol's size along the horizontal and vertical axes. It differs from the Size property, which directly sets the symbol's width and height in pixels.
Sort Order	Determines the rendering order of the button compared to other objects. Objects with higher sort order values appear in front or on top of those with lower values.
Is Visible	Controls the visibility of the button.
Do Localization	Manages text localization by changing it to different languages. Requires Update: When enabled, this Spark’s content will be included when publishing to the localized server. When disabled, the content—whether a text or an image—will not be pushed. This setting is automatically enabled when a localized Spark’s text value is modified, ensuring the change is included in the next localization update. Once the update is complete, the setting is disabled again to prevent redundant data pushes. Localization Debug: Used for debugging localized text or Spark symbols in the console.

Button

A "Button Spark" is used to create clickable buttons within the interface. When interacted with, Buttons trigger specific actions, events, or interactive elements within the UI.

Causes

On Button Pressed

This trigger takes effect when the button is pressed. This allows specific actions, effects or behaviors to execute when clicked.

Effects

Visible

The "Is Visible" trait controls whether the button is shown or hidden.

Checkbox	When checked, the button is visible. If unchecked, the button is hidden.

Highlight

This trait controls whether the button is visually highlighted, which helps emphasize the button.

Enabled	Determines whether highlighting is enabled (checked) or disabled (unchecked).

Modify

Set Interactable

This "Is Interactable" trait of the button determines if the button can be pressed.

Is Interactable	When checked, the button responds to user inputs like clicks or taps. If unchecked, the button remains visible but doesn’t respond to interactions, making it inactive.

Traits

Label Text	Specifies the text displayed on the button, such as a label or message (e.g., "Submit," "Start"). By default, the label is set to "Button."
Font Size	Defines the size of the text in the "Text Spark". A larger number increases the font size.
Auto Font Size	Determines whether the text size adjusts automatically to fit within its container. Checked: When Auto Font Size is enabled, the font size is automatically scaled to ensure the text fits within its defined area. Unchecked: When Auto Font Size is disabled, the text size remains fixed at the specified Font Size value.
Is Interactable	Determines whether the button can be pressed, clicked, or tapped.
Text Color	Defines the button's label text color using RGBA values: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.
Background Color	Sets the button's background color using RGBA values: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity, with 1 being fully opaque and 0 being fully transparent.
Highlight Color	Defines the button's background color during cursor hover in PC/Mac or when a VR controller raycast is pointing at the button: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.
Pressed Color	Defines the button's background color when the button is pressed: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.
Selected Color	Defines the button's background color when the button is selected: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.
Disabled Color	Defines the button's background color when the button is disabled: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.

This video shows you how to set up and use the Button Spark Symbol in Bonfire Builder. Learn how to add on-screen buttons that players can press to trigger actions, effects, or transitions in your experience. The Button Spark is a powerful UI element for building intuitive and interactive Bonfire projects.

Input Field

The ‘Input Field Spark’ is a type of Interactive Symbol designed for user text input within the user interface. It can be utilized in the default HUD or integrated with a Billboard Symbol via the UI Editor.

Causes

On End Edit	Activates when text entry is finalized and commonly used to display or process the finalized text input.
On Value Changed	Triggers continuously as text is being entered. Enables real-time updates to reflect the current content of the input field.

Effects

Apply Value

References Text Spark to display the text from the input field.

Traits

Placeholder Text	Defines the initial instructional or prompt text displayed within the input field before any input is provided.
Text	Displays the actual text content shown by the "Input Field Spark". Input the desired text to display.
Text Color	Controls the color of the text using RGBA values: R (Red): Sets the intensity of the red color. G (Green): Sets the intensity of the green color. B (Blue): Sets the intensity of the blue color. A (Alpha): Sets the opacity level. A value of 1 means fully visible, and 0 means fully transparent.
Auto Font Size	Determines whether the text size adjusts automatically to fit within its container. Checked: When Auto Font Size is enabled, the font size is automatically scaled to ensure the text fits within its defined area. Unchecked: When Auto Font Size is disabled, the text size remains
Is Interactable	Determines whether users can actively engage with the input field during runtime. Checked: The input field is interactive. Users can click it, type, or edit text. Unchecked: The input field is non-interactive. It appears in the UI but does not accept any user input.
Background Color	Sets the input field's background color using RGBA values: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity, with 1 being fully opaque and 0 being fully transparent.
Highlight Color	Defines the input field's background color during cursor hover in PC/Mac or when a VR controller raycast is pointing at the input field: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.
Pressed Color	Defines the input field's background color when the input field is pressed: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.
Selected Color	Defines the input field's background color when the input field is selected: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.
Disable Color	Defines the input field's background color when the input field is disabled: R (Red): Controls the intensity of the red component. G (Green): Controls the intensity of the green component. B (Blue): Controls the intensity of the blue component. A (Alpha): Adjusts the opacity of the text, with 1 being fully visible and 0 being fully transparent.

The Input Field Spark is an interactive Symbol used to capture editable text within the user interface. It can be placed in the Default HUD or a Billboard Symbol using the UI Editor. When linked to a Text Spark through Behavior nodes, it enables real-time input and dynamic text display. This setup supports responsive, customizable UI elements for collecting and presenting user-generated content.

Text

A Text Spark in Bonfire is used to create and manage text elements, such as menus, signs, or labels, within an experience. It focuses on displaying and controlling text as part of the user interface.

Effects

Change Text

The "Change Text" is used to instantly update the text displayed by the "Text" Spark.

New Text	The text that will replace the existing content.

Add Value To Text Number

The "Add Value To Text Number" is used to add a specific value to the current number displayed in the "Text" Spark. For Example, if the number displayed is 5 and the Value Added is set to 1, the number will increase to 6, displaying up to two decimal places. This is useful to keep score.

Value Added	The amount that will be added to the current number.
Decimal Places	Controls the number of decimal places for the updated number.

Change Number Over Time

The "Change Number Over Time" is used to smoothly transition the displayed number over a specified period. For example, if the current number is 5, and the final number is set to 10 over 2 seconds, the number will increase gradually from 5 to 10 within the designated time-period, displaying up to two decimal places.

Final Number	The target number that will be shown after the transition is complete.
Time (s)	The duration (in seconds) for the number to change from its current value to the final value.
Decimal Places	Defines the number of decimal places that the final number will display.

Traits

Text	Displays the actual text content shown by the "Text Spark". Input the desired text to display.
Font Name	Specifies the font used for displaying the text. Selecting "Default" will use the system’s default font.
Auto Font Size	Determines whether the text size adjusts automatically to fit within its container. Checked: When Auto Font Size is enabled, the font size is automatically scaled to ensure the text fits within its defined area. Unchecked: When Auto Font Size is disabled, the text size remains
Font Size	Defines the size of the text in the "Text Spark". A larger number increases the font size.
Text Color	Controls the color of the text using RGBA values: R (Red): Sets the intensity of the red color. G (Green): Sets the intensity of the green color. B (Blue): Sets the intensity of the blue color. A (Alpha): Sets the opacity level. A value of 1 means fully visible, and 0 means fully transparent.
Text Alignment	Defines how the text aligns within its box (e.g., Top Left, Center, etc.).

The Text Symbol Spark is used to display and manage text elements within an experience, supporting menus, signs, labels, and other UI components. It can be added through the Default HUD or as a Billboard Symbol. It is ideal for presenting instructions, dialogue, or prompts. Font, size, alignment, and dynamic content are fully customizable to match the style and needs of the experience.

Datum Viewer

The Datum Viewer Spark is a user interface component designed to display the “Current Value” of the Datum Config. To display this value, select the Datum in the Datum Viewer Spark’s Datum Trait located at the bottom of the trait panel.

Traits

Font Name	Specifies the font used for displaying the text. Selecting "Default" will use the system’s default font.
Auto Font Size	Determines whether the text size adjusts automatically to fit within its container. Checked: When Auto Font Size is enabled, the font size is automatically scaled to ensure the text fits within its defined area. Unchecked: When Auto Font Size is disabled, the text size remains
Font Size	Defines the size of the text in the "Datum Spark". A larger number increases the font size.
Text Color	Controls the color of the text using RGBA values: R (Red): Sets the intensity of the red color. G (Green): Sets the intensity of the green color. B (Blue): Sets the intensity of the blue color. A (Alpha): Sets the opacity level. A value of 1 means fully visible, and 0 means fully transparent.
Text Alignment	Defines how the text aligns within its box (e.g., Top Left, Center, etc.).
Datum	A dropdown selection for choosing the Datum whose value will be displayed in this specific Datum Viewer.

Dropdown

The Dropdown Spark is a user interface component that displays a list of options that can be selected by users, similar to dropdown menus in applications, but designed for interactive experiences in Bonfire.

Causes

On Dropdown Changed

This state changes and is activated when a new option is added, removed, or selected from the dropdown.

Effects

Add Dropdown Option

Adds a new option to the dropdown list dynamically.

Option Name	This label identifies the name to be given to the option added to the dropdown. The name chosen is what will appear in the dropdown menu.
Allow Duplicates	When checked, this allows multiple options to be added with the same name. If unchecked, only unique names are accepted, preventing duplicates.

Remove Dropdown Option

Removes a specific option from the dropdown by matching its name.

Option Name	Allows you to specify the name of the option you want to remove from the dropdown list.

Clear Dropdown Options

Clear or reset all options from the dropdown list.

Traits

Options	A list of all choices added in the dropdown list.

Inventory Viewer

The Inventory Viewer Spark displays and manages inventory items within a scene, showcasing collected or carried items. This can be updated dynamically as the inventory changes.

Effects

Update

Refreshes or reloads the displayed inventory data. When triggered, it ensures the Inventory Viewer displays the most current state of the player's inventory, including newly added or removed items.

Countdown Viewer

The Countdown Viewer Spark is a user interface component designed to display the current value of the Countdown Config. To display this value, the output socket of the “Value Changed” Cause from the Countdown Config must be connected to the input socket of the “Update” Effect in the Countdown Viewer Spark.

Refer to the GIF above, which demonstrates a Countdown Viewer displaying the values from the Countdown Config in the screen-space UI.

Causes

Effects

Update

When the "Value Changed" Cause output socket is connected to the "Update" Cause input socket of the Countdown Config, the current value of the countdown is displayed in the text.

Traits

Font Name	Specifies the font used for displaying the text. Selecting "Default" will use the system’s default font.
Auto Font Size	Determines whether the text size adjusts automatically to fit within its container. Checked: When Auto Font Size is enabled, the font size is automatically scaled to ensure the text fits within its defined area. Unchecked: When Auto Font Size is disabled, the text size remains
Font Size	Defines the size of the text in the "Countdown Spark". A larger number increases the font size.
Text Color	Controls the color of the text using RGBA values: R (Red): Sets the intensity of the red color. G (Green): Sets the intensity of the green color. B (Blue): Sets the intensity of the blue color. A (Alpha): Sets the opacity level. A value of 1 means fully visible, and 0 means fully transparent.
Text Alignment	Defines how the text aligns within its box (e.g., Top Left, Center, etc.).

Toggle

The Toggle Spark is used to switch between states, such as turning behaviors or visibility on or off within a scene. It alternates between two connected nodes or effects, enabling Players to toggle between states like visible/hidden, open/close, or on/off.

Causes

On Toggle Changed

This tracks changes to the toggle state. This is useful for tracking state changes (on/off, open/close) and this can trigger actions, such as notifications, whenever the toggle switches.

On Toggle - On

Triggers when the toggle is switched on. For example, it activates connected behaviors like displaying a Spark or enabling a feature when a user turns something on.

On Toggle - Off

Triggers the toggle is switched off. It executes connected behaviors like hiding an element, deactivating a Spark, or disabling a feature when a user turns something off.

Traits

Text	Displays the actual text content shown by the "Inventory Viewer Spark". Input the desired text to display.
Font Name	Specifies the font used for displaying the text. Selecting "Default" will use the system’s default font.
Auto Font Size	Determines whether the text size adjusts automatically to fit within its container. Checked: When Auto Font Size is enabled, the font size is automatically scaled to ensure the text fits within its defined area. Unchecked: When Auto Font Size is disabled, the text size remains
Font Size	Defines the size of the text in the "Text Spark". A larger number increases the font size.
Text Color	Controls the color of the text using RGBA values: R (Red): Sets the intensity of the red color. G (Green): Sets the intensity of the green color. B (Blue): Sets the intensity of the blue color. A (Alpha): Sets the opacity level. A value of 1 means fully visible, and 0 means fully transparent.
Text Alignment	Defines how the text aligns within its box (e.g., Top Left, Center, etc.).

This video covers how to set up and use the Toggle Spark Symbol in Bonfire Builder. You'll learn how to add interactive toggle switches to your UI that let players turn features on or off, trigger alternate states, or control behaviors dynamically. The Toggle Spark is perfect for creating intuitive settings, modes, or choice-based interactions in your Bonfire experiences.

Crosshair

Crosshairs consist of two thin intersecting lines used as a visual reference for aiming, alignment, or precision targeting within an interface or scene. Typically visible in First-Person Mode, they enhance accuracy and focus when interacting with objects or navigating the environment. The crosshair can also be customized using Sparkifier to match preferred styles.

Traits

Only Show First Person	When enabled, the crosshair is displayed only in First-Person Mode, remaining hidden in other perspectives.
Highlight Color	Controls highlight the color of the crosshair using RGBA values: R (Red): Sets the intensity of the red color. G (Green): Sets the intensity of the green color. B (Blue): Sets the intensity of the blue color. A (Alpha): Sets the opacity level. A value of 1 means fully visible, and 0 means fully transparent.

Crosshairs are thin, intersecting lines designed for precise targeting and interaction, particularly in First-Person Mode. The highlight color shifts when aiming at an interactable Spark, with customization available through the Highlight Color trait. Designs can be easily replaced using imported Crosshair Sparks from Sparkifier, available to Bonfire Pro users. With dynamic visuals and customizable styling, crosshairs enhance both precision and visual clarity in interactive scenes.

UI Containers

Billboard

A Billboard Spark is a versatile visual component used to display symbols, graphics, or information prominently within an interactive experience. It's often used for signs, notifications, or visual cues that need to stay consistently visible in a scene.

Traits

Sparks Contained	Indicates the number of Sparks or elements contained within this Billboard Spark.
Canvas Resolution	Defines the width and height of the Billboard Spark's UI container in pixels. These dimensions can be adjusted to fit the displayed content. For example, setting it to 1920 x 1080 fills the screen at full HD resolution.
Rotate towards camera?	Controls whether the Billboard Spark automatically rotates to face the camera, ensuring UI elements or symbols stay visible to the user.
Lock X Auto-Rotate	Locks the rotation on the X-axis, while preventing it from rotating on the Y-Axis.
Lock Y Auto-Rotate	Locks the rotation on the Y-axis, while preventing it from rotating on the X-Axis..
Background Color	Controls the color of the billboard background using RGBA values: R (Red): Adjusts the intensity of the red component in the background color. G (Green): Adjusts the intensity of the green component in the background color. B (Blue): Adjusts the intensity of the blue component in the background color. A (Alpha): Controls the transparency of the background, where 0 is fully transparent and 1 is fully opaque.

Tip: To create a transparent billboard, set both the alpha values of the background color and entity color traits to 0.

Difference Between Background Color and Entity Color

The image above shows a billboard with both blue and red colors.

• Background Color (Blue): This is the color of the billboard’s surface, the area behind any displayed content.

• Entity Color (Red): This is the color of the entire billboard object, affecting all its surfaces.

Tip: Using the IsVisible Shortcut in the UI Editor

The IsVisible shortcut checkbox, located in the upper-left corner of the UI Editor, serves the same function as toggling a billboard's IsVisible trait.

This feature is particularly useful when working with multiple billboards. Instead of navigating to each billboard's trait panel and scrolling to toggle visibility, the shortcut checkbox allows for a faster and more efficient workflow.

The GIF above demonstrates the visibility of a billboard being toggled using the IsVisible checkbox shortcut in the UI Editor.

Follow Head Billboard

The Follow Head Billboard Spark functions similarly to the Billboard Spark, with the key difference being its ability to remain in front of the player by continuously adjusting its position to stay within view. This behavior can be configured to enable or disable the billboard's movement as needed.

Traits

Distance from Head	Determines how far the billboard stays from the player's head while following movement.
Position Offset	Adjusts the billboard’s position relative to the player’s head. X: Moves the billboard left or right. Y: Moves the billboard up or down. Z: Moves the billboard forward or backward.
Freeze Height	Maintains a fixed vertical position, preventing movement up or down.
Smoothness	Controls how smoothly the billboard follows head movement, reducing sudden shifts for a more natural effect.
Dead Zone Size	Defines a buffer zone around the player's head where minor movements do not affect the billboard, preventing jitter.

Screen Space UI (legacy)

The Screen Space UI Spark is a Symbol Spark used to display 2D user interface elements that remain fixed on the screen, unaffected by the 3D environment. Commonly used for creating HUD elements, menus, or other on-screen components that stay in place as the player moves. Note: this is now deprecated as the built-in "Default HUD" now acts as the Screen Space UI.

Note: This feature is now deprecated, as the built-in “Default HUD” has replaced the Screen Space UI functionality.

2D Primitives

The 2D Primitives consist of basic shapes designed for use within the UI container. These 2D primitives serve as foundational elements for creating and customizing graphical components.

• Circle

• Circle-Half

• Circle-Quarter

• Diamond

• Oval

• Parallelogram

• Square

• Triangle (Equilateral)

• Triangle (Right)

2D Primitives are basic shapes designed for use within the UI container, serving as a foundational element for building panels, buttons, highlights, and other interface visuals. Displayed in screen space, they appear through the Default HUD or as part of Billboard Symbols, making them well-suited for overlay interfaces. Though similar to 3D Primitives, 2D Primitives are displayed in screen space. They provide a flexible way to create clear, consistent, and interactive UI designs across an experience.