release-3.1.1

Resolved a number of bugs with new features.

---

Compendium Content

• [#3311] Remove incorrect damage scaling from Magic Missile

Bug Fixes

• [#3175] Legacy resources should not longer increment when entering editing mode when their max is modified by an active effect
• [#3295] Active effects on summoned creatures now have properly localized names
• [#3298] Races should no longer throw errors when deleted
• [#3299] Browsing pre-v10 compendiums should no longer throw errors
• [#3301] Concentration warning will no longer display concentration warning if spell doesn't require concentration
• [#3306] Versatile damage will no longer throw an error when rolled
• [#3308] Summoning should now always properly apply changes to items on summoned creature
• [#3310] Blank damage lines will now be discarded when rolling damage
• [#3311] Upcasting spells without scaling formulas should now work correctly
• [#3313] Class journal pages should no longer throw error when class is dropped on them

---

Contributors

• Jeff 'Arbron' Hitchcock
• Zhell

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

release-3.1.0

The 3.1 release of the system brings with it a whole host of long-awaited features including damage application automation, concentration automation, and summoning. The full list is much longer, so please read ahead for an overview of the new features with full patch notes at the bottom.

⚠️ COMPATIBILITY WARNING: ⚠️ The version 3.1.0 release of the system ONLY SUPPORTS Foundry Virtual Tabletop version 11 (release) and greater. To use this new game system version you must also use Foundry VTT version 11. 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-3.1.0/system.json

---

New Features

Dark Mode Character Sheet

Any kobold players suffering from Sunlight Sensitivity will appreciate the new dark mode theme for the character sheets.

Character portrait art by mikiko.art

If your OS is set to prefer dark mode then your character sheets will render in dark mode by default. If you would like to force a particular theme for the dnd5e system, you can do so from the settings menu. At the moment, only character sheets have a dark theme but as more sheets are shifted to the v2 styles they will also come with dark mode designs.

Concentration Automation

The system now includes robust automation around casting and maintaining concentration on spells and other features.

Firstly, if you'd like to continue tracking concentration manually, you may opt-out of the automation via the system settings:

For those using the new automation, the system will now keep track of when a character casts a spell that requires concentration:

And it will remind that character when they attempt to cast another spell that requires concentration:

Finally, it will prompt the character's owner to make a Concentration saving throw whenever that character takes damage, with an appropriate DC based on the damage taken.

Ad-hoc Concentration saving throws can be made from the character sheet:

And various modifiers and bonuses relating to Concentration saves can also be configured:

When applying the effects of a spell that requires concentration to other creatures, those effects become linked to the caster's concentration effect. If concentration is ever broken, the linked effects are removed.

Summoning

The system includes the ability for automatically bringing summoned creatures into your world. This allows you to reference a list of creatures to be summoned from a feature or spell, modify the actors before they are brought into the world, and place them where you wish in the scene.

Summoning items can be set up by selecting the new "Summon" action type on an item's details tab and then opening the summoning configuration window. Multiple summons profiles can be configured which will be selectable by the player when using the spell to bring different creatures into the world. Variable parts of the summoned creature's stat block can be tweaked based on level of spell cast or other details from the summoner.

More information on summoning can be found on the wiki.

Resistances, Immunities, & Vulnerability Automation

The damage roll card has now been expanded to offer a live preview of damage application, appropriately taking into account any of the target's resistances, immunities, or vulnerabilities.

The tray allows the DM to choose between a fixed list of creatures that were targeted at the time the damage roll was made, or to preview the damage against any tokens they have currently selected.

In addition to the buttons which control a fixed multiplier to the damage dealt, any resistances, vulnerabilities, or immunities that are affecting the damage the creature would take are also displayed. These toggles are interactable and allow for ad-hoc ignoring of any given resistance, vulnerability, or immunity, or optionally downgrading an immunity to resistance. The damage preview will automatically update to show the amount of damage the creature will take.

---

⚠️ Breaking Changes

• [#3099] Clicking anywhere in the item description in a chat card collapses the description.
  • As part of fixing this, we have moved to a new CSS-only technique for handling collapsibles in the system. This changes the markup of chat messages very slightly, and will mean that old chat messages render expanded always, and cannot be collapsed. Messages made after the update will work as expected.
• [#3035] Improve detection of when a creature takes damage and provide appropriate hooks.
  • As part of implementing this, the old dhp and dtemp options that were sometimes sent as part of Actor update requests have been removed. They would only be available some of the time and did not cover all cases where an Actor might take damage. The new dnd5e.damageActor and dnd5e.healActor hooks should appropriately fire whenever an Actor is damaged or healed now.
• [#3264] Deprecated LimitedUseFormulaPeriods in the config.
  • CONFIG.DND5E.limitedUsePeriods entries have become objects. The formula property of these objects determines whether the period has a recharge formula, obviating the need for CONFIG.DND5E.limitedUseFormulaPeriods.
• [#3248] Apply healing based on damage type rather than requiring a negative multiplier.
  • Actor5e#applyDamage now accepts the invertHealing option which is true by default. When encountering a healing damage part, it will automatically apply the value as healing rather than damage. Code that previously called this method with a negative multiplier in order to apply healing should be updated to pass invertHealing: false.
• [#3255] Migrate ItemGrant & ItemChoice Advancements to store configured Items as objects rather than UUID strings.
  • There is an automatic migration & compatibility path in effect for this change, but code that creates these Advancements should update to pass an array of { uuid: string } objects rather than an array of strings to the Advancement's configuration.
• [#3031] The metadata on abstract data models is now frozen.
• [#2747] Added support for advancements on custom module types.
  • Advancement.metadata#validItemTypes has been deprecated in favour of configuring valid types via CONFIG.DND5E.advancementTypes. This config variable has also had its entries migrated to objects.

---

Bug Fixes

• [#3254] Fixed an issue with Dynamic Token Rings flashing if the colors object has null values.
• [#3224] Stored item data in chat cards can now contain Active Effects. This means using the last of a consumable with an Active Effect and a 1/1 destroy on empty charge will still be able to apply the Active Effect.
• [#3200] Empty values in the Available Uses field no longer show as null.
• [#3195] Fixed the Wing Attack on the SRD Adult White Dragon.
• [#3182] Dropping an advancement with "Any Level" onto a class no longe rprevents them from being displayed.
• [#3180] Invalid Actor sizes no longer prevents the Actor sheet from rendering.
• [#3178] Dropping a Spell onto an Equipment Item no longer initiates the prompt for copying advancements.
• [#3165] The system no longer offers to place a measured template if no Scene is open.
• [#3163] Spell damage now always include the magical property for overcoming resistances.
• [#3130] Improved CSS for the indicator on exploded dice to prevent it from becoming misplaced in some circumstances.
• [#3099] Fixed chat messages collapsing when clicking on the details element.
• [#3075] The system now prevents duplicates targets from the same Actor and no longer throws an error if the Actor is missing.
• [#3065] Roll commands no longer throw an error when using multiplication or division and the _enrichRollTooltip method now passes the roll's original formula.
• [#3058] Improved CSS to better support alternate font sizes in the 3.0.0 character sheet.
• [#2935] Revise AE application methods to enable correct duration tracking.
• [#2920] Formula data in attack bonuses now works on ammunition.
  ...

release-3.0.4

Additional bug fixes including compatibility with the PopOut! module.

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

---

Improvements

• [#2786] Speed tooltip will now always show walking speed even if zero
• [#3103] Race & background items on character sheet can now be dragged

Bug Fixes

• [#2942] Containers without max capacity will no longer show capacity in favorites
• [#3044] Fixed interaction between custom elements and PopOut! module
• [#3055] Actor transformation should now properly apply & revert dynamic token ring settings
• [#3067] Add button in vehicle equipment section no longer throws error
• [#3073] "Create New Item" button will no longer be squashed by long folder names
• [#3083] Token ring flashes will now revert to proper color
• [#3088] 3 digit resources in favorites bar will no longer be cut off
• [#3091] Features no longer display duplicate type in header if no sub-type is selected
• [#3106] Prices of unidentified items should no longer be listed in inventory
• [#3136] Fixed positioning of controls on effects tab of character sheet in edit mode

---

Contributors

• Jeff 'Arbron' Hitchcock

release-3.0.3

Resolved an annoying bug with active effect de-duplication and a few other small bugs.

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

---

Compendium Content

• [#3057] Duplicate "Shelter of the Faithful" entry removed

Bug Fixes

• [#2934] Active effects should now be de-duplicated in most cases
• [#3047] Limited sheet no longer has extra template code beneath biography
• [#3062] Sheets should now load when a feat specifies a subtype for a type that doesn't have subtypes
• [#3072] Token ring scale correction control should no longer be stuck at 1

---

Contributors

• Jeff 'Arbron' Hitchcock

release-3.0.2

A wide variety of small user experience & API improvements for new 3.0 features and bug fixes.

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

---

Improvements

• [#2765] Dynamic token ring scale correction can now be configured in token config
• [#2845] HP bar on player sheet will now display temp max HP adjustment
• [#2853] Items can now be favorited from the context menu
• [#2858] Condition immunities will now prevent those conditions from modifying the actor
• [#2861] Added the dnd5e.calculateDamage hook
• [#2959] Exhaustion levels can now be overridden
• [#2863] Player sheet now has a high contrast mode respecting player's OS settings
• [#2867] Race, background, class, and subclass items on player sheets now have context menus
• [#2869] Added limited ownership version of new character sheets
• [#2885] Effects from unidentified items will now be hidden from non-GMs
• [#2888] Magical & concentration properties now have icons in the inventory/features tabs
• [#2895] Dropping spells into containers now turns them into spell scrolls
• [#2949] Naming of other status effects is now more consistent with conditions
• [#2958] Item5e#rollDamage now accepts extra roll configurations
• [#2992] Always prepared spells now use a distinct icon in the spells list

Compendium Content

• [#2844] "Wizard" page in SRD rules is no longer broken
• [#2887] "Arcane Recovery" feature has improved chat message flavor
• [#2890] "Krusk" no longer uses a legacy resource for Lay On Hands
• [#2891] Magic items in Items compendium should now how the magical property set
• [#2943] "Shelter of the Faithful" background feature now resides in a folder

Bug Fixes

• [#2744] New abilities with short names should no longer display badly on NPC sheets
• [#2798] Custom encumbrance thresholds will now be reflected in encumbrance UI
• [#2838] Chat card descriptions should no longer collapse when links within them are clicked
• [#2842] Checkbox focus shadow no longer has extra space on Chrome
• [#2843] Active effects targeting AC bonus field no longer require leading +
• [#2855] Pact slots can now be overridden even for non-pact casters
• [#2859] Fixed missing localization of exhaustion level
• [#2865] Group actors should now only show multiplied aggregate HP if set to Encounter type
• [#2868] Re-opening the character sheet should now return to previously viewed tab
• [#2871] Actors with overridden max HP can no longer be over-healed
• [#2876] Context menus should no longer open off the bottom of the screen
• [#2877] Long details entries in the inventory should now be properly centered
• [#2879] Active effects with the same ID should no longer be hidden
• [#2883] Passive enricher should now properly support alternative abilities & skill-less checks
• [#2894] Critical successes and critical failures will now be marked successes & failures
• [#2903] Skills tooltip should no longer overlap proficiency pip & ability
• [#2911] Item details on private GM rolls should no longer be displayed to players
• [#2924] XP award for group actors with null XP will no longer be unlimited
• [#2925] Awarding will no longer create a chat message if nothing is awarded
• [#2927] Dynamic rings should now flash properly for linked tokens
• [#2931] Item & actor sheets should no longer fail to render if system.type.value on an item is invalid
• [#2939] Popping out the settings sidebar should no longer create duplicate branding blocks
• [#2940] System update badge should now be properly displayed in settings sidebar
• [#2946] Trait.getBaseItem should no longer prevent item sheets from rendering if compendium is missing
• [#2947] Delete dialog should no longer throw an error for custom actor types
• [#2952] Border of containers in inventory tab should no longer overflow
• [#2957] Passengers can now be deleted from vehicles
• [#2963] New detection modes should now be settable through prototype token interface
• [#2972] AC attribution will now show effect name for effects with no source, rather than "None"
• [#2975] Token rings will no longer get stuck on a color if flashed too quickly
• [#2976] Applying temp HP from a chat message will now use the total of all rolls, instead of just the first
• [#2979] Scrolling numbers at token flash will no longer occur if no damage or healing occurs
• [#2993] Expanding unidentified items on the group & container sheets will no longer show full description
• [#2995] Reverting transformed token will no longer throw errors
• [#3010] Active effects changes to traits should no longer be persisted through trait selector

---

Contributors

• Cole Schultz
• dev7355608
• etiquettestartshere
• Hoppyhob
• Jeff 'Arbron' Hitchcock
• Larkinabout
• Zhell

release-3.0.1

A small patch release to fix disruptive issues, for the full 3.0 release notes, see here.

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

---

Compendium Content

• [#2779] Removed encumbered & heavily encumbered conditions from starter heroes
• [#2817] Rock Gnome languages advancement is now set to "Any Level", not level 1

Bug Fixes

• [#2663] Fixed error when adding new language category to standard languages
• [#2764] Fixed clicking empty class block on new sheet opening Class & Subclass Features compendium
• [#2766] Fixed sheet not opening if any class images are null
• [#2767] Fixed error being thrown when template placement from chat message is canceled
• [#2768] Fixed XP still being displayed on sheet despite "Disable Experience Tracking" setting
• [#2769] Fixed being unable to configure temp max HP on new sheet
• [#2774] Fixed current HP no longer being properly capped by max HP
• [#2782] Fixed players not being able to drag & drop items in their own containers
• [#2787] Fixed nonfunctional Configure Creature Type button appearing when no race is set
• [#2796] Fixed alignment of encumbrance pips on encumbrance bar
• [#2800] Fixed currencies poorly wrapping when container sheet is at its narrowest
• [#2804] Fixed container capacity indicator in inventory not showing bar when at maximum
• [#2810] Fixed invisible visual effect not applying to actors that don't use new token ring system
• [#2819] Fixed 404s caused by -subject being added for inferred token ring subjects
• [#2827] Fixed obsolete localization strings being used for damage bypasses
• [#2829] Fixed damage rolls not getting data on applicable physical damage properties
• [#2831] Fixed containers not functioning properly on group actors
• [#2832] Fixed leftover references to deprecated configuration properties
• [#2835] Fixed chat cards not rendering if sender block doesn't exist

---

Contributors

• Jeff 'Arbron' Hitchcock
• Larkinabout
• SecretFire

release-3.0.0

It's been a long time coming, but the dnd5e system for Foundry Virtual Tabletop is now official. We've marked this occasion with a special 3.0 release of the system that includes a completely redesigned character sheet, dynamic token ring shaders, container support, and many more features and underlying architectural improvements that will be covered below.

These changes come alongside the 2.5 features, for which full patch notes are included at the bottom.

⚠️ COMPATIBILITY WARNING: ⚠️ The version 3.0.0 release of the system ONLY SUPPORTS Foundry Virtual Tabletop version 11 (release) and greater. To use this new game system version you must also use Foundry VTT version 11. 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-3.0.0/system.json

---

Table of Contents

• New Features
  • Character Sheet
    • Edit & Play Mode
    • Searching, Filtering, Grouping, & Sorting
    • Rich Tooltips
    • Conditions
    • Favourites
  • Containers
    • Currency
  • Awards
  • Group Actors
  • Unidentified Items
  • Variant Encumbrance
  • Text Enrichers
    • Award
    • Embed
    • Reference
    • Passive Perception
  • Chat Cards
    • Effects Tray
    • Attack Roll Validation
    • Damage Types
  • Dynamic Token Rings
• What's Next?
  • Sheets
  • Spellcasting
  • Advancement
  • API / Automation
  • 2024 Rules
  • v12 Integration
• Breaking Changes
  • LevelDB
  • ActiveEffect Transferral
  • Backpack-type Rename
  • Unidentified Description Rename
  • Chat Card Changes
  • Config Changes
  • Item Properties Consolidation
  • Item Type Consolidation
• 2.5 Patch Notes
• Contributors

---

New Features

The following contains an overview of the most prominent new features included in 3.0. There are many other changes included that should improve normal play, but don't require any specific guidance on how to find or use them.

Character Sheet

The character sheet has been completely redesigned to include some official branding and a fresh new look. For the most part, you can expect all the features and functionality you're used to (with one notable exception noted further down), but with further enhancements, and more on the way.

Character portrait art by Tim Kong

Known Issues: If your group still uses text-based Race & Background information, it will not appear on the new sheet, which does not have support for these text-based fields. The Race & Background must be created as Items first, and then dragged to the sheet.

Edit & Play Mode

The character sheet now features a toggle in the top-left to switch between two different modes. In 'Play' mode, the sheet is optimised for normal play. You will be able to edit HP, mark off spell slots, equip and attune to items, toggle effects on and off, use items, roll ability checks and saving throws, and any number of things you might be expected to do during the course of the session. Things like adjusting ability scores or skill proficiencies can only be done when switching to 'Edit' mode, however.

Not only does this allow for some of the clutter required to display editing controls to be hidden away during normal use of the sheet, it also resolves a long-standing inconvenience around attributes modified by Active Effects. Edit mode will always show the base value of an attribute, while Play mode will always show its current value, so there is no longer a need to disable the fields on the sheet in order to prevent confusion.

Searching, Filtering, Grouping, & Sorting

Each of the inventory, features, and spells tabs have been imbued with the functionality to quickly filter the Items shown in the tab by their name or by various other properties. The lists can also be sorted alphabetically, or ordered manually. The inventory tab allows for toggling between grouped and ungrouped display, and the features tab allows for toggling between active/passive grouping, and grouping based on the source of the feature.

Rich Tooltips

Various parts of the UI have been augmented with rich tooltips. This is most noticeable in the character sheet, but it extends to other areas of the system too, such as Item content links, and the rule page enrichers covered later.

Known Issues: If a tooltip is spawned far from the cursor and then locked, it will immediately disappear as soon as the mouse is moved. This is a limitation of the core tooltip API that will be resolved in version 12 of the software. In the meantime, the cursor should first be moved close to the tooltip if intending to lock it.

Conditions

The effects tab now includes a toggle for each of the core system conditions, allowing them to be toggled on and off from the sheet for convenience, or in cases where tokens are not available or in use.

The token status effects have also been updated to have a 1:1 correspondence to the D&D 5e conditions, with the addition of several other useful status effects that aren't true conditions. Special thanks to @krbz999 for his initial work on that.

Favourites

Space at the bottom left of the character sheet has been reserved for the character's favourites. These might be weapons, spells, features, or skills the character frequently uses, or resources or items that the character needs to keep careful track of. Favourites can be added by dragging-and-dropping something from the sheet onto the favourites section. Currently it supports dropping Items, Active Effects, Skills, Tools, and Spell Slots (drag the spell level header from the spells tab), and can be extended to add support for more types of favourites.

Resources

The concept of 3 'character'-level resources has been sunset in the system in favour of all resources coming via Items. What this means is that already-configured resources will continue to be visible on the new character sheets for now, under the favourites tab, and will still exist in the character data model, but new characters will not see them and will not be able to use them.

In order to bridge a gap left by the sunsetting of this feature, tokens may now have Item 'uses' configured for display on their token bars.

Containers

This long-awaited feature has finally arrived. The dnd5e 3.0 update includes fully-functional containers. Drag-and-drop Items between container sheets, between containers and Actor sheets, or to and from the sidebar or compendium packs. Containers can contain other containers up to five layers deep, and can be moved around wholesale, taking the entirety of their nested contents with them.

Usage Note: Containers behave very similarly to Folders. Moving an Item from the sidebar into a container also pres...

release-2.4.1

A small patch release containing fixes for some disruptive issues. For the full 2.4 release notes, see here.

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

---

Compendium Content

• [#2634] Removed Active Effects from features that are now covered by Advancements.
• [#2348] Updated SRD Monster and Starter Hero weapons, armour, and tools to have appropriate base items set.
• [#2399] Updated SRD Monsters with multiple breath weapons to all consume the same Breath Weapon resource.
• [#2246] Fixed formatting for Potion of Healing and Potion of Greater Healing in the SRD Items compendium
• [#2251] Added scale value for the SRD Paladin's Aura to increase to 30ft at 18th level.
• [#2595] Fixed the High Elf SRD Race not having the Elf sub-type.

Bug Fixes

• [#2627] Fixed migrated custom source label being overwritten as blank under some circumstances.
• [#2659] Fixed Active Effects on senses or movement not applying if the senses or movement had not already been set to some value.
• [#2653] Fixed players being unable to copy Advancements to Items that they owned.
• [#2658] Fixed setting senses units to Automatic displaying as null.
• [#2656] Fixed expertise trait advancements not showing all valid tool upgrade targets.
• [#2642] Fixed Original Source field displaying broken links.
• [#2649] Fixed skill enrichers that used the full name of the skill throwing an error when rolled.
• [#2643] Fixed modifications to the DND5E.languages config sometimes causing an error to be thrown during pre-localisation.
• [#2644] Fixed nonsensical labels generated on Items under some configurations.
• [#2647] Fixed a warning appearing when trying to cast a spell with Pact Magic if the level of the pact slots were not exactly equal to the base level of the spell being cast.
• [#2609] Fixed singleton check for Races or Backgrounds not applying correctly if the Item contained Advancements.
• [#2607] Fixed Item description accordions not expanding if they were edited while collapsed.
• [#2401] Fixed maximum HP being unaffected by Active Effects.
• [#2616] Fixed setting ammo consumption to 0 still consuming ammo.
• [#2531] Fixed reliable talent not working with tools.
• [#2651] Fixed setting 'allow replacements' for language trait Advancements not functioning correctly.
• [#2596] Fixed 'forced expertise' mode on trait Advancements not functioning correctly for tools.
• [#2622] Fixed creating a Scale Advancement entry at level 0 making the Advancement uneditable later.
• [#2624] Fixed certain languages not being appropriately sorted.

Contributors

• adgranger
• Ikaguia
• Jeff 'Arbron' Hitchcock
• Zanderaf
• Zhell

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 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

• [#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 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.
  -...

release-2.3.1

A small patch release containing fixes for some disruptive issues. For the full 2.3 release notes, see here.

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

---

Improvements

• [#2408] Improved the display of disabled ASI ability scores.
• [#2439] Added 'Tavern Brawler' special trait option to allow characters to be considered proficient with improvised weapons and attacks made with consumable Items.

Bug Fixes

• [#2413] Fixed being unable to modify ASI choices if the ASI contained fixed increases.
• [#2407] Fixed an error being thrown in some cases when copying Advancements between Items.
• [#2405] Fixed the class Item sheet always scrolling back to the top when edits were made on tabs other than the Details tab.
• [#2436] Fixed an error being thrown when a Macro authored by a banned player was dropped onto the hotbar.
• [#2420] Fixed attacks made by feat type items not including the proficiency bonus.
• [#2404] Fixed optional Honor and Sanity ability scores being able to be increased via ASIs.
• [#2419] Fixed a typo in the Remarkable Athlete special trait label.
• [#2404] Fixed incorrect packFolders metadata.

Contributors

• MaxPat931
• Zhell