This page is a work in progress!

Concept

SmartAoE. Have you ever overlayed a cone, line, or circle template on a map and wondered if that square that is just barely covered should count as "in"? Sure, there are pre-made grid templates out there, but you are usually limited to 90/45deg orientations. The idea behind this script is to provide flexibility in casting angles (to align just the right spot before triggering) and a means for consistent ruling of these cases. Also, the script can detect creatures within affected squares and be able to roll saving throws and/or apply damage and condition markers automatically (ala GroupCheck or similar script).

Current functionality is to spawn a "control token" over a selected token. The location of the AoE is set by the positioning of the control token (and for lines/cones, the relative positions of the selected and control tokens). Depending on the commands used to spawn that control token, the script will associate those settings with that control token and act accordingly (a link between the selected and control tokens is made and stored in persistent memory). To determine whether a square is affected, you define a minimum grid coverage area in your macro. I'll use cones in the following discussion: For example, using --minGridArea|0.25 would require 25% of the grid square to be covered by the cone boundaries. You can choose to have the origin of the cone be in the default center of the origin (selected) token, or use the --origin|nearest command to automatically shift the origin point to the nearest corner or face of the origin token. There are additional commands to rotate the origin point CW/CCW and to "trigger" the effect.

You can also define rules for the minimum percentage of a token's area that needs to be covered by an affected AoE grid square in order for the creature to be considered "in" the area of effect.

There are a variety of customization options for the AoE, including type (line, circle, cone, square - of which circle and square can be made independent of source token position), radius, AoE fill and line colors, saving throw formulas, difficulty class (target save number), up to two damage formulas & damage types, condition markers for pass/fail/dead, bar links, damage resistance/vulnerability/immunity (based on attribute content and damage type), and auto application of damage. These parameters and more are described below under #List of Subcommands.

Initial Setup

1. Install the SmartAoE api script, currently found on GitHub here: v0.13
2. Install the
   libInline
   API script (available as 1-click install). SmartAoe is dependent on this utility script!
3. Create a character sheet with the default token image you want for the AoE control token. If you do not specify a --controlTokName, then the script will look for the default token for a character named AoEControlToken. You can use a Multi-Sided Token, for which you may set the side and size via commands when spawned.
4. Create a macro utilizing the syntax described below. There are currently three different base commands:

Syntax	Description
!smartaoe <subcommands>	this is the primary api syntax. Descriptions of commands is below, but they all follow the form --commandName|parameter(s)
!smartrotateorigin <cw/ccw>	valid for cones only - this rotates the origin point cw or ccw along corners or faces of the origin token
!smarttrigger	currently no subcommands. Triggers the fx and does all the stuffs

It is recommended to create the following abilities on the AOEControlToken character and select "Show as token action". This will expedite the AoE manipulation and triggering process.

Ability Name	Ability Content
CCW	!smartrotateorigin ccw
CW	!smartrotateorigin cw
Trigger	!smarttrigger

List of Subcommands

AoE Behavior Commands

AoE Math Commands

Chat Output Style Commands