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

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.

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.

Spirit Guardians

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

  • -choice goodneutralangelicfeyfae for the Radiant damage option

  • -choice evilfiendish for the Necrotic damage option

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.