release-2.4.0
The 2.4 update contains some long-awaited features such as the Race Item, as well as the continued development of the Advancement system in the form of the Trait Advancement that encompasses saving throw, skill, tool, weapon, armor, and language proficiencies. In addition to these big features, the update also contains a great many fixes and improvements to all areas of the system.
Installation: To manually install this release, please use the following manifest URL: https://github.com/foundryvtt/dnd5e/issues/releases/download/release-2.4.0/system.json
Races
The new race Item allows for a character's race to be dragged-and-dropped onto their sheet, bringing with it any racial features, ability score improvements, and proficiencies. Read more on the wiki in Custom Race Tutorial.
Existing characters will retain whatever they had filled-in as their race on their character sheet previously, and may continue to use the text field if they prefer. If you add a race Item to your character's sheet, however, the name of that Item will become your character's race, and you will be able to edit their creature type on the sheet.
Trait Advancement
The landscape of proficiencies in the game rules can be quite complex if we think about granting the choice of skill proficiencies, expertise, different rules for multiclass characters, etc. The new Trait Advancement allows for a comprehensive configuration of all of these things, allowing users to create custom classes and races that grant proficiencies in the same way as the core rule system. For a thorough overview of this feature, please see the wiki article on Trait Advancement.
Custom Enrichers
Custom enrichers speed up the process of writing adventure content for the system. Writing ability check, saving throw, and damage rolls in a special syntax will allow them to be automatically expanded into the full rules language familiar to readers, but will additionally hook into the roll functionality of the system. See the article on Custom Enrichers in the wiki for more information.
Patch Notes
The full list of changes is included below:
⚠️ Breaking Changes
Class Item Data Changes
The system.saves
and system.skills
properties have been removed from the class
Item as these are handled by the Trait Advancement now.
Single Background Items
It is no longer possible for Actors to have more than one background
Item. This will not affect existing Actors that have more than one background
, but no additional background
Items will be able to be added until the all the other have first been removed.
End of Deprecation Period
The following parts of the API have reached the end of their deprecation periods, and have been removed.
DamageTraitSelector
ProficiencySelector
ActorSkillConfig
CONFIG.DND5E.abilityAbbreviations
Item5e#roll
Item5e#getCriticalThreshold
AbilityUseDialog Changes
We have refactored the resource consumption dialog to make it clearer how options on resource consumption flow from initial item configuration through to the user's choice. As a result, some signatures have been changed.
AbilityUseDialog#create
now takes a secondconfig
parameter that contains the default resource consumption options configured on the Item (as modified by any intervening hooks).- The
ItemUseConfiguration
object has had several properties changed:consumeQuantity
has been removed and rolled into the functionality ofconsumeUsage
.consumeRecharge
has been removed and rolled into the functionality ofconsumeUsage
.needsConfiguration
has been removed. This is now inferred from the state of the overall config. If no properties aretrue
, then no configuration is necessary and the dialog is skipped.consumeSpellLevel
has been renamed toslotLevel
.
Documentation
- [#2481] Added an Active Effect guide to the DnD5E wiki.
Compendium Content
- [#2488] Added Forgotten Adventures token packs 49 through 52.
- [#2585] Updated Starter Heroes to include proper races and classes with traits.
Features
- [#342] Added a Race Item type which functions similarly to the Class Item.
- [#1405] [#1016] Added a new Advancement Type, "Trait" which makes it easy to provide advancements like saving throws, weapon, armor, and skill proficiencies, and languages, etc.
- [#1865] Added custom enrichers for rolling checks and saves inline.
- [#2220] Added a new "Size" Advancement Type.
- [#2529] Added an enricher for damage.
Improvements
- [#986] Square/cube spell templates can now be rotated.
- [#1202] [#1960] Added creature type data to character Actors.
- [#2024] Improved how spells are added to Actors. Spells now have their type (Prepared, Innate, Pact, etc.) set by where they are dropped on the character sheet.
- [#2135] Added the ability to edit unidentified and chat descriptions by including multiple inline editors. There is no additional functionality associated with unidentified descriptions yet.
- [#2136] When sending to chat the System now uses an Item's "chat description" if specified.
- [#2215] Measured Templates now include a reference to the level of the spell that created it in
flags.dnd5e.spellLevel
. - [#2243] NPCs now display how many Items are in a stack in their inventory without having to view the Item's details, just like characters.
- [#2279] Updates caused by a short or long rest are now passed the
isRest:true
option in the update. - [#2442] Improved trait selector windows so only the input scrolls but the Update button is always visible.
- [#2444] Active Effects from an Item now default to the Item's icon and label/name.
- [#2446] Inspiration can be toggled by clicking on the label as well as the checkbox itself.
- [#2462] Added "Dawn" and "Dusk" as options for Limited Uses. There is no additional functionality associated with these limited use types yet.
- [#2463] Added an option on Items to suppress the consume resource or create template prompts.
- [#2465] Reimplemented the "None" option as a valid activation cost in Items.
- [#2478] Added a Details tab and subtypes (Art Object, Gemstone, Junk, etc.) to Loot Items.
- [#2495] Module-provided Actor subtypes can now use core data preparation.
- [#2504] Expanded the Actor and Item
source
field to contain more structured data. - [#2528] Added support for language subtypes and organized languages into Standard, Exotic, and other subtypes to be consistent with the rules.
- [#2545] Created a mixin for Actor sheets that can better allow certain functionality to be shared between group sheets and other Actor sheets.
- [#2548] Updated
ScaleValueAdvancement
to work with backgrounds and races. - [#2558] Advancements now support different defaults depending on Item type.
- [#2560] Added a max increase on
AbilityScoreImprovementAdvancement
which allows Tasha-style customization for players to grant +2 in one score and +1 in another or +1 to three scores. - [#2561] The System now displays ASI options in the advancement summary.
- [#2586] Added support for spells to be upcast using resource consumption.
- [#2387] Revised the relationship between
Item5e#use
andAbilityUseDialog.create
to consolidate logic in one place.
Bug Fixes
- [#968] In a character sheet it is now possible to add multiple special senses by separating them with a semi-colon.
- [#971] Consuming a Resource with another Item now correctly triggers "Delete on Empty".
- [#1668] Updated the CSS for the Item sheet to prevent double scroll bars from occurring in some situations.
- [#2232] [#2165] Fix resources being removed from the list of consumable resources if their values are set to 0.
- [#2245] The Group Actor sheet now supports stacking consumables.
- [#2281] When flipping a coin with
1dc
it will no longer be coerced into a die roll and merged. - [#2285] A resource prompt is no longer shown when consumption is set to "None".
- [#2286] A resource prompt is no longer shown when the item has no activation type.
- [#2288] Charges for an Item will no longer appear when
Item#hasLimitedUses
is set to false. - [#2289] The
Item5e.use
method now respectsconfig.createMeasuredTemplate=false
for area of effect spells. - [#2350] Actors can no longer roll their items/features when in a Compendium Pack.
- [#2441] Fixed an issue that could result in ability scores becoming
NaN
and prevented ASIs from going beyond their maximum. - [#2451] Fixed an issue with custom skills and abilities which caused transformations like Wild Shape to fail.
- [#2456] Macros that fail to find a valid Actor or Item no longer return a notification ID and instead post a warning notification.
- [#2457] Item Choice Advancements now accept drops from Players.
- [#2459] The
Item.determineSuppression
method now correctly interprets the origin for Items on synthetic Actors. - [#2468] The
dnd5e.preRollInitiative
hook no longer passesundefined
instead of a Roll instance when usingactor.rollInitiative
. - [#2470] Fixed an issue where an ASI would be applied incorrectly when an effect targets that ability.
- [#2472] Weapons with ammunition now take into account the ammunition's damage.
- [#2476] Fixed an issue that prevented creating spells on an Actor with no spellcaster levels.
- [#2479] Fixed using a consumable item with a negative consumption value failing if the consumed resource is at zero.
- [#2496] "Uses" on the actor sheet are now localized.
- [#2515] Fixed a compatibility warning thrown by the
ActiveEffect#label
when used in templates. - [#2571] Creating a measured template via the chat card of an upcast spell now uses the correct spell level.
- [#2590] It is now possible to drag advancements from locked classes by players.
Contributors
Many thanks to the following contributors in particular:
- Diego Rodríguez
- etiquettestartshere
- Honeybadger
- Hoppyhob
- Ikaguia
- Jeff 'Arbron' Hitchcock
- kaelad02
- MaxPat931
- Taverna del Beerholder
- Zhell
... as well as all those who submitted bug reports and issues.