Feature: Dynamic Lighting

From 5etools Community Wiki
Jump to: navigation, search


Dynamic Lighting

🚧 This Page is still being developed.

This allows for you to have use of the Dynamic Lighting feature while having a free subscription service. Dynamic Lighting is a combination of limiting what the player's character's can see, and limiting and limiting movement upon the map.


If the DM/GM of the game does not have a subscription, then in order for the player's to see the DM's dynamic lighting configurations, all the players in the session must run the script.

GM: (if running the Script)

  • Must have Dynamic Lighting πŸ—Ή Enabled on the Map's Page Settings.


  • Must have the script running
  • Must have a character token on the map they have control of with πŸ—Ή Has Sight is marked, and either Emits Light marked, or another token within line of sight that Emits Light and has πŸ—Ή All Players See Light marked.

Walkthrough (How to use it)

The feature is enabled by default when the script is running. It is not needed if the user that created the game is Pro or Plus level subscription as those games will automatically have Dynamic Lighting already and so the players will not need to run the script to experience dynamic lighting.

There are a number of guides on how to configure and use Dynamic Lighting.

As a gross overview of the relevant settings:..

Tokens :

(in Settings β†¦ Advanced)

Page Settings (Map)

(Page Toolbar β†¦ Page Settings)
Fog of War
 Enabled - Effectively a blackout screen which the GM reveals piece by piece through drawing tools.
Advanced Fog of War
  • Enabled - toggles the Advanced Fog of War on or off
  • Show Grid -
  • Dim Light Reveals -
Dynamic Lightning
  • Enabled - toggles the Dynamic Light Feature on or off.
  • Enforce Line of Sight - The line work as sight boundaries that prevent Token's relative 'sight' from penetrating.
  • Only Update on Drop -  The Token's vision doesn't reveal any new map content until the token ends its movement. Turning this feature reduces the processing power needed to render the map.
  • Restrict Movement - The token cannot be moved by its player past or into a boundary defined on the dynamic light layer.
        • Global Illumination - The Entire Map & Token Layers of the Page are exposed, regardless of light sources or boundaries. This really only has value when paired with Restrict Moment.


    Support/Suggested Use Guidance.

      • The Dynamic Lighting feature is complicated, here are some community curated solutions to common problems, and best practices.

    My player(s) see only Black.

      • If your account isn't a Pro or Plus level subscription holder, make sure the player is running the current, highest version of the script and its active.

          • Line Splitter (as a means to better moderate the dynamic lighting layer)
          • SVG Drawing Tool (as an easy way to add dynamic lighting layer boundaries)

  • 'Why is the Game slow now?'
        • Try toggling to on "πŸ—Ή Update only on Drop" under Page Setting's β†¦ Dynamic Lighting.

    My player(s) can not see anything on the map!

        • Make sure they have a token they are a controller of on the page/map, and/or that their under the token's advanced settings the "πŸ—Ή Has Sight" is enabled.

    My player(s) sees the ENTIRE map!

        • )Make sure the Page Settings for the map either has "πŸ—Ή Dynamic Lighting" marked, or that "πŸ—Ή Global Illumination" isn't marked.