---
title: "pyrofx: fire, smoke, explosion and dust | Spatial Compiler"
description: "Compile fire, smoke, explosion and dust texture sheets lit from six directions using a .pyro.toml spec."
canonical: https://appliedmanifold.com/modules/pyrofx/
site: "Applied Manifold: The spatial compute cloud for 3D reality"
---

1.  [Home](https://appliedmanifold.com/)
2.  [Modules](https://appliedmanifold.com/modules/)
3.  pyrofx

MODULE // pyrofx

# Add lit fire, smoke and explosions to your engine

Send a TOML spec to compile animated fire and smoke sheets lit from six directions. Set the frame count, playback rate and sheet size for your engine.

The Godot pool plays the sheets in order. Both the pool and the single sheet light the smoke from six directions. [Turn the light on a compiled explosion](https://appliedmanifold.com/#xpl) or read the [Godot pool settings](https://appliedmanifold.com/docs/pyrofx/godot-pool/).

The `pyro` name and `.pyro.toml` spec files keep working.

[Get Free API Key](https://console.appliedmanifold.com/sign-in?next=/api-keys) [Connect your agent →](https://appliedmanifold.com/docs/mcp/) [Read the pyrofx docs →](https://appliedmanifold.com/docs/pyrofx/)

## Compiled examples

Model-shaped emitters put fire on a hull. Model-shaped obstacles let smoke flow around it. Soil and masonry presets set dust colours and motion defaults.

![Soil kick-up, a frame from the final hosted compile](/compiled/pyrofx-052/kickup_soil.webp)

Soil kick-up. Compiled with Spatial Compiler. [Full report](https://appliedmanifold.com/compiled/pyrofx-052/kickup_soil-report.json).

![Masonry kick-up, a frame from the final hosted compile](/compiled/pyrofx-052/kickup_masonry.webp)

Masonry kick-up. Compiled with Spatial Compiler. [Full report](https://appliedmanifold.com/compiled/pyrofx-052/kickup_masonry-report.json).

![Turned solid, a frame from the final hosted compile](/compiled/pyrofx-052/turned_block.webp)

Turned solid. Compiled with Spatial Compiler. [Full report](https://appliedmanifold.com/compiled/pyrofx-052/turned_block-report.json).

The [Godot pool](https://appliedmanifold.com/docs/pyrofx/godot-pool/) draws many copies in one draw call, blends side and high views, and uses a finer compile near the camera. Desktop sheets import as BC7.

[Model shapes →](https://appliedmanifold.com/docs/pyrofx/models/) [Material presets →](https://appliedmanifold.com/docs/pyrofx/presets/)

**Compiled output: Fireball** (`fireball.pyro.toml`, final, pyro)

- Preview at true speed, rendered from the sheets over a dark scene: [preview video (mp4)](https://appliedmanifold.com/bakes/fireball/preview.mp4), [webm](https://appliedmanifold.com/bakes/fireball/preview.webm); still: [poster.webp](https://appliedmanifold.com/bakes/fireball/poster.webp).
- 64 frames, on one 8 × 8 sheet of 256 px tiles, 4 s, one-shot, 0 warnings.
- Frames, each drawn over the preview scene: [f00.webp](https://appliedmanifold.com/bakes/fireball/frames/f00.webp) to [f63.webp](https://appliedmanifold.com/bakes/fireball/frames/f63.webp); contact sheet: [contact_sheet.webp](https://appliedmanifold.com/bakes/fireball/contact_sheet.webp).
- The sheets an engine reads (RGBA PNG; the A channel is data, not transparency):
  - [main_pos.png](https://appliedmanifold.com/bakes/fireball/main_pos.png) (2048 × 2048): Lighting, first three directions. R: lit from right. G: lit from top. B: lit from back. A: opacity. The shader blends this sheet with the neg sheet by the light direction, and reads opacity from A.
  - [main_neg.png](https://appliedmanifold.com/bakes/fireball/main_neg.png) (2048 × 2048): Lighting, other three directions. R: lit from left. G: lit from bottom. B: lit from front. A: flame brightness (square root). Together with the pos sheet this is the six-way lighting; A drives the flame.
  - [main_colour.png](https://appliedmanifold.com/bakes/fireball/main_colour.png) (2048 × 2048): Flame colour. R: flame colour R. G: flame colour G. B: flame colour B. A: smoke to dust mix. RGB tints the flame; A blends the smoke colour toward the dust colour.
  - [main_aux.png](https://appliedmanifold.com/bakes/fireball/main_aux.png) (2048 × 2048): Motion, depth and temperature. R: motion X. G: motion Y. B: depth. A: temperature. Motion vectors blend between frames so playback stays smooth; depth gives soft edges where the effect meets geometry.
- [Spec](https://appliedmanifold.com/bakes/fireball/fireball.pyro.toml) · [Bake summary](https://appliedmanifold.com/bakes/fireball/meta.json)

## Inputs and outputs

**In a .pyro.toml spec**
The box, emitters, forces, obstacles, solver, look, views and export. Omitted fields take defaults.

**Out sheets**
Animation frames packed into images an engine loads directly. Two sheets carry six-way lighting; two carry flame color, motion and depth.

**Out previews**
A strip and contact sheet for the agent, and an animated preview for you.

**Out JSON report**
`bake_report.json`: every file, the clip metrics, and warnings that name the key to change.

[Outputs →](https://appliedmanifold.com/docs/pyrofx/outputs/) [Report →](https://appliedmanifold.com/docs/pyrofx/report/)

## Spec features

### Values over time

An animatable field takes a constant or keys over simulated seconds. Values blend between keys and hold outside them. `ease` is `linear` (default), `smooth` or `step`:

```
fuel = 4.0                                        # constant
fuel = [[0.0, 4.0], [0.5, 0.0]]                   # keys: [seconds, value]
position_m = [[0, -3, 1, 0], [2, 3, 1, 0]]        # keys of a vector: [seconds, x, y, z]
fuel = { keys = [[0, 4], [0.5, 0]], ease = "smooth" }   # ease: linear (default), smooth or step
```

[Values over time →](https://appliedmanifold.com/docs/pyrofx/values-over-time/)

### Emitters

Any number of `[[emitters]]`: sphere, box, disc, ring, points or a model. Key `position_m` to move one and `rotation_deg` to turn it. The impact example's first of three emitters makes the flash:

```
# The flash. Little fuel and a short burn, so its heat does not carry the dust up as a column.
[[emitters]]
shape = "sphere"
position_m = [0, 0.3, 0]
size_m = 0.4
start_s = 0.0
end_s = 0.06
fuel = 3
temperature_k = 1900
smoke = 2.0
velocity_mps = 6
direction = "radial"
```

**IMPACTFINAL**

![First frame of the impact bake](/bakes/impact/poster.webp)

Impact, 3.5 x 2.8 m, compiled with Spatial Compiler. [Spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-impact)

[Emitters →](https://appliedmanifold.com/docs/pyrofx/emitters/)

### Forces

`[[forces]]` act inside a sphere, a box or everywhere: `push` (fan), `point` (toward or away from a center), `vortex` (spin), `turbulence` (local gusts), `drag` (still pocket) and `expand` (blast). The fire whirl spins with a vortex:

```
# The spin: around the vertical axis, up the whole column, on air and gas alike.
[[forces]]
kind = "vortex"
shape = "box"
position_m = [0, 4, 0]
size_m = [1.3, 4, 1.3]
direction = [0, 1, 0]
strength = 14
max_speed_mps = 4
falloff = 0.4
```

**FIRE\_WHIRLFINAL**

![First frame of the fire\_whirl bake](/bakes/fire_whirl/poster.webp)

Fire whirl, 4.4 x 7.1 m, compiled with Spatial Compiler. [Spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-fire_whirl)

[Forces →](https://appliedmanifold.com/docs/pyrofx/forces/)

### Obstacles

`[[obstacles]]` are solids the gas cannot enter: `sphere`, `box`, `cylinder` or `capsule`. `carve = true` cuts a shape out of earlier solids. Keyed solids move and push the gas. The window fire carves a room and its window out of a block:

```
# The room inside it, with a wall 0.2 m thick in front.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.3, -1.5]
size_m = [1.3, 1.1, 0.8]

# The window through that wall.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.5, -0.6]
size_m = [0.7, 0.65, 0.25]
```

**WINDOW\_FIREFINAL**

![First frame of the window\_fire bake](/bakes/window_fire/poster.webp)

Window fire, 3.9 x 4.7 m, compiled with Spatial Compiler. [Spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-window_fire)

`holdout` (default on) hides gas behind the solid. `shadow` (default on) darkens gas in its shade. [Obstacles →](https://appliedmanifold.com/docs/pyrofx/obstacles/)

## Examples

[Starters](https://appliedmanifold.com/modules/pyrofx/#examples-starters)  [Explosions](https://appliedmanifold.com/modules/pyrofx/#examples-explosions)  [Fire](https://appliedmanifold.com/modules/pyrofx/#examples-fire)  [Smoke](https://appliedmanifold.com/modules/pyrofx/#examples-smoke)  [Impact and dust](https://appliedmanifold.com/modules/pyrofx/#examples-impact)  [Environmental](https://appliedmanifold.com/modules/pyrofx/#examples-environment)  [Stylized](https://appliedmanifold.com/modules/pyrofx/#examples-stylized)

### Starters

#### fireball.pyro.toml ONE-SHOT · 9.4 x 13.4 m

![First frame of the fireball bake](/bakes/fireball/poster.webp)

A fuel explosion that bursts from the ground and rolls upward.

```
[[emitters]]
shape = "sphere"
position_m = [0, 0.7, 0]
size_m = 1.2
start_s = 0.0
end_s = 0.18
fuel = 5
temperature_k = 1900
smoke = 1.5
velocity_mps = 7

[solver]
# Burning needs air, so the ball burns at its rolling surface instead of all at once.
air_limit = 0.88
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-fireball)

#### impact.pyro.toml ONE-SHOT · 3.5 x 2.8 m

![First frame of the impact bake](/bakes/impact/poster.webp)

A shell hitting dry ground: flash, thrown earth, a little smoke. Three emitters in one box.

```
# The flash. Little fuel and a short burn, so its heat does not carry the dust up as a column.
[[emitters]]
shape = "sphere"
position_m = [0, 0.3, 0]
size_m = 0.4
start_s = 0.0
end_s = 0.06
fuel = 3
temperature_k = 1900
smoke = 2.0
velocity_mps = 6
direction = "radial"

# Earth thrown up and outward in a wide cone.
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-impact)

#### smoke\_column.pyro.toml ONE-SHOT · 8.2 x 9.9 m

![First frame of the smoke\_column bake](/bakes/smoke_column/poster.webp)

Smoke left after a burst. It climbs, spreads and thins.

```
[[emitters]]
shape = "sphere"
position_m = [0, 0.8, 0]
size_m = 1.0
start_s = 0.0
end_s = 0.8
fuel = 0
temperature_k = 700
smoke = 6
velocity_mps = 3
direction = "up"
spread_deg = 50
jitter = 0.5
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-smoke_column)

#### fire.pyro.toml LOOP · 4.1 x 7.0 m

![First frame of the fire bake](/bakes/fire/poster.webp)

A steady fire about 1.5 m across, like a burning wreck.

```
[[emitters]]
shape = "disc"
position_m = [0, 0.15, 0]
size_m = 0.7
start_s = 0.0
end_s = 1000
fuel = 6
temperature_k = 1500
smoke = 0.2
velocity_mps = 1.5
direction = "up"
spread_deg = 25
jitter = 0.6
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-fire)

#### fire\_whirl.pyro.toml LOOP · 4.4 x 7.1 m

![First frame of the fire\_whirl bake](/bakes/fire_whirl/poster.webp)

Flames spun into a tall column by a vortex force.

```
# The spin: around the vertical axis, up the whole column, on air and gas alike.
[[forces]]
kind = "vortex"
shape = "box"
position_m = [0, 4, 0]
size_m = [1.3, 4, 1.3]
direction = [0, 1, 0]
strength = 14
max_speed_mps = 4
falloff = 0.4

# Air drawn in at the foot, which is what keeps a real whirl narrow.
[[forces]]
kind = "point"
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-fire_whirl)

#### window\_fire.pyro.toml LOOP · 3.9 x 4.7 m

![First frame of the window\_fire bake](/bakes/window_fire/poster.webp)

A burning room venting flame and smoke through a window. Three obstacles make the building.

```
# The building: fills the back of the box from the floor to the top. Its front is at Z = -0.5,
# which leaves 3 m of open air in front for the flame to roll out into.
[[obstacles]]
shape = "box"
position_m = [0, 4, -1.5]
size_m = [2.5, 4, 1.0]

# The room inside it, with a wall 0.2 m thick in front.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.3, -1.5]
size_m = [1.3, 1.1, 0.8]
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-window_fire)

#### smoke\_plume.pyro.toml LOOP · 7.0 x 10.8 m

![First frame of the smoke\_plume bake](/bakes/smoke_plume/poster.webp)

Chimney or wreck smoke leaning with the wind.

```
[solver]
cooling = 0.25
smoke_fade = 0.45
swirl = 0.8
turbulence = 0.2
turbulence_size_m = 1.2
turbulence_where = "moving"
wind_mps = [1.2, 0, 0]
drag = 0.3
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-smoke_plume)

#### dust\_ring.pyro.toml ONE-SHOT · 10.5 x 2.2 m

![First frame of the dust\_ring bake](/bakes/dust_ring/poster.webp)

A ring of dust kicked out by a blast or landing.

```
[[emitters]]
shape = "ring"
position_m = [0, 0.3, 0]
size_m = 1.5
start_s = 0.0
end_s = 0.15
fuel = 0
temperature_k = 293
smoke = 0
dust = 12
velocity_mps = 14
direction = "radial"
jitter = 0.6
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-dust_ring)

### Explosions

#### staged\_fuel\_explosion.pyro.toml ONE-SHOT · 16 x 18 m

![First frame of the staged\_fuel\_explosion bake](/bakes/staged_fuel_explosion/poster.webp)

A fuel depot going up in stages: flash, main fireball, a second tank half a second later, a dust skirt and hanging smoke.

```
# Stage 1: the flash. Small, very hot, gone in a twentieth of a second.
[[emitters]]
shape = "sphere"
position_m = [0, 0.6, 0]
size_m = 0.6
start_s = 0.0
end_s = 0.05
fuel = 3
temperature_k = 2400
velocity_mps = 9
lumpiness = 0.2

# Stage 2: the main fireball. The fuel is keyed so the ball swells hard, then starves.
[[emitters]]
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-staged_fuel_explosion)

#### chain\_detonation.pyro.toml ONE-SHOT · 20 x 12 m

![First frame of the chain\_detonation bake](/bakes/chain_detonation/poster.webp)

Four charges along a line, a fifth of a second apart, each with its own short shock.

```
[[emitters]]
shape = "sphere"
position_m = [-6, 0.6, 0]
size_m = 0.7
start_s = 0.0
end_s = 0.12
fuel = 5
temperature_k = 1900
smoke = 1.2
dust = 3
velocity_mps = 7

[[emitters]]
shape = "sphere"
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-chain_detonation)

#### airburst.pyro.toml ONE-SHOT · 14 x 16 m

![First frame of the airburst bake](/bakes/airburst/poster.webp)

A shell bursting high in the air with a dark smoke shell. A second view looks up at it from the ground.

```
[[emitters]]
shape = "sphere"
position_m = [0, 8, 0]
size_m = 0.5
start_s = 0.0
end_s = 0.05
fuel = 3
temperature_k = 2400
velocity_mps = 10
lumpiness = 0.2

[[emitters]]
shape = "sphere"
position_m = [0, 8, 0]
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-airburst)

#### vehicle\_cookoff.pyro.toml ONE-SHOT · 10 x 12 m

![First frame of the vehicle\_cookoff bake](/bakes/vehicle_cookoff/poster.webp)

A blast out of a vehicle hatch, then a deck fire that catches, burns and starves. The hull and turret are obstacles, so a model can fill the hole.

```
# The hull, turned 15 degrees so the side view sees some of its length.
[[obstacles]]
shape = "box"
position_m = [0, 0.7, 0]
size_m = [1.6, 0.6, 0.9]
rotation_deg = [0, 15, 0]

# The turret.
[[obstacles]]
shape = "cylinder"
position_m = [0.6, 1.5, 0]
size_m = 0.5
height_m = 0.4
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-vehicle_cookoff)

#### wall\_breach.pyro.toml ONE-SHOT · 10 x 8 m

![First frame of the wall\_breach bake](/bakes/wall_breach/poster.webp)

A breaching charge behind a wall, venting through a carved doorway toward the camera, with dust off the frame and a short jet.

```
# The wall, from floor to ceiling, side to side.
[[obstacles]]
shape = "box"
position_m = [0, 4, 0]
size_m = [5, 4, 0.25]

# The doorway through it.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.1, 0]
size_m = [0.8, 1.1, 0.4]
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-wall_breach)

#### incendiary\_strike\_line.pyro.toml ONE-SHOT · 18 x 10 m

![First frame of the incendiary\_strike\_line bake](/bakes/incendiary_strike_line/poster.webp)

A fast moving source that lays an unbroken wall of fire along a road, which burns off into a low line of smoke.

```
# The strike: a fast moving source that leaves its gas behind as a trail.
[[emitters]]
shape = "sphere"
position_m = [[0.0, -7.5, 0.5, 0], [0.8, 7.5, 0.5, 0]]
size_m = 0.5
start_s = 0.0
end_s = 0.8
fuel = 8
temperature_k = 1700
smoke = 0.5
velocity_mps = 2
direction = "up"
spread_deg = 60
inherit_velocity = 0.15
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-incendiary_strike_line)

#### rising\_cap\_burst.pyro.toml ONE-SHOT · 16 x 24 m

![First frame of the rising\_cap\_burst bake](/bakes/rising_cap_burst/poster.webp)

A very large burst that rises as a cap on a stem of gathered dust, with a ground ring.

```
[[emitters]]
shape = "sphere"
position_m = [0, 1.4, 0]
size_m = 1.6
start_s = 0.0
end_s = 0.3
fuel = 6
temperature_k = 2000
smoke = 2.0
velocity_mps = 7
lumpiness = 0.6

# Dust thrown up by the blast, which the pull at the foot gathers into a stem.
[[emitters]]
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-rising_cap_burst)

### Fire

#### wreck\_fire\_hull.pyro.toml LOOP · 8 x 10 m

![First frame of the wreck\_fire\_hull bake](/bakes/wreck_fire_hull/poster.webp)

Deck flames and a fuel pool burning around a wrecked hull, leaning with a light wind. The hull and turret are obstacles.

```
[[obstacles]]
shape = "box"
position_m = [0, 0.75, 0]
size_m = [1.8, 0.55, 0.9]
rotation_deg = [0, 20, 0]

[[obstacles]]
shape = "cylinder"
position_m = [0.8, 1.5, 0]
size_m = 0.5
height_m = 0.4
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-wreck_fire_hull)

#### spreading\_ground\_fire.pyro.toml ONE-SHOT · 16 x 8 m

![First frame of the spreading\_ground\_fire bake](/bakes/spreading_ground_fire/poster.webp)

A fire front running 12 m along the ground, with a smoldering strip that grows behind it. A second view looks down from above.

```
# The fire front.
[[emitters]]
shape = "disc"
position_m = [[0.0, -6, 0.15, 0], [5.0, 6, 0.15, 0]]
size_m = 0.6
thickness_m = 0.05
start_s = 0.0
end_s = 5.0
fuel = 6
temperature_k = 1500
smoke = 0.4
velocity_mps = 1.2
direction = "up"
spread_deg = 25
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-spreading_ground_fire)

#### gas\_flare\_stack.pyro.toml LOOP · 8 x 14 m

![First frame of the gas\_flare\_stack bake](/bakes/gas_flare_stack/poster.webp)

A flare at the top of a tall stack, bent by the wind and torn by gusts. The stack is a carved cylinder.

```
[[obstacles]]
shape = "cylinder"
position_m = [-1.5, 4, 0]
size_m = 0.35
height_m = 8

# The bore.
[[obstacles]]
shape = "cylinder"
carve = true
position_m = [-1.5, 4.1, 0]
size_m = 0.22
height_m = 8.2
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-gas_flare_stack)

#### campfire\_logs.pyro.toml LOOP · 3 x 4.5 m

![First frame of the campfire\_logs bake](/bakes/campfire_logs/poster.webp)

A campfire on three crossed logs, with small tongues licking along each one.

```
# Three logs, tipped onto their side (90 about X) and turned 0, 60 and 120 degrees about Y.
[[obstacles]]
shape = "capsule"
position_m = [0, 0.1, 0]
size_m = 0.08
height_m = 0.9
rotation_deg = [90, 0, 0]

[[obstacles]]
shape = "capsule"
position_m = [0, 0.1, 0]
size_m = 0.08
height_m = 0.9
rotation_deg = [90, 60, 0]
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-campfire_logs)

#### two\_window\_house\_fire.pyro.toml LOOP · 6 x 9 m

![First frame of the two\_window\_house\_fire bake](/bakes/two_window_house_fire/poster.webp)

A ground floor room fire rolling out of two windows and up the front, past a dark upper window.

```
# The building: front face at Z = -0.4, leaving open air in front for the flame.
[[obstacles]]
shape = "box"
position_m = [0, 3.0, -1.6]
size_m = [2.8, 3.0, 1.2]

# The ground floor room.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.4, -1.6]
size_m = [2.4, 1.2, 0.9]
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-two_window_house_fire)

#### jet\_fire\_leak.pyro.toml LOOP · 10 x 7 m

![First frame of the jet\_fire\_leak bake](/bakes/jet_fire_leak/poster.webp)

Burning gas jetting sideways from a broken pipe, flapping as it slows.

```
[[obstacles]]
shape = "cylinder"
position_m = [-3, 1.0, 0]
size_m = 0.2
height_m = 4
rotation_deg = [0, 0, 90]

[[obstacles]]
shape = "cylinder"
carve = true
position_m = [-3, 1.0, 0]
size_m = 0.12
height_m = 4.2
rotation_deg = [0, 0, 90]
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-jet_fire_leak)

### Smoke

#### chimney\_shifting\_wind.pyro.toml ONE-SHOT · 14 x 16 m

![First frame of the chimney\_shifting\_wind bake](/bakes/chimney_shifting_wind/poster.webp)

Chimney smoke while the wind picks up, swings round and drops, so the plume leans one way and then another. A second view looks down from above.

```
# The chimney, with its flue carved out.
[[obstacles]]
shape = "box"
position_m = [-3, 3, 0]
size_m = [0.5, 3, 0.5]

[[obstacles]]
shape = "box"
carve = true
position_m = [-3, 3.2, 0]
size_m = [0.3, 3.1, 0.3]
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-chimney_shifting_wind)

#### pipe\_vent\_smoke.pyro.toml LOOP · 10 x 8 m

![First frame of the pipe\_vent\_smoke bake](/bakes/pipe_vent_smoke/poster.webp)

Smoke pushed along a pipe bore by a fan and out of the open end, where it rises. The emitter sits inside the carved bore.

```
[[obstacles]]
shape = "cylinder"
position_m = [-2.5, 1.2, 0]
size_m = 0.35
height_m = 4
rotation_deg = [0, 0, 90]

# The bore, open at both ends.
[[obstacles]]
shape = "cylinder"
carve = true
position_m = [-2.5, 1.2, 0]
size_m = 0.25
height_m = 4.4
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-pipe_vent_smoke)

#### smoke\_under\_sliding\_slab.pyro.toml ONE-SHOT · 12 x 6 m

![First frame of the smoke\_under\_sliding\_slab bake](/bakes/smoke_under_sliding_slab/poster.webp)

A low smoke pool pushed and dragged by a solid sliding over it, as under a hover vehicle or a closing blast door.

```
# The slab waits, then slides 8 m along X a metre above the floor.
[[obstacles]]
shape = "box"
position_m = [[0, -5, 1, 0], [1.2, -5, 1, 0], [3.2, 3, 1, 0]]
size_m = [1.6, 0.1, 1.6]

# The smoke pool: cool, slow, low.
[[emitters]]
shape = "box"
position_m = [-2, 0.25, 0]
size_m = [1.5, 0.2, 1.2]
start_s = 0.0
end_s = 1.0
fuel = 0
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-smoke_under_sliding_slab)

#### signal\_smoke\_puffs.pyro.toml ONE-SHOT · 8 x 12 m

![First frame of the signal\_smoke\_puffs bake](/bakes/signal_smoke_puffs/poster.webp)

Red signal smoke from a canister in four puffs, switched on and off with step keys and carried off by a light wind.

```
# The canister.
[[obstacles]]
shape = "cylinder"
position_m = [-1.5, 0.125, 0]
size_m = 0.08
height_m = 0.25

[[emitters]]
shape = "disc"
position_m = [-1.5, 0.32, 0]
size_m = 0.12
thickness_m = 0.03
start_s = 0.0
end_s = 4.0
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-signal_smoke_puffs)

#### sheared\_blast\_column.pyro.toml ONE-SHOT · 16 x 18 m

![First frame of the sheared\_blast\_column bake](/bakes/sheared_blast_column/poster.webp)

The smoke column after a blast, bent off at its head by wind that picks up aloft after a second and a half.

```
[[emitters]]
shape = "sphere"
position_m = [-4, 0.8, 0]
size_m = 1.0
start_s = 0.0
end_s = 0.8
fuel = 0
temperature_k = 700
smoke = 6
velocity_mps = 3
direction = "up"
spread_deg = 50
jitter = 0.5
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-sheared_blast_column)

#### vortex\_smoke\_loft.pyro.toml LOOP · 8 x 14 m

![First frame of the vortex\_smoke\_loft bake](/bakes/vortex_smoke_loft/poster.webp)

Smoke and dust drawn off a burnt field into a slow spinning column by a vortex and a pull at its foot.

```
[[emitters]]
shape = "ring"
position_m = [0, 0.2, 0]
size_m = 1.2
thickness_m = 0.12
start_s = 0.0
end_s = 1000
fuel = 0
temperature_k = 420
smoke = 3
dust = 1.5
velocity_mps = 0.6
direction = "up"
spread_deg = 30
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-vortex_smoke_loft)

### Impact and dust

#### mortar\_crater.pyro.toml ONE-SHOT · 10 x 8 m

![First frame of the mortar\_crater bake](/bakes/mortar_crater/poster.webp)

A heavy mortar round on dirt: flash, earth cone, fast skirt, slower rolling rim and a short shock.

```
# The flash. Little fuel and short, so it does not carry the dust up as a column.
[[emitters]]
shape = "sphere"
position_m = [0, 0.3, 0]
size_m = 0.45
start_s = 0.0
end_s = 0.06
fuel = 3
temperature_k = 2000
smoke = 2.0
velocity_mps = 7
direction = "radial"

# Earth thrown up and outward.
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-mortar_crater)

#### dropship\_landing.pyro.toml ONE-SHOT · 16 x 8 m

![First frame of the dropship\_landing bake](/bakes/dropship_landing/poster.webp)

A hull settling to the ground while its downwash blasts a ring of dust outward. The hull is a moving obstacle.

```
# The hull, lying along X, coming down from 6 m to 2 m.
[[obstacles]]
shape = "capsule"
position_m = [[0, 0, 6, 0], [2, 0, 2.2, 0], [2.6, 0, 2, 0]]
size_m = 1.0
height_m = 3
rotation_deg = [0, 0, 90]

# The downwash under the hull. It follows the hull down and grows stronger near the ground.
[[forces]]
kind = "push"
shape = "box"
position_m = [[0, 0, 3.8, 0], [2, 0, 1, 0], [2.6, 0, 0.8, 0]]
size_m = [2, 0.6, 2]
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-dropship_landing)

#### collapse\_dust\_surge.pyro.toml ONE-SHOT · 14 x 9 m

![First frame of the collapse\_dust\_surge bake](/bakes/collapse_dust_surge/poster.webp)

A building sinking into the ground in a surge of dust from its foot and its roof. The block is a moving obstacle.

```
# The building: stands for 0.4 s, then sinks 5 m in 2 s.
[[obstacles]]
shape = "box"
position_m = [[0, 0, 2.5, 0], [0.4, 0, 2.5, 0], [2.4, 0, -2.6, 0]]
size_m = [1.5, 2.5, 1.5]
end_s = 2.6

# The surge from the foot, clear of the corners of the block.
[[emitters]]
shape = "ring"
position_m = [0, 0.3, 0]
size_m = 2.3
thickness_m = 0.2
start_s = 0.5
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-collapse_dust_surge)

#### strafing\_dust\_line.pyro.toml ONE-SHOT · 16 x 5 m

![First frame of the strafing\_dust\_line bake](/bakes/strafing_dust_line/poster.webp)

Six dust spouts walking along the ground a tenth of a second apart.

```
[[emitters]]
shape = "sphere"
position_m = [-6.5, 0.15, 0]
size_m = 0.15
start_s = 0.0
end_s = 0.06
fuel = 0
temperature_k = 293
dust = 14
velocity_mps = 9
direction = "up"
spread_deg = 35
jitter = 0.6
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-strafing_dust_line)

#### meteor\_strike.pyro.toml ONE-SHOT · 14 x 12 m

![First frame of the meteor\_strike bake](/bakes/meteor_strike/poster.webp)

A burning body streaking down at a steep angle and striking the ground: trail, flash, thrown earth, dust ring and shock.

```
# The incoming body: 12 m of travel in half a second, leaving its gas behind as a trail.
[[emitters]]
shape = "sphere"
position_m = [[0.0, -6, 11, -2], [0.5, 0, 0.7, 0]]
size_m = 0.35
start_s = 0.0
end_s = 0.5
fuel = 4
temperature_k = 2200
smoke = 1.0
velocity_mps = 0.5
inherit_velocity = 0.1
lumpiness = 0.3
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-meteor_strike)

#### mech\_footfall.pyro.toml ONE-SHOT · 10 x 6 m

![First frame of the mech\_footfall bake](/bakes/mech_footfall/poster.webp)

A giant walker's foot coming down on dry ground and throwing a ring of dust at the moment it lands.

```
# The foot: 3 m up, planted at 0.35 s.
[[obstacles]]
shape = "box"
position_m = [[0.0, 0, 3.0, 0], [0.35, 0, 0.32, 0]]
size_m = [0.8, 0.3, 1.1]

# The ring at contact, just outside the corners of the foot.
[[emitters]]
shape = "ring"
position_m = [0, 0.2, 0]
size_m = 1.6
thickness_m = 0.12
start_s = 0.35
end_s = 0.45
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-mech_footfall)

### Environmental

#### steam\_under\_hull.pyro.toml LOOP · 12 x 7 m

![First frame of the steam\_under\_hull bake](/bakes/steam_under_hull/poster.webp)

Steam from floor vents hitting the curved underside of a ship's hull, running along it and spilling past the sides.

```
[[obstacles]]
shape = "capsule"
position_m = [0, 2.6, 0]
size_m = 1.2
height_m = 7
rotation_deg = [0, 0, 90]

# Four vents in the floor under the hull.
[[emitters]]
shape = "points"
position_m = [0, 0.3, 0]
size_m = 0.15
points_m = [[-3, 0, 0], [-1, 0, 0.3], [1, 0, -0.3], [3, 0, 0]]
start_s = 0.0
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-steam_under_hull)

#### courtyard\_smoke.pyro.toml LOOP · 12 x 12 m

![First frame of the courtyard\_smoke bake](/bakes/courtyard_smoke/poster.webp)

Smoke pooling in a walled courtyard and spilling over the downwind wall where a breeze crosses the top.

```
# The walls: a block 8 m square and 3 m high...
[[obstacles]]
shape = "box"
position_m = [0, 1.5, 0]
size_m = [4, 1.5, 4]

# ...with the courtyard carved out of it, open to the sky, leaving a 0.1 m floor.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.7, 0]
size_m = [3.6, 1.6, 3.6]
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-courtyard_smoke)

#### canyon\_wind\_plume.pyro.toml LOOP · 16 x 10 m

![First frame of the canyon\_wind\_plume bake](/bakes/canyon_wind_plume/poster.webp)

A plume streaming along a canyon between two cliffs. The near cliff has holdout off, so the side view sees through it.

```
# The far cliff.
[[obstacles]]
shape = "box"
position_m = [0, 4, -3.0]
size_m = [8, 4, 1.5]

# The near cliff, between the camera and the smoke.
[[obstacles]]
shape = "box"
position_m = [0, 3, 3.2]
size_m = [8, 3, 1.5]
holdout = false
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-canyon_wind_plume)

#### doorway\_smoke\_holdout.pyro.toml LOOP · 8 x 6 m

![First frame of the doorway\_smoke\_holdout bake](/bakes/doorway_smoke_holdout/poster.webp)

Smoke from a smoldering room leaking out of the top of its doorway and climbing the wall. The building holds out the room.

```
[[obstacles]]
shape = "box"
position_m = [0, 2.5, -2.0]
size_m = [3, 2.5, 1.5]

[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.4, -2.0]
size_m = [2.7, 1.2, 1.2]
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-doorway_smoke_holdout)

#### fan\_pulled\_plume.pyro.toml LOOP · 10 x 8 m

![First frame of the fan\_pulled\_plume bake](/bakes/fan_pulled_plume/poster.webp)

A plume drawn sideways into a big extraction fan with two spinning blades and a push through its shroud.

```
# The shroud, its axis along X.
[[obstacles]]
shape = "cylinder"
position_m = [3, 2.5, 0]
size_m = 0.9
height_m = 0.4
rotation_deg = [0, 0, 90]

[[obstacles]]
shape = "cylinder"
carve = true
position_m = [3, 2.5, 0]
size_m = 0.8
height_m = 0.5
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-fan_pulled_plume)

#### rooftop\_vents\_wind.pyro.toml LOOP · 12 x 8 m

![First frame of the rooftop\_vents\_wind bake](/bakes/rooftop_vents_wind/poster.webp)

Exhaust from three roof vents, fed by one points emitter, streaming off in a gusty crosswind.

```
# The roof, 2 m up.
[[obstacles]]
shape = "box"
position_m = [0, 1, 0]
size_m = [6, 1, 4]

[[obstacles]]
shape = "cylinder"
position_m = [-3, 2.4, -1]
size_m = 0.2
height_m = 0.8
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-rooftop_vents_wind)

### Stylized

#### cold\_blue\_fire.pyro.toml LOOP · 5 x 7 m

![First frame of the cold\_blue\_fire bake](/bakes/cold_blue_fire/poster.webp)

A blue flame ramp with a slow curl, for a frost spell or a spirit flame. The flame is ordinary burning gas with a different color ramp.

```
[[emitters]]
shape = "disc"
position_m = [0, 0.15, 0]
size_m = 0.55
start_s = 0.0
end_s = 1000
fuel = 6
temperature_k = 1500
smoke = 0.1
velocity_mps = 1.5
direction = "up"
spread_deg = 25
jitter = 0.6
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-cold_blue_fire)

#### alchemical\_cauldron.pyro.toml LOOP · 5 x 6 m

![First frame of the alchemical\_cauldron bake](/bakes/alchemical_cauldron/poster.webp)

Low green flames over a cauldron and a heavy green vapor, made of dust, pouring over the rim and across the floor.

```
# The pot: a sphere, hollowed out, with its top cut off.
[[obstacles]]
shape = "sphere"
position_m = [0, 0.55, 0]
size_m = 0.6

[[obstacles]]
shape = "sphere"
carve = true
position_m = [0, 0.62, 0]
size_m = 0.52
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-alchemical_cauldron)

#### ember\_brazier.pyro.toml LOOP · 3 x 4.5 m

![First frame of the ember\_brazier bake](/bakes/ember_brazier/poster.webp)

Low, ember-warm fire in a brazier bowl: a deep red to amber ramp and strong glow in the smoke above it.

```
# The bowl, the hollow inside it, and the stand.
[[obstacles]]
shape = "cylinder"
position_m = [0, 0.75, 0]
size_m = 0.45
height_m = 0.5

[[obstacles]]
shape = "cylinder"
carve = true
position_m = [0, 0.9, 0]
size_m = 0.38
height_m = 0.5
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-ember_brazier)

#### violet\_portal\_swirl.pyro.toml LOOP · 6 x 6 m

![First frame of the violet\_portal\_swirl bake](/bakes/violet_portal_swirl/poster.webp)

An upright ring of violet flame swirled about its center by a vortex, for a portal or a summoning circle.

```
# The ring, turned 90 degrees about X so it stands in the plane the front view faces.
[[emitters]]
shape = "ring"
position_m = [0, 2.5, 0]
size_m = 1.4
thickness_m = 0.12
rotation_deg = [90, 0, 0]
start_s = 0.0
end_s = 1000
fuel = 2
temperature_k = 1300
smoke = 0.3
velocity_mps = 0
jitter = 0.4
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-violet_portal_swirl)

#### shadow\_flame.pyro.toml LOOP · 5 x 7 m

![First frame of the shadow\_flame bake](/bakes/shadow_flame/poster.webp)

A dark, sooty flame with a deep red ramp and black smoke hanging in a hood above it, held by a drag pocket.

```
[[emitters]]
shape = "disc"
position_m = [0, 0.15, 0]
size_m = 0.5
start_s = 0.0
end_s = 1000
fuel = 7
temperature_k = 1400
smoke = 0.8
velocity_mps = 1.2
direction = "up"
spread_deg = 25
jitter = 0.6
# ...
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-shadow_flame)

#### spirit\_wisp\_trail.pyro.toml ONE-SHOT · 10 x 7 m

![First frame of the spirit\_wisp\_trail bake](/bakes/spirit_wisp_trail/poster.webp)

A small teal flame weaving on an eased path and leaving a fading trail of gas, not particles.

```
[[emitters]]
shape = "sphere"
position_m = [[0, -4, 1, 0], [1, -2, 2.2, 1.2], [2, 0, 1.6, -1], [3, 2, 2.6, 0.8], [4, 4, 2, 0]]
size_m = 0.18
start_s = 0.0
end_s = 4.0
fuel = 1.5
temperature_k = 1500
smoke = 0.4
velocity_mps = 0.3
inherit_velocity = 0.2
lumpiness = 0.2
```

[Full spec →](https://appliedmanifold.com/docs/pyrofx/examples/#ex-spirit_wisp_trail)

Start a new effect from the nearest example. [Examples →](https://appliedmanifold.com/docs/pyrofx/examples/)

Adjust any example with sliders and see its draft price before you sign up. [Open the Playground →](https://appliedmanifold.com/playground/)

Each engine has its own fire, smoke, explosion and dust pages, with the same compiles. [Browse effects →](https://appliedmanifold.com/effects/)

## Godot 4

`flipbook_6way.gdshader` lights the smoke from the scene's sun and ambient, adds the flame as HDR light, blends frames along motion vectors and fades against scene depth.

The `wire` tool installs the shader, sets texture imports and writes a ready scene. Compile into the project folder, then call:

MCP calls

```
bake {"spec": "<name>.pyro.toml", "out": "<dir>", "quality": "final"}
wire {"bake_dir": "<dir>", "scene": "<path>.tscn"}
```

The root is a quad in meters, origin on the ground. Instance it and it plays.

Download a Godot 4 project with the official fire and fireball already wired in. Open the folder and press Play. You do not need an API key to watch them.

[Download the Godot 4 sample](https://appliedmanifold.com/downloads/spatial-compiler-godot-sample.zip)

![The sample project running in Godot 4, with a looping fire on the left and a fireball on the right.](/proof/godot-sample/screenshot.webp)

The sample after you press Play: fire on the left, fireball on the right.

Compile the same spec twice and you get the same sheets back. [Same spec, same result](https://appliedmanifold.com/docs/pyrofx/same-result/)

## Agent loop

1.  Copy the nearest example and call `check`. Errors name the key and the valid range.
2.  Compile at draft quality. Change the key each warning names.
3.  Open `preview_strip.png` and judge the look.
4.  `sweep` compiles up to 16 variants of a spec, each as a whole compile with its own report.
5.  Compile at final quality until `"ok": true` and `warnings` is empty, then wire it into Godot 4 or play the sheets in three.js.

## Questions

### What does pyrofx produce from a spec?

It compiles fire, smoke, explosion and dust flipbook sheets lit from six directions, plus preview images and a JSON report.

### What does six way lighting mean in pyrofx?

Six way lighting packs six directional light channels into the output sheets so your shader can relight the effect at runtime.

### Which engines can play pyrofx sprite sheets?

pyrofx targets Godot and three.js and any engine that samples flipbook sheets can load the exported textures and layout data.

### Are pyrofx compiles deterministic?

Yes. Running the same spec, seed and quality produces the same output, while changing the seed creates a new variation.

### What does a pyrofx compile cost?

A draft compile starts at $0.05 and a final compile starts at $0.10, while variants start at $0.025 each.
