Additional Automation Support

There are many spells and actions that have additional functionality that is not explained or detailed in the relevant lookup or !help. This page is meant to document those quirks and how to use them.

Specifying Class Feature DC Bonuses

You can grant bonuses to your class Saving Throw DCs by creating a cvar: XDCBonus (WarlockDCBonus, BloodHunterDCBonus, MonkDCBonus, etc).

This is to account for items such as the Dragonhide Belt, which adds a flat +1/2/3 bonus to the save DC for your class.

Note

XDCBonus is not generated by the the sheet itself, but is instead set by the user. It will grant the given bonus to the save DC of actions for that class. You can set it with !cvar XDCBonus #, such as !cvar MonkDCBonus 2, or with Draconic using set_cvar().

This cvar should be an integer, or it could cause the automation to not run.

For more details on implementing this in homebrew, see Specifying Class Feature DC Bonuses

Spells with Additional Support

Note

-choice always transforms the argument to lowercase (-choice FIre will be treated as -choice fire), making it case insensitive.

Additionally, all of the options below use the in operator, so you can use partial matches (-choice fire will match -choice fireball)

Absorb Elements

You can have the automation automatically apply the damage type resistance you want to absorb using -choice [element] (-choice fire for instance).

Additionally, you can have the automation heal you for half the damage you absorb by adding -amt [amount] to the end of the command. (-amt 5 for instance). It will half the damage you specify, and heal you for that amount.

You can use both of these together (-choice fire -amt 5 for instance).

Alter Self

You can specify the type of alteration you want to take with the -choice argument.

-choice aquaticswimwater for the Aquatic Adaptation option
-choice appearancealter for the Change Appearance option
-choice naturalweapon for the Natural Weapons option

Blindness/Deafness

You can specify the type of hindrance you want to apply with the -choice argument.

-choice blindness for the Blindness option
-choice deafness for the Deafness option

Chromatic Orb

You can specify the type of damage you want to apply with the -choice argument or by setting the ChromaticOrbDType cvar.

-choice acid for Acid damage
-choice cold for Cold damage
-choice fire for Fire damage
-choice lightning for Lightning damage
-choice poison for Poison damage
-choice thunder for Thunder damage

You can also set a default damage type using the ChromaticOrbDType cvar (e.g., !cvar ChromaticOrbDType fire). The cvar will be used if no -choice is provided at cast time. If neither is provided, it will do [chromatic] damage by default.

Destructive Wave

You can specify the type of additional damage you want to apply with the -choice argument.

-choice necrotic for Necrotic damage
No choice or any other value defaults to Radiant damage

Dragon’s Breath

You can specify the type of damage you want to apply with the -choice argument. If a choice is not provided at cast time, it will do [chromatic] damage by default, and you will need to use -choice [element] to specify the damage type each time the breath attack is used, and adjustments may be required to the targets health, depending on resistances.

In this case, it does not check against a value, but instead just inputs whatever is given. This means you can technically give someone Pizza Breath with -choice pizza.

Elemental Weapon

You can specify the type of elemental damage you want to apply with the -choice argument.

-choice acid for Acid damage
-choice cold for Cold damage
-choice fire for Fire damage
-choice lightning for Lightning damage
-choice thunder for Thunder damage

Eldritch Blast

Eldritch Blast has a number of Eldritch Invocations that can affect it. You can add these to your invocations cvar to have them automatically applied when you cast Eldritch Blast.

If you add agonizing blast to your invocations cvar (!cvar invocations agonizing blast), it will automatically add your charisma when casting blast now.

Additionally, if you have other (official) invocations that affect blast, you can similarly add those to that cvar (!cvar invocations agonizing blast, lance of lethargy for instance), and it will add reminder text for them as well.

Like -choice, the automation will check against a lowercase version of the cvar, so !cvar invocations Agonizing Blast will work just as well as !cvar invocations agonizing blast.

Supported Invocations
Invocation Name	Automation Support
Agonizing Blast	Adds your Charisma modifier to the damage
Repelling Blast	Includes reminder text
Eldritch Spear	Includes reminder text
Grasp Of Hadar	Includes reminder text
Lance Of Lethargy	Includes reminder text

Enhance Ability

You can specify the ability you want to enhance with the -choice argument.

-choice bearsconstitution
-choice bullsstrength
-choice catsdexterity
-choice eaglescharisma
-choice foxsintelligence
-choice owlswisdom

Enlarge/Reduce

You can specify the adjustment you want to apply with the -choice argument.

-choice enlarged to enlarge the targets size
-choice reduced to reduce the targets size

Eyebite

You can specify the type of effect you want to apply with the -choice argument.

-choice asleep to apply the Asleep effect
-choice panicked to apply the Panicked effect
-choice sickened to apply the Sickened effect

Fire Shield

You can specify the type of shield you want to apply with the -choice argument.

-choice warmfire to create a Warm Shield
-choice chillcold to create a Chill Shield

Flame Strike

You can specify the type of additional damage you want to apply with the -choice argument when upcasting. If a choice is not provided at cast time, it will do [choice] damage by default, and adjustments may be required to the targets health, depending on resistances.

In this case, it does not check against a value, but instead just inputs whatever is given. This means you can technically have it be a Pizza Strike and deal extra [pizza] damage with -choice pizza.

Guardian of Nature

You can specify the type of form you want to apply with the -choice argument.

-choice "primal beast" for the Primal Beast option
-choice "great tree" for the Great Tree option

Hex

You can specify the affected ability score with -choice. This also applies to the Shift Hex action the spell grants for shifting the hex after the target dies.

-choice strength
-choice dexterity
-choice constitution
-choice intelligence
-choice wisdom
-choice charisma

Shield

You can have the automation automatically heal you for the damage you absorb by adding -amt [amount] to the end of the command. (-amt 5 for instance). It will heal you for the amount you specify.

Sorcerous Burst

You can specify the type of damage you want to apply with the -choice argument or by setting the SorcerousBurstDType cvar.

-choice acid for Acid damage
-choice cold for Cold damage
-choice fire for Fire damage
-choice lightning for Lightning damage
-choice poison for Poison damage
-choice psychic for Psychic damage
-choice thunder for Thunder damage

You can also set a default damage type using the SorcerousBurstDType cvar (e.g., !cvar SorcerousBurstDType lightning). The cvar will be used if no -choice is provided at cast time. If neither is provided, it will do [elemental] damage by default.

Spirit Guardians

You can specify the type of damage you want to apply with the -choice argument or by setting the SpiritGuardiansDType cvar.

-choice good, -choice neutral, -choice angelic, -choice fey, or -choice fae for the Radiant damage option
-choice evil, -choice fiendish, or -choice necrotic for the Necrotic damage option

You can also set a default damage type using the SpiritGuardiansDType cvar (e.g., !cvar SpiritGuardiansDType good). The cvar will be used if no -choice is provided at cast time.

Spirit Shroud

You can specify the type of damage you want to apply to the granted attack with the -choice argument. If a choice is not provided at cast time, it will do [shroud] damage by default, and adjustments may be required to the targets health, depending on resistances.

In this case, it does not check against a value, but instead just inputs whatever is given. This means you can technically have it be a Pizza Shroud deal [pizza] damage with -choice pizza.