napolitanod / Danger-Zone

localized zone effects with trigger options supporting animations, lasting effects, active effects, macros and integrations with other Foundry modules.
GNU General Public License v3.0
20 stars 1 forks source link

all versions Latest Release Download Count Forge Installs Foundry Hub Endorsements

:biohazard: Discussion and Danger Configuration Sharing on JB2A Discord server
:biohazard: Wiki and How to Use
:biohazard: Detailed Examples
:biohazard: Tutorials

About

Add life to your scenes! With Danger Zone, GMs can invoke highly customizable localized effects across any region or scene, including:

Here, a scene's zone is triggered at the start of the combat turn, causing the screen to shake and rubble to fall.

What's in the module

Fnctionality can be expanded through other Foundry modules - see the Module Integration section below.

What's not in the module

Getting Started

Here, a zone is triggered by token movement using the zone aura trigger.

1. Create a Danger

Whether it be a lava bubble that bursts to the surface or a vent of poisonous gas, a danger defines the effect that executes within a zone. With Danger Zone, you have control over a vast array of configuration combinations for your dangers, including displaying effects, creating lights and walls, spawning tokens, executing macros, playing sounds and moving tokens.

Access the Dangers button from the Scenes right navigation area. See Dangers for more info.

2. Add Zone to Scene

Like a wide lake of lava, a zone is the boundary within which dangers are generated. Each zone exists within a scene and is associated to a danger and a trigger condition. Zones may also be copied from one scene to another.

Access zones from the scene configuration form's header or by right clicking on the scene in the navigation or within the side menu and selecting 'Configure Zones' from the context menu. This will present the form where you can create new zones or edit existing ones. See Zones for more info.

3. Trigger Zone

The trigger defines the conditions under which lava bubble (danger) erupts from the lava field (zone). A trigger can be invoked either manually or as part of a defined event.

See Triggers for more info.

Added to Foundry

Danger Zone Trigger Buttons

When a scene is activated, if you are a GM and viewing that activated scene, you will see an array of buttons located to the right of that scene in the scene top navigation. Note, you may override this display location within the module configuration settings and instead choose to display the triggers adjacent to the macro bar.

Each button is a zone in that scene and displays the icon for the danger held within. The buttons function as follows:

Manually triggered zones

Automatically triggered zones (e.g. combat turn start trigger)

On Hover

Hovering over any button, aside from the manual trigger grouping, will highlight it's area within the scene grid.

Danger Zone Tile Clear

A button is added to the tile controls. Selecting this will clear all lasting effects (tiles) on the scene that were placed there by Danger Zone. You can suppress this button as an option within the module configurations.

Danger Zone Ambient Light Clear

A button is added to the lighting controls with the same icon as the tile clear button shown in the above section. Selecting this will clear all ambient lights on the scene that were placed there by Danger Zone. You can suppress this button as an option within the module configurations.

Danger Zone Region Clear

A button is added to the region controls. Selecting this will clear all regions on the scene that were placed there by Danger Zone. You can suppress this button as an option within the module configurations.

Danger Zone Wall Clear

A button is added to the walls controls with the same icon as the tile clear button shown in the above Danger Zone Lasting Effect Clear section. Selecting this will clear all walls on the scene that were placed there by Danger Zone. You can suppress this button as an option within the module configurations.

Dangers Button

Aside from accessing dangers from the Danger Zone Configuration area in the Foundry Module Configurations, you can also add these by selecting the button located in the footer of the scenes sidebar. This button can be suppressed as an option within the Danger Zone Configurations.

image

API

Trigger zones and access other Danger Zone features directly from the API See API for more info.

Module Integration

Installing other (free) Foundry VTT modules will increase the available danger possibilities.

Danger Zone integrates with a series of other Foundary modules in order to provide enhanced effects and token targetting. See the Module Integration page for details on which modules extend Danger Zone base functionality if installed.

Future Enhancements

See the Future Enhancements board for a list of upcoming enhancements to this module.