Skip to content

physics.md

Latest commit

 

History

History
179 lines (133 loc) · 5.82 KB

physics.md

File metadata and controls

179 lines (133 loc) · 5.82 KB
Raw

Physics Traits

Part of the HoloScript Traits reference. Browse: Interaction · AI & Behavior · All Traits

Physics Traits

@cloth

Real-time cloth simulation with wind, gravity, and tearing.

object Cape @cloth(resolution: 32, stiffness: 0.8) {
  geometry: 'plane'
}
Config Type Default Description
resolution number 32 Grid resolution (NxN vertices)
stiffness number 0.8 Constraint stiffness (0-1)
damping number 0.01 Velocity damping
mass number 1.0 Total cloth mass
gravity_scale number 1.0 Gravity multiplier
wind_response number 0.5 Wind force multiplier
self_collision boolean false Enable self-collision
tearable boolean false Allow tearing
tear_threshold number 100 Force required to tear
pin_vertices Array [] Pinned vertex coordinates

Events:

  • cloth_create - Simulation initialized
  • cloth_destroy - Simulation destroyed
  • cloth_pin_vertex - Vertex pinned
  • cloth_unpin_vertex - Vertex unpinned
  • cloth_tear - Cloth torn (if tearable)

@fluid

Particle-based fluid simulation.

object Water @fluid(particle_count: 10000, viscosity: 0.01) {
  geometry: 'cube'
}
Config Type Default Description
particle_count number 10000 Maximum particles
viscosity number 0.01 Fluid thickness
surface_tension number 0.1 Surface tension force
color string '#0088ff' Fluid color
spawn_rate number 100 Particles per second
lifetime number 10 Particle lifetime (seconds)
gravity_scale number 1.0 Gravity multiplier
collision_enabled boolean true Collide with objects

Events:

  • fluid_create - Simulation started
  • fluid_destroy - Simulation stopped
  • fluid_add_emitter - Emitter added
  • fluid_remove_emitter - Emitter removed

@rope

Segment-based rope physics with tension and slack.

object SwingingRope @rope(segments: 20, length: 5) {
  start: [0, 5, 0]
  end: [0, 0, 0]
}
Config Type Default Description
segments number 10 Number of segments
length number 1.0 Total rope length (meters)
stiffness number 0.9 Segment stiffness
damping number 0.1 Velocity damping
gravity number 9.81 Gravity force
thickness number 0.02 Visual thickness
color string '#8B4513' Rope color
collision_enabled boolean true Collide with objects

State:

  • points - Array of {x, y, z} positions (segments + 1 points)
  • isSimulating - Whether simulation is active
  • tension - Current rope tension

Events:

  • rope_create - Rope initialized
  • rope_destroy - Rope destroyed
  • rope_break - Rope broken (if breakable)

@soft_body

Deformable soft body physics.

object JellyBlob @soft_body(pressure: 1.0, volume_conservation: 0.9) {
  geometry: 'sphere'
}
Config Type Default Description
pressure number 1.0 Internal pressure
volume_conservation number 0.9 How much volume is preserved
stiffness number 0.5 Edge stiffness
damping number 0.1 Velocity damping
mass number 1.0 Total mass

Events:

  • soft_body_create - Simulation initialized
  • soft_body_destroy - Simulation destroyed
  • soft_body_deform - Significant deformation occurred

@buoyancy

Water buoyancy simulation.

object Boat @buoyancy(water_level: 0, density: 0.7) {
  geometry: 'model/boat.glb'
}
Config Type Default Description
water_level number 0 Y-position of water surface
density number 1.0 Object density (< 1 floats)
drag number 0.5 Water resistance
angular_drag number 0.3 Rotational resistance

@destruction

Breakable objects with fracture simulation.

object Vase @destruction(fracture_count: 8, break_threshold: 50) {
  geometry: 'model/vase.glb'
}
Config Type Default Description
fracture_count number 8 Number of fragments
break_threshold number 50 Impact force to break
debris_lifetime number 5 Seconds before cleanup
explosion_force number 10 Fragment scatter force

Events:

  • destruction_break - Object broken
  • destruction_fragment - Fragment created

See Also