Magic Crystals

Ambient reference

FXMaster+Particle effectAPI type: magiccrystals

Preview

Preview shows Magic Crystals with Orbit mode turned off

Map maker

Map:Zach Moeller

Floating magical crystals with orbiting, rainbow tinting, glow, bloom, and spin.

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	magiccrystals
Exposed parameters	20

Important controls

• Rainbow: Cycles crystal colors through a rainbow treatment instead of using only the selected Tint.
• Orbit: Makes magic crystals circulate around the effect area instead of only crossing the canvas in a straight or drifting path.
• Spin Speed: Changes how quickly the crystal sprites rotate while moving.
• Glow: Controls the direct glow around each crystal sprite.
• Bloom: Controls the soft bloom around bright crystal pixels.

Setup notes

• Rainbow replaces the single Tint color with a changing multicolor treatment.
• Glow and Bloom compound, so raise one at a time while viewing the complete effect stack.

Bundled preset usage

Preset	API name	Availability	Variants
Aether Haze	aether-haze	FXMaster+	Normal
Ley Surge	ley-surge	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.

20 exposed parameters1 Scene-onlymagiccrystals 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)	—	Hidden when Rainbow = On
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
Rainbowi rainbow	checkbox	Off	—	Always
Orbiti orbit	checkbox	Off	—	Always
Orbit Distancei orbitDistance	range	0.5	0–1 · step 0.01	Shown when Orbit = 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	Always
Densityi density	range	0.17	0.1–1 · step 0.01	Always
Opacityi alpha	range	1	0–1 · step 0.1	Always
Spin Speedi spin	range	0.5	0–1 · step 0.05	Always
Glowi glow	range	0.5	0–1 · step 0.05	Always
Bloomi bloom	range	0.5	0–1 · step 0.05	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

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_wikimagiccrystals_p",
    "type": "magiccrystals",
    "options": {
      "belowTokens": false,
      "tint": {
        "value": "#FFFFFF",
        "apply": false
      },
      "orbit": false,
      "scale": 0.27,
      "speed": 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.