leanFX

Glows, auras, fire, lightning, fog, water and 40 more visual effects for tokens, tiles, drawings and regions in Foundry VTT v14, applied with a single macro line and animated for everyone at the table. It is a slimmed-down version of Token Magic FX: the same 45 effects and animations, without the buttons, editors, presets or system automation. You use it from macros or from your own module.

await leanFX.addUpdateFiltersOnSelected([{
  filterType: "glow", filterId: "ward",
  color: 0x66ccff, outerStrength: 4, distance: 12,
  animated: {outerStrength: {animType: "syncCosOscillation", loopDuration: 3000, val1: 2, val2: 5}}
}]);

Documentation: the wiki has the API reference, every filter with its parameters and an example, animations and copy-paste examples.

Features

• 45 effects for Tokens, Tiles, Drawings and Regions: glows, outlines, auras, fire, lightning, fog, water, force fields, distortion, image overlays, polymorph and more.
• 19 animation modes (pulsing, spinning, drifting, random flicker), in sync on every screen and continuing after a reload.
• Effects stay put: an effect is saved with its Token, Tile, Drawing or Region and shows according to its visibility rules, also after a reload. Players can change effects on objects they own; the GM's client saves the change.
• Region placement: draw below tiles, above tiles or above tokens, independently of the editor highlight. See Region rendering.
• Effects on the map: with backdrop, a Region's filters age, grade or distort the map under it (Old Film, colour adjustments, pixelate, distortions), also while the Region moves or follows a token.
• Effects that turn with their token: with rotate, a token-attached Region's effect turns as the token rotates.
• Private previews that only you see, for trying effects out.
• One-shot effects that remove themselves when their animation ends (onComplete: "delete").
• Plays well with others: leanFX leaves the effects of other modules alone and changes nothing in Foundry itself.

Settings

Setting	Scope	Default	Effect
Disable effect animations	Client	Off	Shows animated effects as a still frame on this client. Helps slower computers.

Requirements

• Foundry VTT v14
• socketlib
• A connected GM for saved effects (previews work without one)

Installation

In Foundry's Add-on Modules tab, choose Install Module and paste this manifest URL:

https://someto.de/flaig/leanFX/releases/download/latest/module.json

leanFX does not read Token Magic FX effects or presets, and running both on the same objects is untested. See Coming from Token Magic FX.

This is a personal project and stays at 0.x: expect breaking changes between versions.

AI disclosure

The changes to the original were made by AI with the help of human ideas.

License

GPL-3.0. leanFX is a modified version of Token Magic FX by SecretFire and contributors (GPL-3.0). It bundles parts of pixi-filters (MIT, LICENSE-pixi-filters). Details, modifications and how to rebuild the bundle: THIRD_PARTY.md.