Ghosts

Ambient reference

FXMaster+Particle effectAPI type: ghosts

Preview

Preview shows Ghosts enabled, limited to the Cute variant

Map maker

Map:Angela's Maps

Cute or creepy ghosts with manual placement, directional drift, and configurable visual variants.

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	ghosts
Exposed parameters	30

Manual Placement

Enable Manual Placement to save individual Ghost positions instead of generating ghosts through Density and Lifetime. Use Place to add ghosts, Undo to remove the most recent placement, and Clear to remove the current placements.

Placement movement and appearance

Manual Float Radius controls how far each placed ghost drifts from its saved point, while Direction controls its facing. Variants, Scale, Speed, Opacity, Glow, Wobble, Displacement, and Blur continue to define the appearance and movement of the placed ghosts.

Manual and automatic controls

Orbit and Manual Placement are mutually exclusive. Density, Lifetime, and Token Avoidance are hidden in Manual Placement mode because placement count and saved positions replace automatic spawning and avoidance behavior.

Important controls

• Variants: Selects which ghost sprite variants can appear. Multiple selections mix those designs within the same effect.
• Manual Placement: Replaces automatic ghost distribution with exact positions placed on the current Scene.
• Wobble: Controls the amount of side-to-side and shape movement in the ghost animation.
• Displacement: Controls how strongly the ghost artwork warps and ripples while animating.
• Token Avoidance: Makes ghosts steer away from eligible tokens instead of moving directly through them.

Setup notes

• Manual Placement creates fixed ghost positions, while the normal particle controls create ghosts that move across the Scene.
• Variants, Wobble, Displacement, Blur, and Glow provide the primary visual identity.
• Token Avoidance can keep moving ghosts from passing directly through tokens when desired.

Bundled preset usage

Preset	API name	Availability	Variants
Gravewind	gravewind	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.

30 exposed parameters1 Scene-onlyghosts 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
Variantsi variants	multi-select	Creepy	Cute, Creepy	Always
Manual Placementi manualPlacement	checkbox	Off	—	Hidden when Orbit = On
Orbiti orbit	checkbox	Off	—	Hidden when Manual Placement = On
Orbit Distancei orbitDistance	range	0.5	0–1 · step 0.01	Shown when Orbit = On
Manual Placement Controlsi placementActions	particle-actions		—	Shown when Manual Placement = On
Manual Float Radiusi manualFloatRadius	range	0.35	0–2 · step 0.05	Shown when Manual Placement = On
Directioni direction	range	0	0–360 · step 5	Shown when Manual Placement = On
Scalei scale	range	0.27	0.1–1 · step 0.01	Always
Speedi speed	range	0.27	0.1–1 · step 0.01	Always
Lifetimei lifetime	range	0.27	0.1–1 · step 0.01	Hidden when Manual Placement = On
Densityi density	range	0.173	0.001–1 · step 0.001	Hidden when Manual Placement = On
Opacityi alpha	range	1	0–1 · step 0.1	Always
Glowi glow	range	0.6	0–1 · step 0.05	Always
Wobblei wobble	range	0.7	0–1 · step 0.05	Always
Displacementi displacement	range	0.6	0–1 · step 0.05	Always
Bluri blur	range	0.15	0–1 · step 0.05	Always
Token Avoidancei tokenAvoidance	checkbox	Off	—	Hidden when Manual Placement = On
Token Dispositionsi tokenAvoidanceDispositions	multi-select	Friendly, Neutral, Hostile, Secret	Friendly, Neutral, Hostile, Secret	Shown when Token Avoidance = OnHidden when Manual Placement = On
Avoid Stationary Tokensi tokenAvoidanceAtRest	checkbox	Off	—	Shown when Token Avoidance = OnHidden when Manual Placement = On
Avoidance Radiusi tokenAvoidanceRadius	range	1	0–3 · step 0.05	Shown when Token Avoidance = OnHidden when Manual Placement = On
Avoidance Strengthi tokenAvoidanceStrength	range	0.65	0–1 · step 0.05	Shown when Token Avoidance = OnHidden when Manual Placement = 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_wikighosts_p",
    "type": "ghosts",
    "options": {
      "belowTokens": false,
      "tint": {
        "value": "#FFFFFF",
        "apply": false
      },
      "orbit": false,
      "direction": 0,
      "scale": 0.27
    }
  }],
});

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.