release-2.1.2

Another small release to fix some common data validation issues that users have encountered. For the full 2.1 release patch notes, please see here.

---

Bug Fixes

• [#2047] Fix group actor sheet having no minimum width or height.
• [#2039] Fix duplication translation keys in en.json.
• [#2043] Provide a migration for worlds that had bad ac.formula data.
• [#2040] Remove unused hp.min field.

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

release-2.1.1

A small patch to fix an issue with the trait selector on character sheets. Full patch notes can be found here.

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

release-2.1.0

dnd5e 2.1.0

This version of the dnd5e system for Foundry Virtual Tabletop includes a very long list of technical changes, improvements, bug fixes, and features. The most important change, from a technical standpoint, is the use of the core software's DataModel API for all Actor and Item data. This enables more robust validation for your data to help prevent you from inadvertently using bad or incorrect data in your worlds, and makes the process of migrating it easier and more seamless. A special mention once again for Jeff 'Arbron' Hitchcock, who contributed the bulk of the DataModel code to the system.

COMPATIBILITY WARNING: The version 2.1.0 release for the system ONLY SUPPORTS Foundry Virtual Tabletop version 10 (release) and greater. To use this new game system version you must also use Foundry VTT version 10. If you do not wish to update your core software, please continue using a previous 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-2.1.0/system.json

---

Features

Though the largest changes were technical in nature, there were still plenty of features added in this version.

Group Actor

A new 'group' type actor has been added that can be used to represent a group of creatures as they travel together as part of a hexcrawl, a shared inventory of items, or just as a useful reference sheet for the whole party.

Class Summary Page

A new 'class' type journal page has been added which will show an automatically generated class advancement table based on a class and/or subclass' configured advancement data.

Initiative Rolls

Initiative rolls have been given a configuration menu to allow for special bonuses to initiative to be added. When rolling for initiative, players will now be prompted with a dialog similar to the ability check roll dialog, allowing them to input any situational modifiers, or allow them to roll with advantage or disadvantage.

HP Automation

A character's max HP can now be automatically calculated based on their hit point advancement data. Hit points have also been given a configuration menu, allowing you to override the calculated value, or apply a bonus hit point amount per level. New characters will have this automation enabled automatically, but existing characters will not be affected. In order to opt-into this automation on existing characters, open the HP configuration menu and delete the overridden value.

Transformation Options

Several new transformation options have been added when transforming one actor into another, including controls for active effect transference, and an 'appearance-only' transformation.

---

Patch Notes

The full list of changes is included below:

⚠️ Breaking Changes

DataModels

The DataModels in use in the dnd5e system offer much stricter validation. This has the unfortunate consequence of rendering some Actors or Items in existing worlds invalid, even though they might have been working fine before. We don't anticipate this will affect many worlds, only those with particularly old data but in order to prevent disruption, when your GM loads into their world for the first time in 2.1.0, if any validation errors are detected, the world will be marked as 'legacy', and switch to more permissive validation. New worlds, or worlds with no validation errors, will be able to make use of the stricter validation.

Note that in Foundry Virtual Tabletop version 11, this permissive validation mode will no longer be available, however version 11 will include better tools for locating and fixing validation errors in your worlds.

In order to accommodate changes introduced by the move to DataModels, the template data prepared by Actor and Item sheets has been adjusted. If you develop a module that relies on this data, be sure to check its new format and adjust your template code accordingly. Similarly, the return result of toObject(false) differs from what downstream module code may have been used to, no longer containing any derived properties that do not exist as part of the DataModel's schema. This is an area where we are considering making changes in the core software to address. For now, retrieving a full copy of an Actor or Item's derived data for mutation purposes, without affecting the original Actor or Item can be achieved by cloneing the Actor or Item in question.

Price Data

Price data for Items has changed from a single value to an object with value, and denomination properties.

Targeting Data

How targeting data is represented in the system's configuration variables has changed. DND5E.rangeTypes has been added. DND5E.areaTargetTypes has been converted to have object values instead of strings.

Deprecated Methods & Classes Removed

• SelectItemsPrompt
• CONFIG.DND5E.classFeatures
• Non-namespaced restCompleted hook (use dnd5e.restComplete instead).
• Actor5e#addEmbeddedItems
• Actor5e#getClassFeatures
• Actor5e#loadClassFeatures

Compendium Content

• Added Forgotten Adventures token packs 37-41.
• A number of minor data adjustments to match the updated DataModels and fix errors.
• Extraneous derived data has been removed, significantly reducing the weight of the packs.
• Added new class summary journal page type capable of auto-generating its class summary table from advancement data.
• Added missing tables from the SRD5.1.
• Fixed the items and spells no longer being in alphabetical order.

Features

• [#1684] Allow access to count & dice size for single dice scale values.
• [#1316] Added an initiative configuration dialog and the ability to add situational modifiers and advantage or disadvantage when rolling initiative.
• [#1885] Centralised trait configuration, deprecating the old TraitSelector in favour of a new one, and adding a new Trait module to handle logic around actor traits.
• [#1997] Added dnd5e.preRollInitiative and dnd5e.rollInitiative hooks.
• [#1835] Implemented system DataModels for Actors and Items.
• [#866] Hit points calculation can now be fully automated and calculated based on a character's stored advancement. Migrated actors will not use this by default and must enable it by configuring their hit points and deleting the overridden value.
• [#1714] Allow use of roll data in NPC hit point formulae.
• [#1348] Feature Items now have a type and subtype field that can be configured.
• [#1979] Added attributes.spellmod to actor roll data.
• [#1970] Added a context menu to items on the actor sheet.
• [#1857] Removed the none option from various fields where it was redundant with the blank option.
• [#1687] Improved conversion when switching between scale value types during scale value configuration.
• [#1686] Added a Challenge Rating scale value type.
• [#1505] Allow for customisation of dice sizes in scale value advancement.
• [#1716] Use DataModel for Advancement data.
• [#1456] Rolling hit dice should now trigger scrolling text.
• [#1901] Attack rolls are now affected by the critical threshold of any consumed ammunition.
• [#1572] Removed unused components.value from spell Items.
• [#1100] Added an 'appearance only' option when transforming Actors.
• [#1139] Added several options for configuring active effect transfer when transforming Actors.
• [#1391] Retain token display name and bar configurations when transforming Actors.
• [#1066] Propagate any triggering click event to Item5e#use.
• [#1629] Attempting to delete an item from an Actor's sheet now prompts for confirmation.
• [#1506] Add a copy button to copy scale value identifiers to clipboard.
• [#1559] Added some missing title and tooltips.
• [#2003] Implement a system for dynamically attaching art provided by modules to Actors in compendium packs. See the wiki for details.
• [#1935] Add the group actor that can represent several Actors with a combined HP, travel speed, and a shared inventory.

Bug Fixes

• [#1839] Fix providing extra parts to Actor#rollAbility exclusively using only those parts.
• [#1985] Fix upcasting a spell not using the correct @item.level if included in its attack bonus.
• [#1239] Fix displaying 'consume resource' checkbox when rolling an item with both charges and ammunition.
• [#1238] Fix actor biographies and item descriptions not evaluating inline rolls with the correct dat.
• [#1958] Allow spells to have a blank school.
• [#1891] Fix the armour configuration dialog including shield bonus when configuring a flat or natural armour calculation.
• [#1817] Fix shorthand dX dice expressions not being appropriately doubled on criticals.
• [#1680] Fix restoring a transformation resetting a token's elevation to 0.
• [#681] Fix apostrophes in image file names preventing them from displaying correctly in some contexts.
• [#1975] Fix error in base item determination preventing an item sheet from rendering.
• [#1934] Add width and height at...

release-2.0.3

A new patch release for the dnd5e system that is mainly focused on bug fixes and stability after the Version 10 release, but also contains some new features.

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

---

Patch Notes

The full list of changes is included below:

Compendium Content

• Even more fixes for some icons that were not correctly migrated.
• Fixed Frost Giant AC.
• Adjusted maximum targets for Acid Splash to 2.
• Fixed some missing Forgotten Adventures token artwork.
• Added many more roll tables from the SRD and consolidated item descriptions to make use of them.
• Updated the Monster SRD compendium to utilise the new physical damage bypass system (see features below).

Features

• [#1620] [#1626] [#1689] Added the 'spell' type to item grant advancements that allows for configuring preparation modes and the spellcasting ability for added spell items.
• [#1707] Improved how certain warnings around actor data are displayed.
• [#1581] Added a d4 hit die to the list of available hit die choices for homebrew use.
• [#1766] Allow Active Effects to be dragged and dropped between Items.
• [#1249] [#1461] Added the concept of 'bypasses' allowing damage immunities and resistances that are bypassed by adamantine, silvered, or magical weapons to be appropriately expressed. The old 'Non-Magical Physical' has been deprecated in favour of this new system, but has not been removed.
• [#871] [#1065] Added a recovery formula to items that use charges. This formula will be automatically used to recover item charges whenever a new day elapses as part of a short or long rest.

Bug Fixes

• [#1779] Fixed an issue with d20 rolls failing when they include min() or max().
• [#1790] Fixed an infinite loop bug with custom skills on new actors.
• [#1777] Fixed an API issue where certain preconditions were not checked when creating or duplicating advancements.
• [#1769] Prevented rolling hit dice from being able to result in lost HP if a character had a particularly low Con modifier.
• [#1776] Fixed a bug with displaying the Global Skill Check Bonus in the skill config dialog.
• [#1811] Fixed a bug with setting an invalid class item identifier.
• [#1810] Fixed an issue causing upscaled spells to not receive the correct data.
• [#1809] Fixed an issue preventing the new SRD Rules table of contents from being correctly ordered when localised.

---

Contributors

Many thanks to the following contributors in particular:

• Andrew Krigline
• Ben Barbour
• Jeff 'Arbron' Hitchcock
• 'kjolern'

... as well as all those who submitted bug reports and issues.

release-2.0.2

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

release-2.0.1

dnd5e 2.0.1

We're happy to release a new version of the dnd5e system that coincides with the release of Foundry VTT version 10. As such, a large portion of the changes here have been devoted to compatibility with the new Foundry VTT version, and include lots of housekeeping and clean-up. Additionally, many bugs and small API changes have been worked on in the time since the previous release.

COMPATIBILITY WARNING: The version 2.0.1 release for the system ONLY SUPPORTS Foundry Virtual Tabletop version 10 (release) and greater. To use this new game system version you must also use Foundry VTT version 10. If you do not wish to update your core software, please continue using a previous 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-2.0.1/system.json

---

Patch Notes

The full list of changes is included below:

⚠️ Breaking Changes

Icons

The system icons under icons/items, icons/skills, and icons/spells have been removed in favour of the icons provided by core Foundry VTT. Additionally, the png token images under tokens/ have also been removed in favour of their webp counterparts. All of these images were migrated a while ago and so we do not expect this change to cause much disruption. If you have your own compendium packs, or if you are a module author that provides compendia with your module, you can trigger a migration that will convert the images automatically with the dnd5e.migrations.migrateCompendium utility.

Dropping Folders on an Actor

To align with the core API signature, _onDropItemCreate now accepts an array of itemData and calls the new _onDropSingleItem for each item provided in this way. Overrides of _onDropItemCreate that do not expect multiple items should override _onDropSingleItem instead.

Number Inputs

All <input> elements that were previously using data-dtype="Number" have been changed to <input type="number"> instead. Any styles or other selectors targeting these elements may need to be updated.

Skills Refactor

The CONFIG.DND5E.skills object has been refactored into an enum of objects rather than strings.

Actor5e Refactor

In order to clean up and smooth out the preparation flow for actors, the Actor5e class has had a few methods renamed and shuffled around. The original methods continue to exist and will log a deprecation warning until they are removed in a few more versions.

• _computeArmorClass -> _prepareArmorClass (no longer returns a value)
• _computeEncumbrance -> _prepareEncumbrance (no longer returns a value)
• _computeInitiativeModifier -> _prepareInitiative
• _computeSpellcastingProgression -> _prepareSpellcasting
• _simplifyBonus -> dnd5e.utils.simplifyBonus

⚠️ Project Restructure ⚠️

The entire dnd5e project has undergone an internal restructuring. As part of this, all ESM files that previously had a .js extension have been renamed to .mjs instead, and all Handlebars templates with an .html extension have been renamed to .hbs. Additionally, the system is now provided as a single, rolled-up file to end users. This means that if your module was previously importing individual files or classes from the dnd5e system directory, those imports will no longer work. All of the public classes are available on the dnd5e object, however, and this object should be available to your module code immediately, without any need for hooks.

Remove any imports like the following:

import ActorSheet5eCharacter from '../../../../systems/dnd5e/module/actor/sheets/character.js';

Where your module references dnd5e classes, such as ActorSheet5eCharacter, replace them with the following:

class MyCharacterSheet extends dnd5e.applications.actor.ActorSheet5eCharacter {}

Compendium Content

• Added Forgotten Adventures token packs 29-36.
• Fixed the number of targets for Telepathic Bond.
• Updated the SRD Rules compendium to use the Journal Pages feature.
• Fixed the weight and cost of the Herbalism Kit.
• Fixed some icons that weren't correctly migrated.

Features

• [#1441] Moved migration version constants into system.json flags.
• [#1553] Added the ability to duplicate Advancements.
• [#1664] Prompt the GM to reload the world when they change system settings that require it.
• [#1673] Added short names for Handlebars partials.
• Added several additional hooks to the item and actor rolling workflows. See the wiki for details.
• [#1667] Fixed an instance of a low-contrast icon.
• [#1643] Improved the rollSkill signature to allow options to more easily pass through.
• [#1693] Improved the d20Roll API to allow for critical successes and failures to be deliberately suppressed.
• [#1677] Added an identifier to measures templates created by items.
• [#1543] Improved the item#roll API to allow certain resource consumptions to be disabled.
• [#1675] Added UUIDs to Advancement objects.
• [#1532] Display tool's type on its sheet header.
• [#1706] Add support for vehicles (space) tool proficiency.
• [#1314] Allow modules to customise the available skills by modifying CONFIG.DND5E.skills.
• [#1610] Add the ability to apply temporary HP from the context menu on dice rolls.

Bug Fixes

• [#1476] Fixed issue with dropping a folder onto an actor sheet.
• [#1649] Fixed several bugs in item grant advancement.
• [#1691] Fixed an issue preventing the ProficiencySelector from showing selected items.
• [#1607] Avoid setting NPC weapon proficiency or equipped status if already provided at creation time.
• [#1470] Fixed unnecessary system migration in some cases.
• [#1698] Fixed rollDeathSave not respecting the roll mode when displaying dead/stable.
• [#1556] Fixed level selector issue for classes that did not have Advancements configured for all levels.
• [#1652] Fixed an issue where Advancements on owned items would not be triggered if the class did not have an Advancement for that level.
• [#1683] Fixed hit die rolls not included their derived data.
• [#1748] The dnd5e.useItem hook should now be called even if the item's associated measured template is cancelled.
• [#1140] Fixed doubling crit dice if the formula for the dice rolled contained a parenthetical expression.

---

Contributors

Many thanks to the following contributors in particular:

• Calego
• Chris Seieroe
• Daniel Thorp
• 'DjinnStar'
• 'Giddy'
• Kevin Winkler
• 'kjolern'
• Jeff 'Arbron' Hitchcock

... as well as all those who submitted bug reports and issues.

release-2.0.0-alpha3

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

release-2.0.0-alpha2

Overview

Ths 2.0.0-alpha2 release of the dnd5e system is designed to facilitate testing of Foundry Virtual Tabletop version 10 and is verified as compatible with V10 Testing 1 release 10.275 https://foundryvtt.com/releases/10.275

Installation

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

release-2.0.0-alpha1

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

Release 1.6.3

This release includes no code changes or features except to formally conclude the package migration to GitHub.