foundryvtt/dnd5e release-5.2.0 on GitHub

Ship art by Epic Isometric

The 5.2 release of the D&D Fifth Edition system brings a new calendar, updated vehicle sheets, and improved integrations between vehicles and groups. It also contains a large amount of bug fixes and smaller refinements to the underlying API as well as improvements to the SRD content as we continue to integrate newer system features with it. As always, you can see the full list of all changes at the bottom.

⚠️ COMPATIBILITY WARNING: ⚠️ The version 5.2 release of the system ONLY SUPPORTS Foundry Virtual Tabletop version 13 and greater. To use this new game system version you must also use Foundry VTT version 13. If you do not wish to update your core software, please continue using an earlier version of the dnd5e system.

Installation: To manually install this release, please use the following manifest URL: https://github.com/foundryvtt/dnd5e/releases/download/release-5.2.0/system.json

Calendar

The system now integrates with the core Foundry VTT's calendar API, providing a HUD to help you track time in your campaign, and comes with several calendar systems from popular D&D settings pre-configured.

The DM can enable the calendar for use in their world via the system settings.

Once enabled, they can configure how the date is displayed, including using only approximate descriptors for settings and groups where exact timekeeping may not be available.

The HUD also includes several useful buttons, allowing you to access your character sheet directly, or the primary party sheet. It also includes some DM-only buttons that allow the DM to advance or reverse time, or jump to a specific date.

In future releases, we plan to integrate the calendar with bastion turns and item recovery, allowing items to recover their uses at dawn or dusk as intended. For full details on the calendar system and its API, please see the wiki.

Activity & Effect Visibility

In earlier versions of the system it was possible to configure ActiveEffects provided by activities to only be available within certain level ranges. For example, an Enchant activity might provide several enchantments, but only one of them will be available to use, depending on the level the spell was cast at. This logic has now been consolidated across all ActiveEffects associated with activities, restricting the list of effects that can be applied via the effect application tray based on these level limits.

This concept of visibility has been extended to the activities themselves. The version 5.2 release of the system provides several new ways to constrain activity visibility, preventing them from being seen on the item sheet while in Play mode, or in the inventory view, as well as removing them from the list of available activities to choose from when using an item if the requisite criteria for the activity's availability are not met.

For a more details on how this works, please see the wiki.

Vehicle Sheets

The last remaining document sheet in the system, the vehicle sheet, has now been converted to the ApplicationV2 framework, and been given a redesign, finally completing the work that was started in version 3 of the system.

Ship art by Epic Isometric

The sheet has support for most iterations of vehicle rules published in official content, and various options for those rules can be toggled in the vehicle sidebar in edit mode.

Notable additions include tracking crew quality, and automatic calculation of available action points based on the configured thresholds and the current number of crew.

Ability scores are available for legacy vehicles that still use them.

Additionally, the way crew and passengers are handled has been completely overhauled. You may now drop creatures directly from the Compendium Browser in order to fill out the crew and passengers. You may also create bespoke Actors in the sidebar and use those if you wish to customise some aspects of them.

For vehicles that use action stations, such stations can be configured in the item sheet.

And then crew may be assigned to the station via drag-drop.

For land vehicles that are not self-propelled and therefore do not have a speed of their own, draft animals may be attached, and the vehicle's cargo capacity will be appropriately updated.

Group Sheet Integration

Finally, to complement the new vehicle sheets, the group sheets now feature some additional integrations. Vehicles added to the group may now be designated the 'primary vehicle'. The group's travel speed will adjust to match the vehicle's, and the vehicle's inventory will become available to use as the group's inventory via a new toggle.

⚠️ Breaking Changes

Vehicle Migrations

The improvements to the vehicle sheet involved migrating its data to a more structured format. Unfortunately, several fields that were previously being used were implemented as free-form text fields and cannot be migrated automatically since the structure of their contents can't be guaranteed. These fields were: Dimensions, Creature Capacity, and Crew & Passengers. This data has not been removed in the update. It still exists, but will be invisible on the new sheets.

If your World has a great many vehicles where it would be arduous to manually convert these fields, it might be possible to perform a bespoke migration if your data is in a predictable format, such as if it matches the formatting in official stat blocks.

There are several resources that can help you with such a migration. The #macro-polo and #dnd5e channels on the official Foundry VTT discord server may be able to help, but please, before asking for help, show them this text to provide some context for your request.

Additionally, you can open an issue on the tracker titled 'Vehicle Migration Request', and either the maintainers or someone from the community may be able to help you. In your request, please include clear examples of how these text fields are formatted. You can retrieve such an example by opening the vehicle's sheet and running the following script macro:

const { actor } = ui.activeWindow ?? {};
if ( actor?.type !== "vehicle" ) return ui.notifications.warn("No vehicle Actor found.");
game.clipboard.copyPlainText(JSON.stringify(actor.system.toObject(), null, 2));
ui.notifications.info("Copied vehicle data to clipboard.");

Compendium Content

[#4759] Fixed the Ghoul and Ghast's Bite to hit modifier in the SRD 5.1.
[#4967] Removed lengthy requirements for the ASI feature in the SRD 5.1.
[#5312] Added the magical property to the weapons of creatures with the Magical Weapons trait in the SRD 5.1.
[#5837] Fixed spell scroll auto-generated prices in the SRD 5.2.
[#5902] Fixed "Dark One's Blessing" not appropriately adding Charisma modifier in the SRD 5.1.
[#5925] Adjusted the SRD 5.2's version of Flurry of Blows to consume a Focus Point only.
[#5960] Adjusted the Fiend patron's advancements to grant its spells as 'Always Prepared' in the SRD 5.2.
[#6049] Added the ritual tag to Detect Poison and Disease in the SRD 5.1.
[#6070] Fixed missing award link in the Fighter class page in the SRD 5.2.
[#6082] Fixed the Owl dealing radiant damage in the SRD 5.2.
[#6098] Fixed several instances of incorrect embed references in the SRD 5.2.
[#6099] Fixed a broken link in the Long Rest embed in the SRD 5.2.
[#6100] Fixed a missing rules page for the Stable rule.
[#6101] Fixed some instances of the SRD 5.2 using the old journal sheet.
[#6115] Greater Healing Potion now set to 'Destroy on Empty' in the SRD 5.2.
[#6117] Added advantage to Strength checks and saves to the Rage effect in the SRD 5.2.
[#6132] Adjusted Alchemist's Fire to deal no damage on a successful save in the SRD 5.2.
[#6133] Added advantage automation to Beacon of Hope in both the SRD 5.1 and 5.2.
[#6134] Added disadvantage automation to Bestow Curse in both the SRD 5.1 and 5.2.
[#6137] Added automation to the Monk's Disciplined Survivor in the SRD 5.2.
[#6148] Added Ice Knife to the SRD 5.2.
[#6172] Added missing Giant Centipede and Giant Wasp to the SRD 5.2.
[#6174] Corrected the creature summoned by the Giant Insect's 'Giant Spider' option.
[#6248] Fixed the Ioun Stone of Fortitude's bonus in the SRD 5.2.
[#6338] Added missing ruletip in the Prone condition.
[#6347] Fixed the Frost Giant's Great Bow having the Heavy property.
[#6363] Added the halflingNimbleness flag to the Halfling species in both the SRD 5.1 and 5.2.

Bug Fixes

[#3748] Fixed summoned creatures always appearing at 0 elevation.
[#4398] Fixed pre-configured filters being ignored in some circumstances when launching the Compendium Browser.
[#4721] Fixed enchanted items showing incorrect tags in chat messages.
[#4742] Fixed disabled special facilities not being able to be manually re-enabled.
[#4772] Fixed activities granted by enchantments still being available even if the enchantment is disabled.
[#4877] Fixed behaviour of compendium browser filter toggles in Firefox.
[#4896] Fixed scale value identifier slugification.
[#4989] Fixed items sometimes consuming their own quantity despite being configured to consume a different item's quantity.
[#5031] Fixed NPC stat block embeds displaying 'undefined' for missing creature types.
[#5151] Fixed ignored compendium contents appearing in the Compendium Browser under some circumstances.
[#5357] Fixed failure when attempting to summon an Actor if one had already been cached in the World, but the summoner did not have ownership of it.
[#5388] Fixed Items configured with 'Destroy on Empty' not being appropriately destroyed when losing all their charges as part of a rest.
[#5425] Fixed attempting to refund consumption of a consumed hit die resource.
[#5907] Fixed the 'Grid Aligned Square Templates' not appropriately preventing template rotation.
[#5920] Fixed the dnd5e.postBuildDamageRollConfig not including the updated damage type if changed in the dialog.
[#5933] Fixed summoned Actors losing their ActiveEffects under some circumstances.
[#6027] Fixed creation dialogs swallowing keyboard navigation inputs.
[#6057] Fixed deleting an exhaustion effect not being correctly reflected in the Actor's internal data.
[#6059] Fixed showing a blank boon recommendation on class journal pages if no recommendation is configured.
[#6075] Fixed the 2014 statblock embeds not capitalising skills, senses, & languages.
[#6089] Fixed an infinite loop that could occur when creating a Cast activity for a spell Item owned by the same Actor.
[#6103] Fixed damage lines from stored rider activities showing as part of the parent Item's damage summary.
[#6122] Fixed damage bonuses not being evaluated before being applied to summoned creatures' attacks.
[#6141] Fixed ASI advancements being created with 0 points configured.
[#6161] Fixed advancements on species not always granting all configured Items.
[#6170] Fixed disabled facilities still being useable via favourites.
[#6177] Fixed then spell slot consumption path for pact spells.
[#6180] Fixed the spell attack modifier's human readable label.
[#6181] Fixed spell list journal page embeds.
[#6198] Fixed rider activities with 'Start of Turn' activation still firing even if the enchantment was disabled.
[#6200] Fixed saving throw proficiencies omitted from 2014 NPC statblock embeds.
[#6217] Fixed negative to hit modifiers not showing in the inventory view.
[#6218] Fixed [[/item]] enrichers with an Item UUID failing to accommodate a given activity parameter.
[#6224] Fixed Map Location pages failing to render when the 'Display Page Title' option was unchecked.
[#6228] Fixed some instances of the Item sheet displaying pre-modified labels for enchanted Items.
[#6237] Fixed summoned creatures having their hit points rolled if the 'roll NPC hit points' setting was enabled.
[#6238] Fixed certain token adjustments being lost when a transformed token is reverted.
[#6242] Fixed multiplying damage modification via ActiveEffect producing an incorrect result if the base value was 0.
[#6250] Fixed swarm size not being taken into account when determining token blocking rules.
[#6251] Fixed the 'consume resource' button in chat messages not functioning if the consumed resource was a spell slot.
[#6258] Fixed AdvantageMode.combineFields returning the incorrect advantage/disadvantage value under some circumstances.
[#6276] Fixed automatic activity scaling not taking signed-ness of the consumption value into account.
[#6278] Fixed rendering a wildcard token image in the transformation dialog.
[#6308] Fixed consumption label when casting a spell where its consumption target does not exist.
[#6329] Fixed reverting a transformed token with a wildcard image configured not always reverting to its original image.
[#6340] Fixed Compendium Browser entry icons not acting as drag targets.
[#6348] Fixed reverting a transformed Actor not reverting to its root original form if it had been transformed more than once.
[#6361] Fixed ActiveEffects upgrading telepathy range failing to apply if no base telepathy range was configured.
[#6365] Fixed class journal pages throwing an error when attempting to render certain spellcasting types.
[#6366] Fixed some cases where damage formulae would not render all their dice in the breakdown.
[#6370] Fixed error thrown when attempting to prepare custom spellcasting methods that did not implement computeProgression.
[#6372] Fixed rendering enrichers with activity references in class and subclass journal pages.
[#6383] Fixed re-application of ActiveEffects for unlinked token Actors in some circumstances.
[#6389] Fixed regression in caption-top CSS class for embeds.
[#6391] Fixed the Spellcasting feature rendering a uses label in embedded statblock in some circumstances.
[#6412] Fixed advancements generating duplicate synthetic steps in some circumstances.
[#6416] Fixed incorrect minimum hit point recovery when expending hit dice using modern rules.
[#6418] Fixed item grant summaries in advancement views not correctly wrapping.
[#6425] Fixed embedded statblocks not showing a mythic action section.
[#6426] Fixed embedded statblocks not showing legendary action costs.
[#6427] Fixed activities with Mythic Action activation not appropriately consuming legendary actions when used.
[#6443] Fixed a typo in class journal pages.

Improvements

[#3060] [#3505] Roll expressions are now evaluated as part of movement fields.
[#3077] The configured token or portrait image is now respected when posting chat messages.
[#3168] Relaxed restrictions on which properties can be configured on spell Items.
[#4331] Rider activities may now be configured with options that aren't available to the parent Item type.
[#4518] Activities may now be configured with level ranges.
[#4546] The Compendium Browser is now re-rendered when its configured sources are modified.
[#4570] Consumed hit dice may now be referenced as part of the activity's action.
[#4630] Post-roll configuration hooks now receive information on which ability was used for ability checks.
[#4638] Added temp HP to the list of available token bar resources.
[#4700] Added weapon mastery properties to weapon tooltips.
[#4728] Item rows in the inventory view now only show the damage of the primary activity.
[#4760] Newly-added consumptions on activities now default to item consumption if the item has uses configured.
[#4962] Improve filtering options for feats in the Compendium Browser.
[#4963] Activities may now be configured with various conditions under which they become available or unavailable.
[#5029] Added an enricher for showing which members of the primary party have access to a given language.
[#5224] Attack roll modifiers and save DCs for Cast activities are now shown in the inventory view's activity breakdown.
[#5237] [#5293] Allow for configuring currency as part of starting equipment.
[#5266] Added an API for overriding certain parts of an embedded statblock display.
[#5352] Added 'Trade Good' as a loot Item category.
[#5357] Converted the vehicle Actor sheet to the ApplicationV2 framework.
[#5541] Added the ability to select items with activities as consumption targets.
[#5633] Added calendar interface.
[#5643] Added several calendar options for popular D&D settings.
[#5858] Added 'Wondrous Item' as a consumable item category.
[#5932] Consumption targets now use human-readable labels where available.
[#5961] The list of retained spell lists in the Transformation dialog is now filtered by availability.
[#5962] Added an option to retain temporary hit points when transforming.
[#5982] Quantity is automatically rolled when placing members from an Encounter if the member has a roll formula configured but no quantity yet.
[#6015] [#6042] Added more granular settings for movement automation.
[#6019] Added 'Webs' as a difficult terrain type.
[#6039] Added hooks for customising token blocking and difficult terrain logic.
[#6061] Added approximate conversion for month durations when applying ActiveEffects.
[#6119] Rolls now indicate which method was used to generate them.
[#6138] Added the 'Match Disposition' option to Summon activities.
[#6164] The Summon activity's 'Match Ability' drop-down is now clearer about which ability will be matched.
[#6171] Allow group Actors to configure a primary vehicle and use its inventory.
[#6187] Added hints to the plain text consumption target field shown on unowned Items.
[#6190] Converted all creation dialogs to the ApplicationV2 framework.
[#6197] Cast activities can no longer be added to spell Items.
[#6207] Added automation for damage thresholds.
[#6208] Added damage thresholds to creatures.
[#6210] Added automation for the 'Slower Travelers' rule from the DMG.
[#6255] Tools can now have the Focus property.
[#6259] All effects associated with activities may now have level ranges configured.
[#6264] The feature prerequisite field now accepts a type prefix.
[#6295] Movement and travel data can now represent per-round, per-hour, and per-day speeds.
[#6304] Allow for configuring an overall movement bonus that applies to all speeds.
[#6364] Information is now hidden from users without appropriate ownership of group members when rendering the group sheet.
[#6390] Added uses label to the Legendary Resistances trait in embedded statblocks.
[#6430] Improved the display of large numbers in the NPC sheet sidebar.
[#6455] An optional hint may now be configured when rendering the Compendium Browser.

Contributors

Many thanks to the following contributors in particular: @Aioros, @arbron, @Fyorl, @IvanMathy, @krbz999, @roth-michael, @Sayshal, @thatlonelybugbear

Installation: To manually install this release, please use the following manifest URL: https://github.com/foundryvtt/dnd5e/releases/download/release-5.2.0/system.json