VR Traits Reference

Complete reference for all 55 built-in VR traits.

Quick Reference

By Category

Category	Traits
Interaction	`@grabbable` `@throwable` `@holdable` `@clickable` `@hoverable` `@draggable` `@haptic`
Physics	`@collidable` `@physics` `@rigid` `@kinematic` `@trigger` `@gravity`
Visual	`@glowing` `@emissive` `@transparent` `@reflective` `@animated` `@billboard`
Networking	`@networked` `@synced` `@persistent` `@owned` `@host_only`
Behavior	`@stackable` `@attachable` `@equippable` `@consumable` `@destructible`
Spatial	`@anchor` `@tracked` `@world_locked` `@hand_tracked` `@eye_tracked` `@seated`
Audio	`@spatial_audio` `@ambient` `@voice_activated`
State	`@state` `@reactive` `@observable` `@computed`

Interaction Traits

@grabbable

Makes object pickable with hands/controllers.

hsplus

orb item {
  @grabbable
  @grabbable(snap_to_hand: true)
  @grabbable(haptic_on_grab: 0.7, two_handed: false)
}

Parameters:

Parameter	Type	Default	Description
`snap_to_hand`	boolean	`false`	Object snaps to grip position
`haptic_on_grab`	number	`0`	Haptic intensity (0-1)
`two_handed`	boolean	`false`	Requires both hands
`throw_on_release`	boolean	`true`	Enable throwing

Events: on_grab, on_release, on_grab_start, on_grab_end

@throwable

Enables physics-based throwing.

hsplus

orb ball {
  @grabbable
  @throwable
  @throwable(velocity_multiplier: 2.0, bounce: true)
}

Parameters:

Parameter	Type	Default	Description
`velocity_multiplier`	number	`1.0`	Throw force multiplier
`bounce`	boolean	`false`	Enable bouncing
`bounce_factor`	number	`0.5`	Bounce energy retention
`max_velocity`	number	`50`	Maximum throw speed

Events: on_throw, on_land, on_bounce

@holdable

Object stays in hand until button release.

hsplus

orb torch {
  @grabbable
  @holdable(grip_button: "trigger")
}

@clickable

Object responds to click/tap/trigger.

hsplus

orb button {
  @clickable
  @clickable(hold_time: 500ms, double_click: true)
  
  on_click: { activate_door() }
}

Events: on_click, on_double_click, on_hold, on_release

@hoverable

Object responds to hover/gaze.

hsplus

orb indicator {
  @hoverable
  @hoverable(scale_on_hover: 1.2, glow: true)
}

Events: on_hover_enter, on_hover_exit, on_hover

@draggable

Object can be dragged in 2D/3D space.

hsplus

orb slider {
  @draggable(axis: "x", min: 0, max: 10)
}

Physics Traits

@collidable

Participates in collision detection.

hsplus

orb wall {
  @collidable
  @collidable(layer: "environment", continuous: true)
}

Events: on_collision_enter, on_collision_exit, on_collision_stay

@physics

Full rigid body physics simulation.

hsplus

orb crate {
  @physics
  @physics(mass: 5.0, drag: 0.1, angular_drag: 0.05)
}

Parameters:

Parameter	Type	Default
`mass`	number	`1.0`
`drag`	number	`0`
`angular_drag`	number	`0.05`
`use_gravity`	boolean	`true`
`is_kinematic`	boolean	`false`
`freeze_rotation`	boolean	`false`

@rigid

Rigid body without gravity.

hsplus

orb floating_platform {
  @rigid
  @collidable
}

@kinematic

Scripted movement that affects physics objects.

hsplus

orb elevator {
  @kinematic
  @collidable
  
  function move_up() {
    animate position to [0, 10, 0] over 5s
  }
}

@trigger

Collision detection without physical response.

hsplus

orb zone {
  @trigger
  
  on_trigger_enter: { start_battle() }
  on_trigger_exit: { end_battle() }
}

@gravity

Object affected by gravity.

hsplus

orb ball {
  @gravity
  @gravity(strength: 9.81, direction: [0, -1, 0])
}

Visual Traits

@glowing

Object emits light.

hsplus

orb lamp {
  @glowing
  @glowing(color: "#ff0000", intensity: 2.0, range: 10)
}

@emissive

Self-illuminating material (no light emission to scene).

hsplus

orb sign {
  @emissive(color: "#00ffff", intensity: 1.5)
}

@transparent

Transparency/opacity control.

hsplus

orb glass {
  @transparent(opacity: 0.5, double_sided: true)
}

@reflective

Mirror-like surface.

hsplus

orb mirror {
  @reflective(strength: 1.0, blur: 0)
}

@animated

Object has animation states.

hsplus

orb character {
  @animated
  
  animations: {
    idle: "idle.anim",
    walk: "walk.anim",
    run: "run.anim"
  }
  
  function start_walking() {
    play_animation("walk")
  }
}

@billboard

Always faces the camera.

hsplus

orb label {
  @billboard
  @billboard(lock_y: true)  // Only rotate on Y axis
}

Networking Traits

@networked

State syncs across network.

hsplus

orb shared_object {
  @networked
  @networked(sync_rate: 30hz, interpolation: true)
}

Parameters:

Parameter	Type	Default
`sync_rate`	frequency	`20hz`
`interpolation`	boolean	`true`
`authority`	string	`"server"`

@synced

Mark specific properties for sync.

hsplus

orb player {
  @synced(properties: [position, rotation, health])
}

@persistent

State persists between sessions.

hsplus

orb save_point {
  @persistent
  @persistent(key: "player_progress")
}

@owned

Has network ownership (only owner can modify).

hsplus

orb player_avatar {
  @networked
  @owned
}

@host_only

Only host can modify.

hsplus

orb game_manager {
  @networked
  @host_only
}

Behavior Traits

@stackable

Objects can stack on each other.

hsplus

orb block {
  @stackable(axis: "y", max_stack: 10)
}

@attachable

Object can attach to other objects.

hsplus

orb scope {
  @attachable(attach_points: ["weapon_rail"])
}

@equippable

Can be equipped to avatar slots.

hsplus

orb helmet {
  @equippable(slot: "head", auto_fit: true)
}

@consumable

Object can be consumed/used up.

hsplus

orb potion {
  @consumable
  
  on_consume: { 
    player.health += 50
    this.destroy()
  }
}

@destructible

Object can be destroyed.

hsplus

orb crate {
  @destructible
  @destructible(health: 100, fragments: 8, explosion: true)
  
  on_destroy: { spawn_loot() }
}

Spatial Traits

@anchor

Fixed position in world space.

hsplus

orb waypoint {
  @anchor
}

@tracked

Follows a tracked point (controller, hand, etc).

hsplus

orb pointer {
  @tracked(source: "right_controller")
}

@world_locked

Locked to world coordinates (AR).

hsplus

orb ar_marker {
  @world_locked
}

@hand_tracked

Follows hand skeleton.

hsplus

orb ring {
  @hand_tracked(hand: "left", joint: "ring_finger_tip")
}

@eye_tracked

Responds to eye gaze with dwell activation and highlighting.

hsplus

orb gaze_target {
  @eye_tracked
  @eye_tracked(dwell_enabled: true, dwell_time: 1000ms)
  @eye_tracked(gaze_highlight: true, highlight_color: "#00ffff")
  
  on_gaze_enter: { highlight() }
  on_gaze_exit: { unhighlight() }
  on_dwell_activate: { click() }
}

Parameters:

Parameter	Type	Default	Description
`dwell_enabled`	boolean	`true`	Enable dwell-to-activate
`dwell_time`	duration	`1000ms`	Time to dwell for activation
`dwell_feedback`	boolean	`true`	Show progress indicator
`gaze_highlight`	boolean	`true`	Highlight when gazed at
`highlight_color`	string	`"#00ffff"`	Highlight color
`gaze_scale`	number	`1.1`	Scale multiplier when gazed
`foveated_priority`	string	`"medium"`	Rendering priority (low/medium/high)
`smooth_pursuit`	boolean	`false`	Object follows gaze smoothly

Events: on_gaze_enter, on_gaze_exit, on_dwell_progress, on_dwell_activate

@seated

Optimizes object for seated VR users with comfort options.

hsplus

orb player {
  @seated
  @seated(auto_calibrate: true, snap_turn_angle: 45)
  @seated(comfort_vignette: true, max_reach: 1.0)
}

Parameters:

Parameter	Type	Default	Description
`height_offset`	number	`0`	Height adjustment (meters)
`max_reach`	number	`1.0`	Maximum forward reach
`auto_calibrate`	boolean	`true`	Auto-calibrate seated height
`comfort_vignette`	boolean	`true`	Vignette on rotation
`snap_turn_angle`	number	`45`	Snap turn degrees (0 = smooth)
`play_bounds`	array	`[1.5, 1.5]`	Play area [width, depth]

Events: on_seated_calibrated, on_turn_left, on_turn_right

@haptic

Advanced haptic feedback with patterns and proximity.

hsplus

orb vibrating_object {
  @haptic
  @haptic(intensity: 0.7, collision_pattern: "metal")
  @haptic(proximity_enabled: true, proximity_distance: 0.5)
}

Parameters:

Parameter	Type	Default	Description
`intensity`	number	`0.5`	Base haptic intensity (0-1)
`proximity_enabled`	boolean	`false`	Enable proximity-based haptics
`proximity_distance`	number	`0.5`	Distance for proximity haptics
`collision_pattern`	string	`"soft"`	Pattern: soft/hard/metal/glass/custom
`hands`	string	`"dominant"`	Which hands: both/left/right/dominant
`duration`	number	`100`	Haptic pulse duration (ms)

Built-in Patterns:

soft - Gentle tap
hard - Strong impact
metal - Metallic ring
glass - Delicate break

Events: on_haptic_start, on_haptic_end

Audio Traits

@spatial_audio

3D positional audio.

hsplus

orb speaker {
  @spatial_audio
  @spatial_audio(falloff: "linear", max_distance: 20)
  
  audio_source: "music.mp3"
}

@ambient

Background audio source.

hsplus

orb environment_sound {
  @ambient(loop: true, volume: 0.5)
  
  audio_source: "forest.mp3"
}

@voice_activated

Responds to voice input.

hsplus

orb voice_controller {
  @voice_activated
  
  commands: {
    "open door": { open_door() },
    "lights on": { toggle_lights(true) }
  }
}

State Traits

@state

Has reactive state.

hsplus

orb counter {
  @state
  
  state {
    count: 0
  }
  
  on_click: { state.count++ }
}

@reactive

Automatically updates on state change.

hsplus

orb display {
  @reactive
  
  text: "Count: ${state.count}"
}

@observable

State can be observed by other objects.

hsplus

orb health_bar {
  @observable
  
  state {
    health: 100
  }
}

orb health_display {
  @observe(target: "health_bar", property: "health")
  
  on_change: { update_display(value) }
}

@computed

Derived state from other values.

hsplus

orb stats {
  @state
  
  state {
    attack: 10
    defense: 5
  }
  
  @computed power = attack * 2 + defense
}

VR Traits Reference ​

Quick Reference ​

By Category ​

Interaction Traits ​

@grabbable ​

@throwable ​

@holdable ​

@clickable ​

@hoverable ​

@draggable ​

Physics Traits ​

@collidable ​

@physics ​

@rigid ​

@kinematic ​

@trigger ​

@gravity ​

Visual Traits ​

@glowing ​

@emissive ​

@transparent ​

@reflective ​

@animated ​

@billboard ​

Networking Traits ​

@networked ​

@synced ​

@persistent ​

@owned ​

@host_only ​

Behavior Traits ​

@stackable ​

@attachable ​

@equippable ​

@consumable ​

@destructible ​

Spatial Traits ​

@anchor ​

@tracked ​

@world_locked ​

@hand_tracked ​

@eye_tracked ​

@seated ​

@haptic ​

Audio Traits ​

@spatial_audio ​

@ambient ​

@voice_activated ​

State Traits ​

@state ​

@reactive ​

@observable ​

@computed ​

VR Traits Reference

Quick Reference

By Category

Interaction Traits

@grabbable

@throwable

@holdable

@clickable

@hoverable

@draggable

Physics Traits

@collidable

@physics

@rigid

@kinematic

@trigger

@gravity

Visual Traits

@glowing

@emissive

@transparent

@reflective

@animated

@billboard

Networking Traits

@networked

@synced

@persistent

@owned

@host_only

Behavior Traits

@stackable

@attachable

@equippable

@consumable

@destructible

Spatial Traits

@anchor

@tracked

@world_locked

@hand_tracked

@eye_tracked

@seated

@haptic

Audio Traits

@spatial_audio

@ambient

@voice_activated

State Traits

@state

@reactive

@observable

@computed