Note: You are not logged in.
Aura Effect

by bmos

FREE
4.94 Avg. rating (35)

Forum Thread
Total Subscribers:


Description

Build FG-Usable File
Luacheck

Aura Effect Extension

This extension enables auras and area-of-effect buffs/debuffs by adding/removing effects on other actors based on proximity.

Compatibility

This extension is compatible with the following rulesets:

  • Fantasy Grounds Unity v4.6.6 (2025-03-09)
  • Supported Rulesets:
  • 3.5E
  • 4E
  • 5E
  • PFRPG
  • PFRPG2
  • SFRPG

Additionally, Mattekure’s Complete Offensive Package Aura Extension allows you to see the auras generated by this extension. It is a paid extension.


How to Use

To create an aura, two clauses are required, separated by a semicolon (;). The first clause defines the area of effect (modifier: AURA), and the second clause defines the applied effect for tokens within the aura.

Modifier Value Descriptors Notes
AURA (N) [faction]*, [behavior]*, [alignment]*, [size]*, [type]*, point, dying Effect is applied to all tokens in the defined area that match the descriptor filtering
  • (N): = Only numbers supported for value attribute.
  • *: = Multiple entries of this descriptor type allowed.
  • ! or ~: Use to negate a descriptor.

Basic Aura Effect

Aura of Protection; AURA: 10 ally; Aura of Protection AoE; SAVE: 5

  • This will create a 10-foot aura around the character with the effect.
  • Allies within 10’ will receive the effect: “Aura of Protection AoE; SAVE: 5”.

Note: While a label (like ‘Aura of Protection’, ‘Aura of Protection AoE’) is not mandatory, it is highly recommended to reference where effects are sourced from.

You can use IF/IFT conditions to control when an aura is applied or removed:

  • Before the “AURA” effect: Enables or disables parsing of the aura (e.g., for conditional auras).
  • After the “AURA” effect: Conditions will be copied to the recipients of the aura.

By default, the bearer of the aura effect will also receive its benefits. If this is not desired, use the FACTION() conditional operator.

Descriptor Types

The following descriptors determine whether an aura applies to an actor. All conditions must be true for the aura to apply.

You can reverse the results of any descriptor by using the ! or ~ operator (e.g., !friend, ~ally).

Faction

  • all: Applies aura to all actors (default).
  • ally: Applies aura to actors whose faction matches the effect source’s faction.
  • enemy: Applies aura to actors whose faction is “foe” if the effect source’s faction is “friend” (or vice versa).
  • foe: Applies aura to actors whose faction is “foe”.
  • friend: Applies aura to actors whose faction is “friend”.
  • neutral: Applies aura to actors whose faction is “neutral”.
  • none: Applies aura to actors whose faction is “none” or blank.

Behavior

These modify the default behavior of auras. You can combine multiple special types to create unique effects.

Descriptor Notes Example
cube Changes the aura shape to a cube instead of a sphere. The cube’s side length is defined by the aura value. Example; AURA: 10 all,cube;Example E AoE; ATK: -5
single Applies the aura only when the target enters the area for the first time or starts their turn there. It won’t be reapplied if the target leaves and returns on the same turn. Example; AURA: 10 !ally,single; Example AoE; IF: FACTION(!self); ATK: -5
sticky Aura effects persist on the actor even if they move out of the aura. Example; AURA: 10 all,sticky; Example AoE; IF: FACTION(!self); Poisoned
once The aura is applied only once per turn, regardless of whether the actor leaves and re-enters the area. Example; AURA: 10 all,once; Example AoE; ATK: -5

Point

By default, aura distances are calculated from the outside of the token. Use the point descriptor to calculate distance from the center of the token instead.

Example; AURA: 10 all,point; Example AoE; ATK: -5

Alignment

Supported alignments for each ruleset:

  • 5E, 4E, PFRPG, PFRPG2, SFRPG: lawful, chaotic, good, evil, l, c, g, e, n, lg, ln, le, ng, ne, cg, cn, ce.

Note: Neutral alignment should be represented as n when specifying in conditions.

Size

Supported sizes for each ruleset:

  • 5E & 4E: tiny, small, medium, large, huge, gargantuan
  • 3.5E, PFRPG, PFRPG2, & SFRPG: fine, diminutive, tiny, small, medium, large, huge, gargantuan, colossal

Type

Available creature types:

  • 5E: aberration, beast, celestial, construct, dragon, elemental, fey, fiend, giant, humanoid, monstrosity, ooze, plant, undead, living construct, aarakocra, bullywug, demon, devil, dragonborn, dwarf, elf, gith, gnoll, gnome, goblinoid, grimlock, halfling, human, kenku, kuo-toa, kobold, lizardfolk, merfolk, orc, quaggoth, sahuagin, shapechanger, thri-kreen, titan, troglodyte, yuan-ti, yugoloth
  • 4E: magical beast, animate, beast, humanoid, living construct, air, angel, aquatic, cold, construct, demon, devil, dragon, earth, fire, giant, homunculus, mount, ooze, plant, reptile, shapechanger, spider, swarm, undead, water
  • 3.5E/PFRPG: magical beast, monstrous humanoid, aberration, animal, construct, dragon, elemental, fey, giant, humanoid, ooze, outsider, plant, undead, vermin, living construct, air, angel, aquatic, archon, augmented, cold, demon, devil, earth, extraplanar, fire, incorporeal, native, psionic, shapechanger, swarm, water, dwarf, elf, gnoll, gnome, goblinoid, gnoll, halfling, human, orc, reptilian
  • PFRPG2: aberration, animal, beast, celestial, construct, dragon, elemental, fey, fiend, fungus, humanoid, monitor, ooze, plant, undead, adlet, aeon, agathion, air, angel, aquatic, archon, asura, augmented, azata, behemoth, catfolk, clockwork, cold, colossus, daemon, dark folk, demodand, demon, devil, div, dwarf, earth, elemental, elf, extraplanar, fire, giant, gnome, goblinoid, godspawn, great old one, halfling, herald, human, incorporeal, inevitable, kaiju, kami, kasatha, kitsune, kyton, leshy, living construct, mythic, native, nightshade, oni, orc, protean, psychopomp, qlippoth, rakshasa, ratfolk, reptilian, robot, samsaran, sasquatch, shapechanger, swarm, troop, udaeus, unbreathing, vanara, vishkanya, water
  • SFRPG: magical beast, monstrous humanoid, aberration, animal, companion, construct, dragon, fey, giant, humanoid, ooze, outsider, plant, undead, vermin,living construct, aeon, agathion, air, angel, aquatic, archon, augmented, cold, demon, devil, earth, extraplanar, fire, incorporeal, native, psionic, shapechanger, swarm, water, dwarf, elf, gnoll, gnome, goblinoid, halfling, human, orc, reptilian

Dying

  • dying: Applies aura when the source actor is at 0 HP or in a dying state.
  • !dying: Applies aura when the source actor is not dying (HP 0).

Note: Auras with the “dying” descriptor will only trigger if the actor is in a dying state.

Exceptions

  • If a resulting aura effect is set to “off” in the combat tracker, the effect will not be removed based on token movement. This is useful for managing automatic effects like those for saved or immune creatures.
  • The factional relationship of ally or enemy is evaluated from the source of the aura effect.

5E Concentration (C)

For concentration effects, place the (C) modifier before or within the “AURA” clause, but not after it.

Correct Usage:

Example; (C); AURA: 10 all; Example AoE; Do something
Example; AURA: 10 all (C); Example AoE; Do something

Incorrect Usage:

Example; AURA: 10 all; Example; Do something (C)


FACTION() Conditional Operator

This operator expands the functionality of IF/IFT conditions by evaluating factional relationships.

  • ally: True if the source and target factions match.
  • enemy: True if the source faction is “foe” and the target faction is “friend” (or vice versa).
  • foe: True if the faction is “foe”.
  • friend: True if the faction is “friend”.
  • neutral: True if the faction is “neutral”.
  • none: True if the faction is “none”.
  • self: True if the actor is the source of the effect.
  • notself: Legacy, same as !self, True if the actor is not the source.

Use ! or ~ to negate the result (e.g., !self, ~ally).


GM Holding Shift

When the GM holds Shift, aura calculations are temporarily disabled. This allows the GM to move a token through an aura without triggering the aura effect.


Special Condition: Object

Actors with the Object condition will not be affected by auras.


Optional Settings

Disabling Aura Effect Chat Messages

You can suppress aura apply/removal notifications for specific factions or all factions by adjusting the “Silence Notifications for Aura Types” setting.

Diagonal Distance Multiplier

You can control how diagonal distances are calculated between tokens:

  • Raw: Uses the Pythagorean Theorem for diagonals.
  • Ruleset: Diagonal distances are calculated according to the specific ruleset’s definition.

Effect Sharing Threads


Video Demonstration

Video Thumbnail


API Documentation

For developers who want to interact with this extension, an API is available. Documentation is provided in the code.



UUID 5a772a86-d54c-11eb-8c52-0050562be458