Difference between revisions of "Script:SmartAoE"
From Roll20 Wiki
(Created page with "== List of commands == === AoE Behavior Commands === {| class="wikitable" |- ! style="width:8em" | Command !! Parameter(s) !! Description !! Default Value !! Example(s) !! Add...") |
|||
| Line 1: | Line 1: | ||
| + | = This page is a work in progress! = | ||
== List of commands == | == List of commands == | ||
=== AoE Behavior Commands === | === AoE Behavior Commands === | ||
Revision as of 22:06, 15 October 2021
Contents |
This page is a work in progress!
List of commands
AoE Behavior Commands
| Command | Parameter(s) | Description | Default Value | Example(s) | Additional Notes |
|---|---|---|---|---|---|
| --radius | <###><optional units like ft. or "u"> | If a numeric value is specified, the AoE will have a constant radius regardless of the distance between the origin and control tokens. If "variable" (or omitted), the radius is dynamically determined by the relative spacing of the two tokens | variable | --radius|60ft --radius|12u |
If no units are given, will default to pixels! Behavior depends on "aoeType" keyword and "origin" type: For "nearest" origin, if "float" keyword is omitted, the origin token's square is omitted from the radius (making it bigger). Otherwise, float will result in a true radius. |
| --aoetype | <type>,<optional coneWidth>,<optional "float"> | currently supports "line", "square", "circle", "cone", and "5econe" | line | --aoetype|5econe --aoetype|cone, 90 --conditionFail|skull,cobweb --aoetype|line |
NOTE: default is "line" if this subcommand is omitted |
| --origin | <style> <optional "face"> | AoE starts in center or edge of square (ignored for line AoE’s) | center | --origin|nearest --origin|nearest, face --origin|center |
"Center" (or omitted) will pick the center of the origin token for the AoE origin. "Nearest" will pick the closest corner. "Nearest, face" will include the flat sides of the token's square as potential origin points. |
| --mingridarea | <#> | what percentage of the grid square’s area must lie within the AoE to be included in the final affected area | 0.01 | --mingridarea|0.1 | The example to the left would require only 10% of the grid to be covered by the AoE to be included. |
| --mintokarea | <#> | what percentage of the token’s area must lie within the AoE to be included as an affected creature | 0.01 | --mintokarea|0.25 | The example to the left would require only 25% of the token's area to be covered by affected squares for them to be in the area of effect. |
| --fx | <style>-<type> | will spawn fx in affected squares when triggered | --- | --fx|burn-death --fx|glow-holy |
fx will spawn at each affected square |
| --aoecolor | <#RRGGBBTT> | determines the fill color of the AoE’s affected squares | #ff000050 | --aoeColor|#ff000050 | NOTE: default is #ff000050 if this subcommand is omitted |
| --aoeOutlineColor | <#RRGGBB> | determines the line color of the AoE outline | #ff0000 | --aoeColor|#ff000050 | NOTE: default is #ff0000 if this subcommand is omitted |
| --controlTokName | <charName> | The name of the character sheet whose default token will be used as the AoE control token | AoEControlToken | --controlTokName|GenericSpellAoE | NOTE: default is "AoEControlToken" if this subcommand is omitted |
| --controlTokSize | <#> | The size (in squares) of the control token | 1 | --controlTokSize|8 | NOTE: default is 1 if this subcommand is omitted |
| --controlTokSide | <#> | For rollable table tokens: the side of the control token's image to be set when created | 1 | --controlTokSide|6 | NOTE: default is 1 if this subcommand is omitted |
| --isDrawing | <true/yes/1/false/no/0> | Sets the isdrawing property of the spawned control token | FALSE | --isDrawing|true | NOTE: default is false if this subcommand is omitted |
| --ignore | <attrName, attrValue> | Characters with matching attribute values will not be included in the chat output | --- | --ignore|SmartAoE_Ignore, 1 | NOTE: must have both the attrName and attrValue separated by a comma |
| --selectedID | <token_id or character_id> | allows direct selection of the source token | --- | --selectedid|-MlBqIRAtRSwAZ-8Jr_E | |
| --playerID | <player_id> | The name of the calling player. Useful when calling from another API script. Tells the script which playerID can control the control token (if not set by default in character sheet). Also for error msg whispers when called by another script. | --- | --playerid|-MlBqIRAtRSwAZ-8Jr_E |
AoE Math Commands
| Command | Parameter(s) | Description | Default Value | Example(s) | Additional Notes |
|---|---|---|---|---|---|
| --dc | <value or inline roll> | the target roll for each saving throw (>= is passing, < is failing) | 0 | --dc|{selected|spell_save_dc} --dc|[[5d6+2]] |
|
| --saveformula | <inline roll with special syntax (see notes)> | Formula to be used for saving throws for all affected tokens. | --- | --saveFormula|<<1d20 + a{dexterity_save_bonus}>> --saveFormula|5eDEX |
In order to delay the save rolls until the AOE is triggered, and to apply that formula to each token individually, replace inline roll format in the following way:
NOTE: for 5e games, you can use the shorthand "5eSTR", "5eDEX", "5eCON", "5eINT", "5eWIS","5eCHA" |
| --damageformula1 | <inline roll> | Formula to be used for damage1 | --- | --damageformula1|[[8d6]] --damageformula1|[[(5+?{Cast at what level? |3,3|4,4|5,5|6,6|7,7|8,8|9,9})d6]] |
|
| --damagetype1 | <text> | the damage type for damage1 | --- | --damageType1|Fire | |
| --damageformula2 | <inline roll> | Formula to be used for damage2 | --- | --damageformula1|[[8d6]] --damageformula1|[[(5+?{Cast at what level? |3,3|4,4|5,5|6,6|7,7|8,8|9,9})d6]] |
|
| --damagetype2 | <text> | the damage type for damage2 | --- | --damageType1|Fire | |
| --bar | <#> | which token bubble to apply damage. Default = 1 | 1 | --bar|1 | |
| --autoapply | <true/yes/1/false/no/0> | Toggle to apply damage and condition markers automatically or after subsequent interaction with chat output. | FALSE | --autoApply|1 | Confirmation of the applied damage will be posted to chat. Tokens on GM layer will have whispered confirmation. NOTE: default is false if this subcommand is omitted. |
| --conditionfail | <name(s) of status markers to apply on a failed save> | comma delimited | --- | --conditionFail|red --conditionFail|red@3 --conditionFail|skull,cobweb |
NOTE: if custom markers are used, you must include the whole id, e.g. "name::####" NOTE:inserting @# will overlay a number over the condition marker |
| --conditionpass | <name(s) of status markers to apply on a successful save> | comma delimited | --- | --conditionPass|Target::1510119 --conditionPass|green@3 --conditionPass|aura,bolt-shield |
NOTE: if custom markers are used, you must include the whole id, e.g. "name::####" |
| --zerohpmarker | <name(s) of status markers to apply if designated token bar is 0 after damage is applied> | comma delimited | --- | --zerohpmarker|dead | NOTE: if custom markers are used, you must include the whole id, e.g. name::#### |
| --resistAttr | <attrName> | If the damageType(s) string is included in the current value of the deNOTEd attribute, then the --resistanceRule will be applied | npc_resistances | --resistAttr|npc_resistances | NOTE: default is npc_resistances if this subcommand is omitted |
| --vulnerableAttr | <attrName> | If the damageType(s) string is included in the current value of the deNOTEd attribute, then the --vulnerableRule will be applied | npc_vulnerabilities | --resistAttr|npc_vulnerabilities | NOTE: default is npc_vulnerabilities if this subcommand is omitted |
| --immunityAttr | <attrName> | If the damageType(s) string is included in the current value of the deNOTEd attribute, then the --immunityRule will be applied | npc_immunities | --resistAttr|npc_immunities | NOTE: default is npc_immunities if this subcommand is omitted |
| --resistanceRule | <expression> | The math operation (accepts single Operator and Operand) to be applied if target is resistant to damageType(s) | *0.5 | --resistanceRule|*0.5 --resistanceRule|/2 --resistanceRule|-10 |
NOTE: default is "*0.5" if this subcommand is omitted |
| --vulnerableRule | <expression> | The math operation (accepts single Operator and Operand) to be applied if target is vulnerable to damageType(s) | *2 | --vulnerableRule|*2 --vulnerableRule|+10 |
NOTE: default is "*2" if this subcommand is omitted |
| --immunityRule | <expression> | The math operation (accepts single Operator and Operand) to be applied if target is immune to damageType(s) | *0 | --immunityRule|*0 | NOTE: default is *0 if this subcommand is omitted |
Chat Output Style Commands
| Command | Parameter(s) | Description | Default Value | Example(s) | Additional Notes |
|---|---|---|---|---|---|
| --title | <text> | the title of the chat output table | SmartAoE | --title|Burning Hands | NOTE: all chat output options will revert to default values if omitted from the macro |
| --leftsub | <text> | subtitle of the chat output table. If rightsub is included, they will be separated by a diamond icon | --- | --leftsub|some text --leftsub|Slot level ?{Cast at what level?|3,3|4,4|5,5|6,6|7,7|8,8|9,9} |
" " |
| --rightsub | <text> | subtitle of the chat output table. If leftsub is included, they will be separated by a diamond icon | --- | --rightsub|some text --rightsub|DC @{selected|spell_save_dc} DEX |
" " |
| --desc | <text> | optional description at bottom of chat output table | --- | --desc| Line 1 of the description%br%Line 2 of the description | " " |
| --hideNames | <true/yes/1/false/no/0> | If true, the token names will be replaced with Target_# | FALSE | --hidenames|1 | " " |
| --titlecardbackground | <html> | Value to set the html "background-image:" property of the title field of the chat output | linear-gradient(red, yellow) | --titlecardbackground|linear-gradient(#995522, blue) --titlecardbackground|url('https://s3.amazonaws.com/files.d20.io/images/ 248538196/c9xft1A2jWNqOkBsxQwyLQ/max.jpg?1633278017');background-size: contain; |
" " |
| --titlefontface | <fontName> | Font style of the chat output title | Contrail One | --titlefontface|Contrail One | " " |
| --titlefontcolor | <#RRGGBB> | Font color of the chat output title | #EEEEEE | --titlefontcolor|#EEEEEE --titlefontcolor|red |
" " |
| --titlefontsize | <html size> | Font size of the chat output title | 1.2em | --titlefontsize|1.2em --titlefontsize|18px |
" " |
| --titlefontlineheight | <html size> | line-height of the chat output title | 1.2em | --titlefontlineheight|1.2em --titlefontlineheight|18px |
" " |
| --titlecardbottomborder | <html> | Html border of the table title | 2px solid #444444; | --titlecardbottomborder|2px solid #444444 | " " |
| --subtitlefontface | <fontName> | Font style of the chat output subtitle | Tahoma | --subtitlefontface|Tahoma | " " |
| --subtitlefontcolor | <#RRGGBB> | Font color of the chat output subtitle | #333333 | --subtitlefontcolor|#333333 | " " |
| --subtitlefontsize | <html size> | Font size of the chat output subtitle | 13px | --subtitlefontsize|13px | " " |
| --bodyfontface | <fontName> | Font style of the chat output body | Helvetica | --bodyfontface|Helvetica | " " |
| --bodyfontsize | <html size> | Font size of the chat output body | 14px | --bodyfontsize|14px | " " |
| --tablebgcolor | <#RRGGBB> | Background color of the damage and description fields | #EEEEEE | --tablebgcolor|#EEEEEE | " " |
| --tableborder | <html> | Html border of the table | 2px solid #000000; | --tableborder|2px solid #000000; | " " |
| --tableborderradius | <html> | Html border radius of the table | 6px; | --tableborderradius|6px; | " " |
| --tableshadow | <html> | Html shadow of the table | 5px 3px 3px 0px #aaa; | --tableshadow|5px 3px 3px 0px #aaa; | " " |
| --evenrowbackground | <#RRGGBB> | Background color of the even rows of the Save fields | #DDDDDD | --evenrowbackground|#DDDDDD | " " |
| --oddrowbackground | <#RRGGBB> | Background color of the odd rows of the Save fields | #FFFFFF | --oddrowbackground|#FFFFFF | " " |
| --evenrowfontcolor | <#RRGGBB> | Font color of the even rows of the Save fields | #000000 | --evenrowfontcolor|#000000 | " " |
| --oddrowfontcolor | <#RRGGBB> | Font color of the odd rows of the Save fields | #000000 | --oddrowfontcolor|#000000 | " " |
