Vision, Light and Hud Enhancements

This release has been a long time coming, and it delivers a large number of refactors and enhancements across the board.

1. The main feature area that's been getting attention has been around Token Vision and Light, including incorporating the sight and light effects that were introduced in Foundry 0.7.x.. More details below.
2. The Token Hud Extension has been treated for improve usability.
3. User settings have been extended, giving greater control over token light and vision settings, as well as Token Hud Extension and Advantage behaviour.
4. Further changes have been made across the board in macros. Significantly, there is now no external dependency on the Furnace module.

See the Changelog for further details.

Thanks again to @LeRatierBretonnien for providing French translations that have made it into this round. More translation keys have been added for new features, and I'll patch further language updates as they .

Compatibility

Version 0.6 of the GM Toolkit requires

• Foundry VTT v.0.7.5 or above.
• WFRP4e v.2.2.1 or above is required.

The Furnace module is no longer required. There are no external dependencies.

Token Light and Vision

Changes have been made to both sight and light behaviours.

• Sight
  • Handles Night Vision as a Talent or Trait (so creatures can benefit also).
  • New options to apply Night and Dark Vision even if the token doesn't have the Talent or Trait.
  • Night Vision now requires some scene or token illumination to be used.
  • You can now configure the ranges for normal and dark vision.
• Light
  • Soulfire (Major Miscast) and Matches have been added to the Light Sources.
  • Each light source is now more finely defined with custom bright ranges, colours, and effects (taking advantage of Foundry v.0.7.x enhancements). These default values are documented in the wiki. This image shows some stills of the new lighting effects - fire it up to see them in dynamic action.

Other Macro Updates

Most of the macros have been refactored to some degree to make them cleaner or more reusable. As with any such update, these should be [re-imported from the compendium])https://github.com/Jagusti/fvtt-wfrp4e-gmtoolkit/wiki/getting-started#upgrading) to ensure you have the latest version in your game world and hotbars.

• A new End of Session Routine macro has been added which runs the Add XP and Reset Fortune macros, as well as pausing the game.
• New icons have been added for all the macros. They are based on images by Lorc, Delapouite and Skoll from https://game-icons.net. They don't have any functional impact, but I like them :) ... they are a little bit more in keeping with the style of the WFRP system than the plain icons.

Token Hud Extensions

• This can now be disabled, which may be of interest to those who use other Hud modules. This is a user (client) setting, rather than set by the GM or server admin.
• The Hud now automatically refreshes when status values (such as Advantage and Fortune) are changed using GM Toolkit macros and features, including when Advantage is changed (including being reset at the start and end of combat).

Module Settings

User options were introduced in the last version of the GM Toolkit. This new release sees several new options to tailor how the Toolkit macros and features work in your games. Key additions to this version are:

• Enable Token Hud Extensions. De-select to hide the extended view, along with tooltips and shortcut interactions.
• Always show Initiative. Previously this was only shown in active scenes with a combat,
• Normal and Dark Vision Ranges. The range of Normal and Dark Vision are not specified in the WFRP4e rules. GM Toolkit applies 2 yards and 120 yards by default, but these can be overridden in this setting to suit your play style. Note that the Normal Vision range is for non-daylight situations, which may be better simulated using Global Illumination.
• Always allow Dark / Night Vision. If these are enabled, you can mimic Night or Dark Vision for any actors using the Set Token Light and Vision macro,
  

Version 0.6 Changelog

General Module Stuff

• Changed minimum core Foundry compatibility to 0.7.5 and minimum WFRP4e system compatibility to 2.2.1 to support animated token light effects.
• Added French translations for enhancements and changes to Version 0.5.1 (thanks to @LeRatierBretonnien).
• Added explicit dependency on WFRP4e system, as supported by Foundry 0.6.6.

Macros

• Removed dependency on external Furnace module. Macros should be re-imported from the macro compendium to take advantage. Thanks to Forien for support with this.
• Added new custom icons for the Toolkit macros.
• Added End of Session macro which automatically runs end of session admin macros (Add XP and Reset Fortune), as well as ensuring the game is paused.
• Changed macro compendium to include latest versions of macros. Updated macros will need to be manually re-imported from the compendium.
• Changed macro code to improve notification and string handling.

Token Hud Extension

• Added option to toggle token hud extensions. Hud extensions are enabled by default. This update also makes the token hud extension available to non-GMs, and each user can enable or disable it independently.
• Added dynamic update to token hud when Advantage is increased, reduced or cleared. Any changes are visible immediately in the token hud resource bar if the token hud is active. This applies when using the relevant advantage macros as well as when starting or ending combat, depending on the Clear Advantage setting.
• Added dynamic update to Token Hud Extension when using shortcuts to increment or decrement Resolve, Resilience, Fortune, Fate, Sin or Corruption. Any changes are visible immediately in the token hud resource bar if the token hud is active.
• Changed Token Hud setting description to clarify that the hud extension is only shown on controlled tokens. GMs can generally see any token hud, but players will only see their own characters token hud.
• Added option to always show Initiative in Token Hud Extension. Previously Initiative and Agility tooltips and shortcuts were only available in active scenes. This option is now enabled for all scenes by default.
• Added a message to confirm when no changes are made when using the status change shortcuts to alter Fate, Fortune, Resolve or Resilience via the Token Hud Extension. This can occur when the status attribute is already at 0 or its maximum value.
• Fixed a console error that was thrown when chat messages were logged when status changes were made via the Token Hud Extension.

Token Vision and Light

• Added module settings for the GM to:
  • define token vision distances for normal and Dark Vision in dim or night conditions.
  • allow Night or Dark Vision even if token does not have the relevant talent or trait.
• Fixed Night Vision to work with characters with the Trait, and not just characters with the Talent.
• Changed No Vision setting to also clear light emission from token.
• Added Soulfire (Magic Miscast) and Matches to light source options.
• Fixed Storm Lantern lighting options.
  • Broadbeam is treated as unshuttered and providing 360° illumination.
  • Shuttered eliminates light emission.
• Added colour and light animation effects to differentiate light sources. Preconfigured settings are documented on the wiki.
• Changed the bright radius of various light sources. Previously these were treated as half the dim radius. New values are documented on the wiki.
• Changed the application of Night Vision to require a minimum level of light in the scene. This is fulfilled by any of the following criteria:
  • global darkness level of less than 1 (indicating some ambient light)
  • the token itself having some kind of light source (conferring a dimLight setting > 0)
  • global illumination being enabled on the scene.

Version 0.5.1 Changelog

• Fixed typo in Add XP macro