How to Use the Convert Lighting Tool

Need to update an existing game with Dynamic Lighting? Fret not! We've created a tool that converts your game's existing token and page settings to the Updated Dynamic Lighting system with the click of a few buttons.

Please exercise caution if you've already converted pages to Dynamic Lighting, as this tool will overwrite those pages! And remember, if you have used the Convert Lighting Tool and want to switch back to Legacy Dynamic Lighting, you can do that through your page settings! 

Why do I need it?

Dynamic Lighting is in active development and will eventually succeed the existing system, Legacy Dynamic Lighting, when it reaches feature parity. To make that process easier, we are providing users with a simple and effective tool for converting their games and a large window of time to make the switch before Legacy Dynamic Lighting is retired.

Legacy Dynamic Lighting and Updated Dynamic Lighting are built differently, and as such, they have different options, settings, and interfaces. This tool simply converts all of your options and settings from Legacy Dynamic Lighting to the corresponding choices in our Updated Dynamic Lighting system.

Please be aware, this tool will not transfer or convert explored areas or revealed portions of the map caused by Advanced Fog of War. You will have to re-explore these areas using the Updated Dynamic Lighting equivalent tool, Explorer Mode, or reveal these areas with the Hide/Reveal Tool.

How do I use it?

Navigate to the game details page for a game using the original Dynamic Lighting system and click on the Settings dropdown. From there, click on the button titled Convert Lighting to be directed to the conversion tool.


Once here, your game should feature a selection of items (tokens and pages) which can be converted to Updated Dynamic Lighting. Simply select the checkbox next to an item to mark it for conversion. If you want to select or deselect all of the items in the list, click the Select / Deselect All button at the top of the popup.


Want to convert all of the tokens within your Journal as well? Go ahead and select the Convert Journal Tokens button in the top right. Finally, when you're ready to proceed, click the Convert button at the bottom of the popup. A confirmation message will appear to let you know everything went smoothly.


You're now ready to go out and adventure with our Updated Dynamic Lighting system!

What is converted?

When you convert your game using the Convert Lighting Tool we check various settings within the pages and tokens to ensure we mirror the look from previously as best as possible. You can expand the sections below to see how we determine what settings are changed.

Token Settings

If "All Players See Light" is "Checked"

  • The token will emit Bright Light
  • If dim light is in use
    • Low light will be enabled
    • Low Light will be calculated to copy pre-converted settings
  • If Angle is in use
    • Directional Light will be enabled
    • The Directional Light value will be the same as Angle

If "All Players See Light" is "Not Checked"

  • Night Vision will be enabled
  • Night Vision radius will be the same as previous Light Radius

If "Has Sight" is "Checked"

  • Vision will be enabled
  • If Angle is in use
    • Limit Field of Vision will be enabled
    • The Limit Field of Vision Value will be the same as Angle
  • If Multiplier is in use (any value other than "1x"
    • Light Multiplier will be set to the equivalent percentile value

If "Advanced Fog of War Reveal Distance" has a value set

  • If All Players See Light is in use
    • Bright Light will be enabled
    • Bright Light value will be the same as Reveal Distance
  • If All Players See Light is NOT in use
    • Night Vision will be enabled
    • Night Vision value will be the same as Reveal Distance
Page Settings

Advanced Fog of War settings currently not converted

  • Show Grid
  • Dim Light Reveals
  • All Tokens Reveal

Dynamic Lighting Settings that are converted

  • Enforce Line of Sight
  • Only Update on Drop
  • Global Illumination

I’ve patched my game with the UDL patch, and now I want to revert to LDL.

If this is something you’d like to do, you absolutely can. Our patching did not remove or modify the LDL settings; we simply added the UDL settings and switched UDL to on.

You can switch Legacy Lighting back on via the page settings menu.  Following the steps below to turn it on:

  • In the Dynamic Lighting tab, set Dynamic Lighting to “off.” 

  • Then, in the Legacy Lighting Tab, check Dynamic Lighting to "Enabled" and toggle on the "Enforce Line of Sight" setting. 

You can see these steps above right here:


Was this article helpful?
197 out of 259 found this helpful