Landing Storm Controller

Controls a looping lightning strike + sound effect on your Foundry VTT landing scene.
World (GM) settings let you define initial delay, min/max interval, and debug logging.
An Advanced Options section provides scene tools (pick location, choose effect & sound, set sound duration) and Add/Remove Flags buttons for the active scene.

⚠️ Probably useless to anyone else.
This module is purpose-built for my personal landing scene setup. It assumes you have specific assets (e.g., Sequencer/JB2A) and a preference for periodic thunder/lightning. If that’s not you, this likely won’t add value.

---

Requirements

• Foundry VTT: v13+
• Sequencer: for effect + sound playback and (optional) database key resolution
  • Works with either Sequencer DB keys (e.g. jb2a.lightning_strike.red) or direct file paths (e.g. modules/.../file.webm).

JB2A assets are not bundled and require your own licensed installation.

---

What It Does

• Runs a lightning effect and optional thunder sound on a configurable location in the current scene.
• Starts after an initial delay, then repeats at a random interval between your Min/Max timings.
• Can use world timings (applies to all scenes using the module) or per-scene timings via scene flags.
• Provides Add Flags and Remove Flags buttons to quickly enable/disable the module on the active scene.
• Optional Debug Mode prints detailed logs to the console.

---

Installation

1. Download / install via Manifest URL:
   • https://github.com/JudasBrennan/landing-storm-controller/releases/latest/download/module.json
2. Enable Landing Storm Controller in Manage Modules.

If you’re cloning locally, ensure the folder is named exactly landing-storm-controller and contains module.json, scripts/, and templates/.

---

Configuration (GM)

Open Configure Settings → Module Settings → Landing Storm Controller → Configure Lightning.

World Timings

• Use World Timings (checkbox): When checked, world timing values override scene timing flags.
• Initial Delay (ms): Wait before the first lightning strike (min 10,000 ms).
• Minimum Delay (ms): Lower bound between strikes (min 3,000 ms).
• Maximum Delay (ms): Upper bound between strikes (min 6,000 ms).

When Use World Timings is unchecked, if the active scene has timing flags, those will be used instead.

Advanced Options (toggle to show)

• Lightning Location (X/Y): Type coordinates or Pick on Canvas.
• Effect File: Sequencer DB key or direct video path for the visual strike.
• Sound File: Sequencer DB key or audio file path for thunder.
• Sound Duration (ms): How long the sound plays before fade-out.
• Add Flags to Active Scene: Enables the module on the active scene and sets required flags (including timings from current world settings).
• Remove Flags from Active Scene: Disables/removes all Landing Storm Controller flags from the active scene.

Debug Mode

• Debug Mode (checkbox): Enables verbose console logging.

---

Assets & Examples

• Effect (example DB key): jb2a.lightning_strike.red
• Sound (example DB key): psfx.3rd-level-spells.call-lightning.v1.cast

You can also supply direct file paths (video/audio) from your modules or data folders.

---

Troubleshooting

• No menu appears: Ensure the module is enabled, Foundry v13+, and you’re a GM.
• Nothing plays: Verify your effect/sound paths exist, or that your Sequencer DB keys are installed and correct.
• Interval changes don’t apply: If the active scene has timing flags and Use World Timings is unchecked, the scene flags will override world settings. Click Remove Flags or enable Use World Timings.

---

License

This repository contains only the controller code and UI, released under the MIT license. No third-party assets are included. Use of JB2A/PSoundFX or other libraries is subject to their respective licenses.

---

Credits

• Concept & implementation: Judas Brennan
• Foundry VTT, Sequencer, and (optionally) JB2A/PSFX are the work of their respective creators.