Sakura Blossoms

Ambient reference

FXMaster+Particle effectAPI type: sakurablossoms

Preview

Preview shows Sakura Blossoms with Background and Token Trails enabled

Map maker

Map:Moonlight Maps

Sakura petals with ambient, directional, Top Down, and Orbit movement, an optional settled Background, and token trails.

Ambient effects add visible movement without replacing the full weather setup. Use them on their own or layer them with another particle or filter.

Reference	Value
Package	FXMaster+
Effect kind	Particle effect
Category	Ambient
Runtime type	sakurablossoms
Exposed parameters	37

Blossom ambience and ground coverage

Sakura Blossoms includes ambient drifting, Directional Movement, Top Down, and Orbit presentations. It also includes the movement modes previously provided by Sakura Bloom.

Within an enabled Sakura Blossoms effect, the drifting blossom layer and optional persistent Background accumulation are configured separately. Background is not standalone; disabling Sakura Blossoms disables both layers. The airborne layer uses Scale, Speed, Lifetime, Density, and Opacity, while Background has its own fill and appearance controls.

Movement modes

Leave Directional Movement, Top Down, and Orbit off for ambient drifting. Enable Directional Movement for a travelling stream of petals, then adjust Direction or enable Synchronized Direction to follow Wind or Duststorm. Top Down uses overhead motion with Rotation Strength; Orbit uses circular motion with Orbit Distance. Orbit and Top Down are mutually exclusive.

Background and trails

Background controls fill timing, opacity, coverage, variation, pile amount, pile size, and Ground Particle Size. Token Trails controls the affected radius, strength, swirl, lift chance, settle time, and settle impact around moving tokens.

Important controls

• Directional Movement: Makes sakura blossoms travel in the configured Direction instead of relying only on the effect’s default random movement.
• Top Down: Switches Sakura Blossoms to the overhead presentation intended for top-down maps. This changes particle projection and movement, so set it before finalizing scale and direction.
• Orbit: Makes sakura blossoms circulate around the effect area instead of only crossing the canvas in a straight or drifting path.
• Synchronized Direction: Uses the active Wind or Duststorm direction for Sakura Blossoms. When the source direction changes, this effect follows it.
• Background: Render a persistent field of settled particles behind the active effect. The field follows the same stack placement, scene or Region mask, Levels selection, and below-token/tile settings.
• Token Trails: Allow visible token trails to push, spin, and briefly lift nearby settled particles while moving through them. Displaced particles settle in their new positions for the current canvas session.

Setup notes

• Background fill and appearance controls are separate from airborne Scale, Speed, Lifetime, Density, and Opacity while the effect is enabled.
• Use Trail Lift Chance sparingly so frequent token movement does not continuously refill the airborne layer.

Bundled preset usage

Preset	API name	Availability	Variants
Sakura Bloom	sakura-bloom	FXMaster+	Normal, Top Down

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.

37 exposed parameters1 Scene-onlysakurablossoms 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
Tinti tint	color	#FFFFFF (disabled)	—	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
Top Downi topDown	checkbox	Off	—	Hidden when Orbit = On
Orbiti orbit	checkbox	Off	—	Hidden when Top Down = On
Orbit Distancei orbitDistance	range	0.5	0–1 · step 0.01	Shown when Orbit = On
Rotation Strengthi rotationStrength	range	0	0–1 · step 0.01	Shown when Top Down = OnHidden when Orbit = On
Directional Movementi directionalMovement	checkbox	Off	—	Hidden when Top Down = On or Orbit = On
Directioni direction	range	270	0–360 · step 5	Shown when Directional Movement = OnHidden when Top Down = On or Orbit = On
Synchronized Directioni synchronizedDirection	checkbox	Off	—	Shown when Directional Movement = OnHidden when Top Down = On or Orbit = On
Scalei scale	range	0.15	0.1–1 · step 0.01	Always
Speedi speed	range	0.29	0.1–1 · step 0.01	Always
Lifetimei lifetime	range	0.27	0.1–1 · step 0.01	Always
Densityi density	range	0.5	0.05–1 · step 0.05	Always
Opacityi alpha	range	1	0–1 · step 0.1	Always
Backgroundi backgroundEnabled	checkbox	Off	—	Always
Background Filli backgroundMode	select	Fill Over Time	Full Coverage, Fill Over Time	Shown when Background = On
Time to Full Coveragei backgroundDuration	range	180	10–3600 · step 10	Shown when Background = On and Background Fill = Fill Over Time
Background Opacityi backgroundOpacity	range	0.8	0–1 · step 0.01	Shown when Background = On
Ground Coveragei backgroundCoverage	range	0.6	0.05–1 · step 0.05	Shown when Background = On
Fill Variationi backgroundFillVariation	range	0.75	0–1 · step 0.05	Shown when Background = On and Background Fill = Fill Over Time
Pile Amounti backgroundPileStrength	range	0.45	0–1 · step 0.05	Shown when Background = On
Pile Size (Grid Spaces)i backgroundPileSize	range	4	0.5–12 · step 0.5	Shown when Background = On
Ground Particle Sizei backgroundParticleSize	range	0.08	0.01–1 · step 0.01	Shown when Background = On
Token Trailsi backgroundInteractionEnabled	checkbox	On	—	Shown when Background = On
Trail Widthi backgroundInteractionRadius	range	1	0–2 · step 0.05	Shown when Background = On and Token Trails = On
Trail Strengthi backgroundInteractionStrength	range	0.5	0–1 · step 0.05	Shown when Background = On and Token Trails = On
Trail Swirli backgroundInteractionSwirl	range	1	0–1 · step 0.05	Shown when Background = On and Token Trails = On
Trail Lift Chancei backgroundInteractionLiftChance	range	1	0–1 · step 0.05	Shown when Background = On and Token Trails = On
Settle Time (Seconds)i backgroundInteractionSettleTime	range	5	0.1–12 · step 0.1	Shown when Background = On and Token Trails = On
Settle Impacti backgroundInteractionSettleImpact	range	1	0–1 · step 0.05	Shown when Background = On and Token Trails = On
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

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({
  particles: [{
    "id": "apiMacro_wikisakurablossoms_p",
    "type": "sakurablossoms",
    "options": {
      "belowTokens": false,
      "tint": {
        "value": "#FFFFFF",
        "apply": false
      },
      "topDown": false,
      "orbit": false,
      "directionalMovement": false
    }
  }],
});

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

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