Manual Placement

Custom particle base

FXMaster+Particle base

Manual Placement replaces automatic particle distribution with positions placed directly on the Scene. Each custom definition supplies the images available to the effect and to its individual placements.

Create the custom effect through Manage User Particle Effects, then select Manual Placement from Base Effect.

Reference	Value
Package	FXMaster+
Definition type	Custom particle base
Base Effect label	Manual Placement
Exposed parameters	35

Important controls

• Sprites: Selects which custom images are available to the effect and its placements.
• Manual Placement: Switches between exact placed positions and automatic particle distribution.
• Manual Placement Controls: Provides Place, Delete, and Clear actions.
• Direction: Sets the orientation or movement direction used by the images.
• Light Source: Creates optional Foundry light sources for manually placed images.
• Glow: Adds a glow around each custom image.
• Burn Tokens: Adds the temporary token-burning presentation when eligible tokens enter the effect area.

Place custom particles

1. Create the custom definition and add one or more images under Textures.
2. Select Particle Effects from FXMaster Controls, then add or edit the custom effect.
3. Enable Manual Placement.
4. Use Sprites to choose which custom images are available.
5. Use Place to add a position, Delete to target an existing position, or Clear to remove every placement for that effect.
6. Use the on-canvas preview to position and orient the image.

Placements are stored with the Scene and restored when the Scene loads. Closing Particle Effects Management exits the active placement interaction without deleting saved positions.

Placement presentation

Scale, Opacity, Direction, Horizontal Flip, Glow, and Glow Radius control the placed images. When Light Source is enabled, each placement can also create a Foundry light using Light Color, Light Radius, Bright Radius, Light Intensity, and Light Flicker.

Burn Tokens is optional. It adds a temporary client-side burning presentation to eligible tokens that enter the custom particle area, with controls for duration, trigger radius, scale, opacity, pulse detail, and tint.

The built-in Fire and Ghosts effects also provide their own Manual Placement modes. Their pages document the controls specific to those effects.

Parameters

The table combines the settings inherited by a custom Manual Placement 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.

35 exposed parameters1 Scene-onlyGenerated custom ID 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
Spritesi spritesheets	multi-select	All images	—	Always
Manual Placementi manualPlacement	checkbox	On	—	Always
X Adjustmenti xAdjustment	range	0	-10–10 · step 0.05	Hidden when Manual Placement = On
Y Adjustmenti yAdjustment	range	0	-10–10 · step 0.05	Hidden when Manual Placement = On
Horizontal Flipi flipHorizontal	checkbox	Off	—	Shown when Manual Placement = On
Manual Placement Controlsi placementActions	particle-actions		—	Shown when Manual Placement = On
Light Sourcei lightSource	checkbox	Off	—	Shown when Manual Placement = On
Light Colori lightColor	color	#ff8a20 (enabled)	—	Shown when Manual Placement = On and Light Source = On
Light Radiusi lightRadius	range	4	0.5–20 · step 0.5	Shown when Manual Placement = On and Light Source = On
Bright Radiusi lightBrightRadius	range	1	0–20 · step 0.5	Shown when Manual Placement = On and Light Source = On
Light Intensityi lightAlpha	range	0.55	0.05–1 · step 0.05	Shown when Manual Placement = On and Light Source = On
Light Flickeri lightFlicker	range	0.65	0–1 · step 0.05	Shown when Manual Placement = On and Light Source = On
Directioni direction	range	0	0–360 · step 5	Always
Scalei scale	range	0.36	0.1–1 · step 0.01	Always
Densityi density	range	0.33	0–1 · step 0.01	Hidden when Manual Placement = On
Opacityi alpha	range	1	0–1 · step 0.05	Always
Flickeri flicker	range	0.55	0–1 · step 0.05	Always
Glowi glow	range	0	0–1 · step 0.01	Always
Glow Radiusi glowRadius	range	18	4–20 · step 1	Always
Burn Tokensi burnTokens	checkbox	Off	—	Always
Burn Durationi burnTokenDuration	range	8	1–60 · step 1	Shown when Burn Tokens = On
Burn Trigger Radiusi burnTokenRadius	range	0.75	0.1–5 · step 0.05	Shown when Burn Tokens = On
Burn Visual Scalei burnTokenScale	range	0.32	0.1–1 · step 0.01	Shown when Burn Tokens = On
Burn Opacityi burnTokenAlpha	range	0.85	0.1–1 · step 0.05	Shown when Burn Tokens = On
Burn Pulse Detaili burnTokenIntensity	range	0.43	0.1–1 · step 0.01	Shown when Burn Tokens = On
Burn Tinti burnTokenTint	color	#ff7a20 (disabled)	—	Shown when Burn Tokens = 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

After a custom effect is created, its generated effect ID can be used as a particle type. Stored manual placements remain Scene data; the API example below starts the custom row that uses them.

const customType = 'your-custom-particle-id';

const created = await FXMASTER.api.effects.play({
  particles: [{
    id: 'apiMacro_customManual_p',
    type: customType,
    options: {
      manualPlacement: true,
      scale: 0.35,
      glow: 0.25,
    },
  }],
});

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

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