This article was published for an older version of Foundry VTT and does not work for Foundry versions greater than 0.8.x.
Under the Hood is a new series that focuses on technical aspects in Foundry VTT and its modules to teach and show a new trick or two. The first article of this series is from Malakan and explains how you can use automate the
Exhaustion Condition in the Dungeon and Dragons 5e system using Combat Utility Belt (CUB) in conjunction with a few more modules (see Required Modules).
Provided with CUB is a prebuilt conditions mapping for DND5e that uses status icons for Exhaustion levels 1-5. As seen in the image, the token can easily become cluttered with exhaustion icons. Each unique exhaustion level can be conveyed by the color of the icon, rendering multiple icons unnecessary.
In the image above you can see the macro in full effect. Once you change the exhaustion level a macro will execute and remove the any other
Exhaustion Condition present on the target, but that is not all it will apply effects to the token like giving disadvantage to ability checks and others depending on the level of exhaustion. So in order to achieve this you have to follow these five steps:
- Within the
CUBPutersettings of Combat Utility Belt you need to enable enhanced conditions.
- Head over to the
Conditions Laband import the pre-build
This file can be found within the CUB module under the folder conditions-map. This will overwrite the current mapping with a preset for the DND5e conditions. The default path looks like this:
If you are not sure where to find this folder on your system, please go to the Application Configuration article on the Foundry VTT main site.
- After you have loaded the preset navigate to the different
Exhaustion Conditions. Next to each of them you can find the Active Effect Config button. Click it and navigate to the Effects tab.
- For each exhaustion level you need to add the effects listed in the table below. Remember each exhaustion level must include the previous levels’ condition effects, e.g.
Exhaustion 2must also include the disadvantage for ability checks from
Exhaustion 1. As another example you can look at the image of
Exhaustion 5at the end of the article where you can see that it includes all the attribute keys of the previous exhaustion levels.
Make sure to save the conditions mapping at the end of this step and in between the addition of each effect.
Note: Later we will be making a macro called
CUB-Exhausted, if you decide to use a different name for it, please make sure that the name matches the inputs in this step.
- Lastly create a new script type macro and check that it is run as GM. Make sure the name you have used in the
Conditions Labmatches the name of the macro (case sensitive), in this case
|Status Effect||Attribute Key||Change Mode||Effect Value|
With the macro in place, you can now click on your current exhaustion level and it will auto remove other exhaustion states so that only one exhaustion icon appears at a time with the associated effects. Although this modification will achieve only a small effect in your game, it helps show some of the customization possible in Foundry VTT.
Special thanks to Kandashi and Crymic on the Foundry VTT discord for their help with the macro, and to Mr. Weaver for their YouTube guide that provided the Active Effect configurations.