> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Physics & World

> Create physical effects like explosions, lightning, and velocity.

Manipulate the physical world and player movement.

## Configuration

### `set_velocity_action`

Launch the player in a specific direction.
<ResponseField name="x" type="Double" default="0.0">Velocity X.</ResponseField>
<ResponseField name="y" type="Double" default="0.0">Velocity Y (Up/Down).</ResponseField>
<ResponseField name="z" type="Double" default="0.0">Velocity Z.</ResponseField>

### `create_explosion_action`

Spawn a calibrated explosion.
<ResponseField name="power" type="Float" default="4.0">TNT equivalent power.</ResponseField>
<ResponseField name="fire" type="Boolean" default="false">Should it create fire?</ResponseField>
<ResponseField name="breakBlocks" type="Boolean" default="false">Should it destroy terrain?</ResponseField>

### `spawn_lightning_action`

Strike lightning at the player's location.
<ResponseField name="damage" type="Boolean" default="true">Should it deal damage?</ResponseField>

### `launch_firework_action`

Spawn a decorative firework.
<ResponseField name="type" type="Enum" default="BALL">Shape (BALL, STAR, BURST, CREEPER, LARGE\_BALL).</ResponseField>
<ResponseField name="color" type="Color" default="RED">Primary color.</ResponseField>
<ResponseField name="flicker" type="Boolean" default="false">Add flicker effect.</ResponseField>

## Example Usage

<CodeGroup>
  ```yaml Launch Player theme={null}
  set_velocity_action:
    x: 0.0
    y: 1.5
    z: 0.0
  ```

  ```yaml Safe Explosion theme={null}
  create_explosion_action:
    power: 5.0
    fire: false
    breakBlocks: false
  ```
</CodeGroup>
