Skip to content

release-2.4.0

Compare
Choose a tag to compare
@github-actions github-actions released this 16 Nov 17:43
· 2386 commits to master since this release
3e26c7c

chrome_034MSS75KE

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.

Editing movement, speed, & senses

Configuring ability score increases and size

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.

Granting saving throw proficiencies

Choosing skill proficiencies from a set

Making your skill proficiency choices

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.

Enrichers preview

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 second config 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 of consumeUsage.
    • consumeRecharge has been removed and rolled into the functionality of consumeUsage.
    • needsConfiguration has been removed. This is now inferred from the state of the overall config. If no properties are true, then no configuration is necessary and the dialog is skipped.
    • consumeSpellLevel has been renamed to slotLevel.

Documentation

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 and AbilityUseDialog.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 respects config.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 passes undefined instead of a Roll instance when using actor.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.