# Sprixen VFX for Foundry

Experimental module for Foundry 13-14, built against the documented APIs. Not yet verified in a running Foundry world. Back up your world and test in a spare scene first. No game system or third-party module is required. Sprixen is independent of Foundry Gaming.

## Install

In Foundry Setup, Add-on Modules, Install Module, paste https://sprixen.com/foundry/sprixen-vfx/module.json as the manifest URL. Enable Sprixen VFX in your world. As GM, open a scene and choose Tile Controls, then the magic wand.

## Create and place

Export or AI-create an effect in https://sprixen.com/vfx-studio. With module version 0.3 or newer, upload the whole ZIP pack or paste the effect code from Copy for Foundry. Duration and looping are imported automatically. Select tokens, target tokens, or choose scene center. Set size and elevation, then place. Uploads receive unique filenames to avoid overwriting existing assets. Local uploads continue working independently of Sprixen hosting. Bare WebM files and local paths are still supported.

For ZIP packs and effect codes, leave Override imported playback settings unchecked. AI impacts import as one-second one-shots; catalogue effects use their own two/four-second timing and loop setting. For bare WebM files, configure playback manually. The active GM cleans up expired one-shot tiles. Continuous effects remain until removed. To remove an effect, select its tile and click the broom. This only removes selected Sprixen tiles, never unrelated scene content. Files themselves are not deleted.

## Macro API

The module exposes game.modules.get('sprixen-vfx').api with open(), place({source, placement, size, loop, duration, elevation}), upload(file), and removeSelected(). All mutating operations require a GM. Source accepts a Sprixen public WebM URL or a local Foundry path. No account password, session token, or API key is needed or stored.

## Current limits

No combat automation, automatic account-library synchronization, Sequencer dependency, moving-token attachment, or player-initiated effects. Tiles are placed at the selected position. Playback synchronization across clients depends on Foundry. For v14 scenes with levels, check tile elevation and visibility in a test scene. Runtime verification on a real Foundry installation is still pending.