Wind

Environmental reference

FXMaster+Filter effectAPI type: wind

Preview

Preview shows Wind and Summer Leaves enabled together, with Wind in Manual Painting mode

Map maker

Map:Angela's Maps

Canvas-locked wind distortion with turbulence, gusts, streaks, synchronized direction, and manual painting.

Environmental filters change the Scene surface or atmosphere. They can cover the full Scene, be limited to Regions, and be moved within the effect stack.

Reference	Value
Package	FXMaster+
Effect kind	Filter effect
Category	Environmental
Runtime type	wind
Exposed parameters	28

Procedural and painted Wind

Wind can run across the complete Scene or Region, or it can be limited to a painted mask.

Procedural Wind

Start with Direction, Speed, and Density. Then use Scale and Opacity to set the overall coverage. Distortion, Turbulence, Sway Strength, Sway Frequency, Gustiness, Streakiness, and Highlight shape the movement and visible detail.

Direction Randomization adds variation around the base direction. Direction Change Radius sets the allowed range, and Time Between Direction Changes controls how often a new target is selected.

Manual Painting

Enable Manual Painting to create a movement mask. Brush Radius (Grid Spaces) controls the painted area, while the Painting actions add to, erase, or clear the mask. This can work well for wind passing through a doorway, moving around a large obstruction, following a canyon, or remaining on one side of a Region.

See Wind Painting for the complete painting workflow.

Synchronized direction

Wind can act as the direction source for compatible effects. Enable Synchronized Direction on a supported particle or filter to follow Wind’s direction changes while retaining its own speed, scale, density, and appearance.

Important controls

• Manual Painting: Restrict movement to painted areas while leaving the subtle visible wind sheen across the full Scene or Region.
• Direction: Sets the base direction of the wind movement.
• Direction Randomization: Randomly shifts the effect direction over time. At 1, the direction can randomize anywhere around the full compass.
• Turbulence: Irregular movement inside painted Manual Painting areas. Higher values create rougher local motion.
• Gustiness: Adds larger shared pulses in wind speed so the effect accelerates and eases instead of remaining constant.
• Streakiness: Controls how strongly the wind appears as long directional streaks.
• Highlight: Controls the brightness of the subtle moving highlight used to make the wind visible.

Setup notes

• Manual Painting opens the Wind painting tools. Brush Radius (Grid Spaces) controls the paint area, and the Painting actions add, erase, or clear the mask.
• Direction Randomization and Time Between Direction Changes create evolving wind, while Sway, Turbulence, Gustiness, Streakiness, and Highlight shape its appearance.
• Wind can drive Synchronized Direction on compatible particle and filter effects.

Bundled preset usage

Preset	API name	Availability	Variants
Arcane Winds	arcane-winds	FXMaster+	Normal
Gravewind	gravewind	FXMaster+	Normal
Windy	windy	FXMaster+	Normal

Parameters

The table combines the settings available for this effect in Scene and Region contexts. Scene-only and Region-only badges identify controls limited to one context. Hover or focus an info button to see what the parameter changes on the canvas. Select it to keep the card open. Each card also includes the default, range or choices, context, availability, API key, and control type.

28 exposed parameters1 Scene-only1 Region-onlywind API type

iHover or focus an info button to see what the parameter changes on the canvas. Select it to keep the card open. Context badges identify Scene-only and Region-only controls; unbadged parameters are available in both. Hover or focus an availability condition to highlight the parameter that controls it.

Parameter	Control	Default	Range or choices	Availability
Below Tokensi belowTokens	checkbox	Off	—	Always
Below Tilesi belowTiles	checkbox	Off	—	Always
Below Foregroundi belowForeground	checkbox	Off	—	Always
Levelsi levelsScene only	scene-levels	All Levels	—	Always
Manual Paintingi manualPlacement	checkbox	Off	—	Always
Distortioni distortion	range	0.35	0–1 · step 0.05	Shown when Manual Painting = On
Turbulencei turbulence	range	0.2	0–1 · step 0.05	Shown when Manual Painting = On
Sway Strengthi swayStrength	range	0.25	0–1 · step 0.05	Shown when Manual Painting = On
Sway Frequencyi swayFrequency	range	0.32	0–1 · step 0.01	Shown when Manual Painting = On
Brush Radius (Grid Spaces)i manualPaintBrushSize	range	1.25	0.1–8 · step 0.05	Shown when Manual Painting = On
Paintingi manualPaintActions	filter-actions		—	Shown when Manual Painting = On
Highlight Tinti color	color	#dfefff (enabled)	—	Always
Sound FXi soundFxEnabled	checkbox	Off	—	Always
Sound FX Soundsi soundFxManualSoundIds	multi-select	Rule default	—	Shown when Sound FX = On and the matching enabled SoundFX rule uses Multi-Sound Mode = Manual with at least two configured sounds
Scalei dimensions	range	0.26	0–1 · step 0.01	Always
Speedi speed	range	0.2	0.05–1 · step 0.05	Always
Densityi density	range	0.25	0–1 · step 0.05	Always
Direction Randomizationi directionRandomization	range	0	0–1 · step 0.01	Always
Direction Change Radiusi directionRandomizationRadius	range	1	0–1 · step 0.01	Shown when Direction Randomization > 0
Time Between Direction Changesi directionChangeTime	range	8	1–60 · step 0.5	Shown when Direction Randomization > 0
Gustinessi gustiness	range	0.45	0–1 · step 0.05	Always
Streakinessi streakiness	range	0.6	0–1 · step 0.05	Always
Highlighti sheenStrength	range	0.2	0–1 · step 0.05	Always
Opacityi opacity	range	1	0–1 · step 0.05	Always
Directioni direction	range	0	0–360 · step 5	Always
Darkness Activationi darknessActivationEnabled	checkbox	Off	—	Always
Darkness Activation Rangei darknessActivationRange	range-dual	{"min":0,"max":1}	0–1 · step 0.01	Shown when Darkness Activation = On
Edge Fade %i fadePercentRegion only	range	0	0–1 · step 0.01	Always

Direct-effect API example

The Direct Effect API creates a separate row shown through Manage API Effects. Add a stable apiMacro_…_p or apiMacro_…_f ID when later macro calls need to update or stop the same row.

const created = await FXMASTER.api.effects.play({
  filters: [{
    "id": "apiMacro_wikiwind_f",
    "type": "wind",
    "options": {
      "manualPlacement": false,
      "direction": 180,
      "speed": 0.4,
      "density": 0.55,
      "turbulence": 0.5,
      "gustiness": 0.45
    }
  }],
});

await FXMASTER.api.effects.filters.stop(created.filters);

For complete API behavior, scene targeting, stack ordering, and toggle groups, see the Direct Effect API guide.