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 or read the Godot pool settings.

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

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
Soil kick-up. Compiled with Spatial Compiler. Full report.
Masonry kick-up, a frame from the final hosted compile
Masonry kick-up. Compiled with Spatial Compiler. Full report.
Turned solid, a frame from the final hosted compile
Turned solid. Compiled with Spatial Compiler. Full report.

The 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 → Material presets →

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 → 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 →

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
Impact, 3.5 x 2.8 m, compiled with Spatial Compiler. Spec →

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
Fire whirl, 4.4 x 7.1 m, compiled with Spatial Compiler. Spec →

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
Window fire, 3.9 x 4.7 m, compiled with Spatial Compiler. Spec →

holdout (default on) hides gas behind the solid. shadow (default on) darkens gas in its shade. Obstacles →

Examples

Starters

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

First frame of the fireball bake

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 →

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

First frame of the impact bake

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 →

smoke_column.pyro.toml ONE-SHOT · 8.2 x 9.9 m

First frame of the smoke_column bake

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 →

fire.pyro.toml LOOP · 4.1 x 7.0 m

First frame of the fire bake

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 →

fire_whirl.pyro.toml LOOP · 4.4 x 7.1 m

First frame of the fire_whirl bake

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 →

window_fire.pyro.toml LOOP · 3.9 x 4.7 m

First frame of the window_fire bake

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 →

smoke_plume.pyro.toml LOOP · 7.0 x 10.8 m

First frame of the smoke_plume bake

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 →

dust_ring.pyro.toml ONE-SHOT · 10.5 x 2.2 m

First frame of the dust_ring bake

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 →

Explosions

staged_fuel_explosion.pyro.toml ONE-SHOT · 16 x 18 m

First frame of the staged_fuel_explosion bake

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 →

chain_detonation.pyro.toml ONE-SHOT · 20 x 12 m

First frame of the chain_detonation bake

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 →

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

First frame of the airburst bake

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 →

vehicle_cookoff.pyro.toml ONE-SHOT · 10 x 12 m

First frame of the vehicle_cookoff bake

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 →

wall_breach.pyro.toml ONE-SHOT · 10 x 8 m

First frame of the wall_breach bake

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 →

incendiary_strike_line.pyro.toml ONE-SHOT · 18 x 10 m

First frame of the incendiary_strike_line bake

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 →

rising_cap_burst.pyro.toml ONE-SHOT · 16 x 24 m

First frame of the rising_cap_burst bake

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 →

Fire

wreck_fire_hull.pyro.toml LOOP · 8 x 10 m

First frame of the wreck_fire_hull bake

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 →

spreading_ground_fire.pyro.toml ONE-SHOT · 16 x 8 m

First frame of the spreading_ground_fire bake

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 →

gas_flare_stack.pyro.toml LOOP · 8 x 14 m

First frame of the gas_flare_stack bake

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 →

campfire_logs.pyro.toml LOOP · 3 x 4.5 m

First frame of the campfire_logs bake

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 →

two_window_house_fire.pyro.toml LOOP · 6 x 9 m

First frame of the two_window_house_fire bake

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 →

jet_fire_leak.pyro.toml LOOP · 10 x 7 m

First frame of the jet_fire_leak bake

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 →

Smoke

chimney_shifting_wind.pyro.toml ONE-SHOT · 14 x 16 m

First frame of the chimney_shifting_wind bake

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 →

pipe_vent_smoke.pyro.toml LOOP · 10 x 8 m

First frame of the pipe_vent_smoke bake

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 →

smoke_under_sliding_slab.pyro.toml ONE-SHOT · 12 x 6 m

First frame of the smoke_under_sliding_slab bake

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 →

signal_smoke_puffs.pyro.toml ONE-SHOT · 8 x 12 m

First frame of the signal_smoke_puffs bake

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 →

sheared_blast_column.pyro.toml ONE-SHOT · 16 x 18 m

First frame of the sheared_blast_column bake

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 →

vortex_smoke_loft.pyro.toml LOOP · 8 x 14 m

First frame of the vortex_smoke_loft bake

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 →

Impact and dust

mortar_crater.pyro.toml ONE-SHOT · 10 x 8 m

First frame of the mortar_crater bake

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 →

dropship_landing.pyro.toml ONE-SHOT · 16 x 8 m

First frame of the dropship_landing bake

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 →

collapse_dust_surge.pyro.toml ONE-SHOT · 14 x 9 m

First frame of the collapse_dust_surge bake

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 →

strafing_dust_line.pyro.toml ONE-SHOT · 16 x 5 m

First frame of the strafing_dust_line bake

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 →

meteor_strike.pyro.toml ONE-SHOT · 14 x 12 m

First frame of the meteor_strike bake

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 →

mech_footfall.pyro.toml ONE-SHOT · 10 x 6 m

First frame of the mech_footfall bake

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 →

Environmental

steam_under_hull.pyro.toml LOOP · 12 x 7 m

First frame of the steam_under_hull bake

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 →

courtyard_smoke.pyro.toml LOOP · 12 x 12 m

First frame of the courtyard_smoke bake

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 →

canyon_wind_plume.pyro.toml LOOP · 16 x 10 m

First frame of the canyon_wind_plume bake

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 →

doorway_smoke_holdout.pyro.toml LOOP · 8 x 6 m

First frame of the doorway_smoke_holdout bake

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 →

fan_pulled_plume.pyro.toml LOOP · 10 x 8 m

First frame of the fan_pulled_plume bake

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 →

rooftop_vents_wind.pyro.toml LOOP · 12 x 8 m

First frame of the rooftop_vents_wind bake

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 →

Stylized

cold_blue_fire.pyro.toml LOOP · 5 x 7 m

First frame of the cold_blue_fire bake

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 →

alchemical_cauldron.pyro.toml LOOP · 5 x 6 m

First frame of the alchemical_cauldron bake

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 →

ember_brazier.pyro.toml LOOP · 3 x 4.5 m

First frame of the ember_brazier bake

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 →

violet_portal_swirl.pyro.toml LOOP · 6 x 6 m

First frame of the violet_portal_swirl bake

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 →

shadow_flame.pyro.toml LOOP · 5 x 7 m

First frame of the shadow_flame bake

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 →

spirit_wisp_trail.pyro.toml ONE-SHOT · 10 x 7 m

First frame of the spirit_wisp_trail bake

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 →

Start a new effect from the nearest example. Examples →

Adjust any example with sliders and see its draft price before you sign up. Open the Playground →

Each engine has its own fire, smoke, explosion and dust pages, with the same compiles. Browse 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

The sample project running in Godot 4, with a looping fire on the left and a fireball on the right.
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

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.