Volumetric Templates

This module provides autotargeting for Regions. It can be used with plain Regions or with placed spells and abilities. Works with all systems and is MIDI QOL (opens in a new tab) compatible.

Getting Started

Delete Placed Regions button

Volumetric templates will work automatically with normal Region placement.

The module can be set to target tokens while the Region is being placed or just when the placement is finished.

A new button has been added to the Region controls to delete all Regions placed as Templates, like spells and abilities.

Configuration

By changing Volume Percentage you can determine how much a token needs to overlap with a Region to count as a target. Tokens are simplified to Cubes for intersections. It's possible to set which tokens will be considered as targets with the settings Ignore Self and Ignore Friendly.

Advanced

By disabling Target On Change and Target On Placement it's possible to prevent the tokens from being targeted. Tokens inside a region can be obtained by using the module as an API using the following macro:

/**
 * @param {RegionDocument} region - The region document to compute.
 * @param {Token[]|null} [tokensToCheck=null] - The tokens to check for intersections; defaults to all tokens in the scene if null.
 * @param {boolean|null} [placement=false] - Whether the region is being placed (true) or is a preview (false).
 * @returns {string[]} An array of token IDs that intersect with the region.
 */
game.modules.get("levelsvolumetrictemplates").API.computeRegion3d(region, tokensToCheck, placement);