Home
Games
Marketplace
Compendium Character Vault Roll20 for iPad and Android
Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Updated Dynamic Lighting"

From Roll20 Wiki

Jump to: navigation, search
(Add "Known Issues"-section)
m (place lights -> place tool)
 
(53 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
{{Pro only}}
+
{{revdate}}{{Plus only|page}}
  
−
'''Updated Dynamic Lighting''' (aka. '''UDL''') is the new version of the Roll20 lightning system that is meant to replace [[Advanced Fog of War]] and [[Dynamic Lighting]], combining them into a single, unified system. It features a stronger framework for future feature enhancements, is more performative, and has been updated for more current computing technologies. The old system is referred to as '''[[Legacy Dynamic Lighting|Legacy Dynamic Lighting (LDL)]]'''.
+
''(Updated )'' '''Dynamic Lighting''' (aka. '''UDL''') is the new version of the Roll20 lightning system, which is replacing the older [[Legacy Dynamic Lighting|Legacy Dynamic Lighting(LDL)]]. It features a stronger framework for future feature enhancements, is more performant, and has been updated for more current computing technologies.
 +
{{#evp:youtube|apAEqz5RiSw| How to set up Dynamic Lighting|right|600}}
 +
__TOC__
 +
{{pro features}}{{plus features}}
 +
==General==
  
−
In UDL, the old features of '''Advanced Fog of War''' have been renamed '''Explorer Mode''' to avoid confusion. Updated Dynamic Lighting uses WebGL, which is available in most computer systems and is supported by all the web browsers that Roll20 supports (Chrome and Firefox). The [[Legacy Dynamic Lighting]] has always used WebGL, so the change here is that Explorer Mode (previously Advanced Fog of War) now runs on the same system.
+
==Official Documentation==
  
−
UDL was released on April 8th, 2020 as opt-in feature for Pro/Plus users, after having been available over a month on the Dev Server for Pro subs to try out.
+
UDL was created after Roll20 had moved their Official documentation to the [[Help Center]], so the Community Wiki doesn't have duplicates of these articles, so these features have better pages there:
  
−
==Official Documentation==
+
* {{hc|articles/4403801475479-What-Is-Dynamic-Lighting  What Is Dynamic Lighting?}}
−
UDL was created after Roll20 had moved their Official documentation to the Helpdesk, so the Community Wiki doesn't have duplicates of these articles, so these features have better pages there:
+
* {{hc|articles/4403861702679-How-To-Set-Up-Dynamic-Lighting How To Set Up Dynamic Lighting}}
 +
* {{hc|articles/360044771413-Updated-Dynamic-Lighting-Light-Vision-Examples Updated Dynamic Lighting - Vision Examples}}
 +
* {{hc|articles/360046490373-Updated-Dynamic-Lighting-API-Support Updated Dynamic Lighting API Support}}
  
−
* [https://roll20.zendesk.com/hc/en-us/articles/360045793374-Updated-Dynamic-Lighting Updated Dynamic Lighting] - Helpdesk article
+
==Features==
−
* [https://roll20.zendesk.com/hc/en-us/articles/360044771413-Updated-Dynamic-Lighting-Light-Vision-Examples Updated Dynamic Lighting - Vision Examples] - Helpdesk article
+
Breakdown of the main features.
−
* [https://roll20.zendesk.com/hc/en-us/articles/360046490373-Updated-Dynamic-Lighting-API-Support https://roll20.zendesk.com/hc/en-us/articles/360046490373-Updated-Dynamic-Lighting-API-Support] - helpdesk article
+
===[[Explorer Mode]]===
 +
{{#evp:youtube|8qVpF0olnVs|Explorer Mode & {{Darkness}} |right|500}}
 +
'''[[Explorer Mode]]''' - reveal map as characters move around the map, and leave previously explored section greyed out.
  
−
==Parallel Systems==
+
With the {{Darkness}} you can create patches of explorable or permanent darkness, and it is also used for resetting Explorer Mode.
−
Currently UDL exist in parallel with the [[Legacy Dynamic Lighting|Legacy Dynamic Lighting(LDL)]] until it reached feature parity and all bugs are fixed. Users will be warned well in advance when LDL will be phased out so people have time to adjust.
+
  
−
While we continue development on Updated Dynamic Lighting and support for licensed products, both the Legacy system and the Updated will exist in parallel. However, when you switch from one to another, the revealed areas are not transferred over. So, for example, if you and your crew have been crawling through a dungeon with Advanced Fog of War on, and you decide to switch to the new Dynamic Lighting with Explorer Mode, your players won't see anything they had previously explored. Players can fix that by moving their tokens around to re-reveal the area.
+
In [[LDL]], the equivalent to Explorer Mode is [[AFoW]].
  
−
Similarly, if you switch to '''Explorer Mode''' and then decide to hop back over to the Legacy system, anything you had revealed in the UDL system will be reset/hidden when changing to LDL. If you then switch back to the UDL, the revealed areas that you had revealed when you last used UDL(might?) still be there.
+
You can also use Eclipses and freehand drawings for DL lines.
  
−
The [[Layers|Dynamic Lighting layer]], where you can add barriers that block light and movement, continues to function for both systems, and you do not need to change anything on that layer.
+
If you turn on Daylight, you can adjust the brightness of the default light on the map.
 +
{{#evp:youtube|mtEi8OmmBKE|Adjust Daylight Brightness|left|500}}
 +
<br clear="left">
 +
{{#evp:youtube|dXSIKFT7t2Y|Nocturnal Vision|right|500}}
 +
====Dark Vision====
 +
In April 2021, {{hc|articles/360044771413-Updated-Dynamic-Lighting-Light-Vision-Examples#Alternate-Senses Dark Vision}} & Alternate Senses where released, making it possible to use D&D5E-accurate dark vision, if you turn on "Nocturnal Vision". Total darkness will by default be shown in grayscale, but you can change the tint to have a color. E.g. Night Vision technology could give you a green tint, while magic-based darkvision might make sense to have a purple tint.
 +
<br clear=all>
  
−
==Features==
+
===[[Darkness Tool]]===
 +
The {{Darkness}} can be used for manage what players can or can't see, reset explored map back to darkness, or draw Permanent Darkness that even blocks normal vision.
  
−
===Page===
+
It also incorporates features similar to the free [[Fog of War]]-tool, and replaces it's position on the [[Toolbar]] when UDL is active on a page. ({{fow}} isn't compatible with UDL).
 +
 
 +
===Colored Lighting===
 +
Lights can have colors.
 +
{{#evp:youtube|0-vI21YLr7k|Colored Lighting|center|500}}
 +
 
 +
===Place Tool===
 +
''main page:'' '''[[Place Tool]]'''
 +
 
 +
You can quickly place lights, windows and doors on your map, with the '''Place Tool''' which can be found on the [[toolbar]].
 +
{{#evp:youtube|b0fTN84KyEI| Roll20:[[Place Light Tool]] showcase|center|500}}
 +
 
 +
===One-Way Barrier===
 +
[[File:One-way-barrier-beta-2022-03-18.png|right|400px]]
 +
{{main|One-Way Barrier}}
 +
 
 +
"A great example of this would be setting it up so players can see there are pillars, but they can't see through the pillars."
 +
 
 +
{{clear}}
 +
===Settings===
 +
====Page====
 
{{main|Page Toolbar}}
 
{{main|Page Toolbar}}
 +
 +
Page DL settings for [[LDL]] and [[UDL]] are saved on separate tabs.
 +
 +
{{hc|articles/360052521913-Page-Settings UDL Page Settings}}
  
 
[[File:UDL-PageSettings.png|280px]]
 
[[File:UDL-PageSettings.png|280px]]
  
  
−
===Token===
+
====Token====
 
{{main|Token Features}}
 
{{main|Token Features}}
  
 +
Token settings for [[LDL]] and [[UDL]] are saved on separate tabs.
 +
 +
{{hc|articles/360051754954-Token-Settings UDL Token Settings}}
 
[[File:UDL-TokenSettings.jpg|280px]]
 
[[File:UDL-TokenSettings.jpg|280px]]
  
 +
===Other Features===
 +
* [[Convert Lighting]] is a one-way tool to automatically convert a campaign's [[Legacy Dynamic Lighting]] setting(tokens, pages) to use UDL.
 +
** You access it from your [[Game Management#Settings]].
 +
 +
 +
===API===
 +
{{pro only|section}}
 +
There is usually some delay between new UDL features getting introduced, and [[API|API scripting]] getting access to new object keys & functions to interact with them.
 +
 +
[[TokenMod]](by [[The Aaron]] is a popular API that's been quickly updated when new UDL features have become API-accessible,
 +
 +
'''List of APIs using UDL-only features'''
 +
 +
* '''[[Door Knocker]]''' -- Script helps quickly open and close doors by controlling the dynamic lighting lines, as well as creating "[[windows]]"
 +
* {{fpl|9532981 UDLWindows}} -- API for creating "[[windows]]", i.e. DL lines that blocks movement, but doesn't block vision.
 +
* {{fpl|9939691 UDLPasswall}} - Walls that block sight but not movement
 +
* {{gist|shdwjk/29cd674266fce53387899f3e797b2100 UDL version of LightCrumb}}, by [[Aaron]] (not tested)
 +
 +
 +
Related APIs, which utilize UDL to various degree:
 +
* [[API:Script_Index#Dynamic_Lighting]]
 +
* [[API:Script_Index#Tokens]]
  
 
==Known Issues==
 
==Known Issues==
−
This is a cleaned-up and reorganized version of the [https://app.roll20.net/forum/post/8422745/a-new-light-bug-thread-updated-dynamic-lighting-and-fog-of-war/?pageforid=8422746#post-8422746 Known Issues List] from the Bug report thread.
+
{{col|550px|
 +
* {{fpl|10223955/ Dynamic Lighting - Updates, Bugs, & Feedback}} (April 2022)
 +
* [https://portal.productboard.com/glhhkt5gktckwgueetswamfw/tabs/10-bug-queue Dynamic Lighting Portal] unified portal for all updates related to it
 +
** [https://portal.productboard.com/glhhkt5gktckwgueetswamfw/tabs/10-bug-queue bug queue]
 +
** [https://portal.productboard.com/glhhkt5gktckwgueetswamfw/tabs/7-released released updates]
 +
** [https://portal.productboard.com/glhhkt5gktckwgueetswamfw/tabs/9-planned-improvements planned improvements]
  
−
'''UDL Known Issues (30th June 2020)'''
 
  
−
* '''Large Bugs'''
+
'''Fixed issues/past threads:'''
−
** '''Updated Dynamic Lighting fails on very large maps.'''
+
* {{forum|permalink/8422746/ list of solved issues}} - 1st thread, posted April 8th 2020
−
** '''Unexpected behavior is occurring with masks created by circles.'''
+
* {{forum|permalink/9072910/ list of solved issues}} -  2nd thread, posted August 14th 2020
−
** '''If a player's system crashes, they will occasionally have DL masks revealed to them.'''
+
* {{forum|permalink/9741240/ UDL 1.0 Updates, Bugs, & Feedback}} - 3rd thread, posted Jan 2021
−
* '''Feature Parity''' (features not yet implemented in UDL from LDL):
+
<br><br><br>
−
** No feature parity with "[[Fog of War]](FoW)", where a GM can manually hide/reveal areas. Please note: FoW is the free tool you can select on your [[Toolbar|toolbar]], and is not the same feature as [[Advanced Fog of War]](AFoW). That's why we changed the names. FoW will become the "Reveal Tool", and AFoW has become "Explorer Mode" in UDL.
+
}}
−
** Token's light/vision sensitivity can't be adjusted yet (previously labeled as "Has Sight / Multiplier").
+
 
−
* '''Bugs:'''
+
==Comparison to Legacy DL==
−
** When a token with Night Vision is at the edge of a lit area, there is a gradient at the edge of the lit area before the night vision begins.  
+
'''Roll20 have announced that [[LDL]] will be retired eventually''' More info:
−
** In certain systems, images from the <span style="font-family:Pictos;">@</span> Map-layer are being distorted and skewed when viewed using Dynamic Lighting.
+
* '''{{blogs|an-update-to-the-legacy-dynamic-lighting-sunset-plan/ LDL Plans Postoned}}''' (April 27th, 2021)
−
** '''GM Vision:''' With Explorer Mode enabled, when using CTRL-L on a token that is not controlled by anyone in a page (or if there are no players in the game), GMs will only see a grayscale version of the map, without the GM Darkness Overlay.
+
 
−
** '''GM Vision:''' Tokens with light and no vision are not visible to the GM until a token with vision is nearby.
+
In UDL, the old features of '''[[Advanced Fog of War]]''' have been renamed '''Explorer Mode''' to avoid confusion. Updated Dynamic Lighting uses WebGL, which is available in most computer systems and is supported by all the web browsers that Roll20 supports (Chrome and Firefox). The [[Legacy Dynamic Lighting]] has always used WebGL, so the change here is that Explorer Mode (previously Advanced Fog of War) now runs on the same system.
−
** '''Map Contrast:''' It can be difficult to see the difference between an illuminated map that is low contrast and a map that has been revealed in Explorer Mode, especially if the GM opacity is low.
+
 
−
** Mask outlines are not as smooth as expected.
+
On '''January 14th, 2021, Roll20 announced {{blog|640321601818198016/updated-dynamic-lighting-10-is-live Update 1.0}}''', saying that ''"Updated Dynamic Lighting has been in the works for some time, and we see the 1.0 Update not as a finish line, but a checkpoint."''. Despite this, there exists still multiple known issues, such as performance issues, and visual glitches relating to Darkvision.
−
** Zooming out with browser zoom, not the VTT zoom, can cause some strange visual issues.
+
 
−
** Slight lag with keyboard movements using UDL still exists.
+
===Parallel Systems===
−
** '''Mac Users:''' When using Explorer Mode on a Mac with Intel integrated graphics, the Lighting system may display a wide diagonal black bar across the middle of the screen that scrolls as you pan across the page.
+
{{notebox| As of Oct. 2021, UDL have several more features than LDL}}
−
* '''Fixed issues:'''
+
Currently, UDL exist in parallel with the [[Legacy Dynamic Lighting|Legacy Dynamic Lighting(LDL)]], so you can use either one in your game, but LDL will eventually be discontinued.
−
** <s>Setting negative numbers in the token light and vision settings results in tokens revealing more than they should.</s> Fixed Apr 10
+
 
−
** <s>If your maps use units other than feet, the light distances will not change based on the correct unit. Until this is fixed, assume that the "ft" in the Token Settings for vision and light distances is whatever units your map uses.</s> Fixed April 17
+
While they continue development on Updated Dynamic Lighting and support for licensed products, both the Legacy system and the Updated will exist in parallel. However, when you switch from one to another, the revealed areas are not transferred over. So, for example, if you and your crew have been crawling through a dungeon with [[Advanced Fog of War]] on, and you decide to switch to the new Dynamic Lighting with '''Explorer Mode''', your players won't see anything they had previously explored. Players can fix that by moving their tokens around to re-reveal the area.
−
** <s>Default Token Settings in the game details page do not currently apply when creating new tokens.</s> Fixed Apr 21
+
 
−
** <s>Resetting fog more than once is causing issues.</s> Fixed Apr 21
+
Similarly, if you switch to '''Explorer Mode''' and then decide to hop back over to the Legacy system, anything you had revealed in the UDL system will be reset/hidden when changing to LDL. If you then switch back to the UDL, the revealed areas that you had revealed when you last used UDL(might?) still be there.
−
** <s>When the GM moves a token, the areas will only be revealed for players who are currently online.</s> Fixed Apr 21
+
 
−
** <s>Tokens on different pages/accounts sometimes reveal masks for the incorrect page.</s> Fixed April 28
+
The [[Layers|Dynamic Lighting- layer]], where you can add barriers that block light and movement, continues to function for both systems, and you do not need to change anything on that layer.
−
** <s>Decimals in the token light and vision settings result in incorrect light calculations.</s> Fixed April 28
+
 
−
** <s>When using CTRL-L, GMs see through the token's eyes for purposes of lighting and vision, but can still see objects on the GM layer.</s> Fixed April 28
+
The [[Convert Lighting Tool]] making it possible to convert existing games to UDL automatically. '''This process can't be reversed easily''', so if problems occur and you want to change everything back to LDL, you need to manually update all tokens & pages yourself.  It's recommended to create a copy of your campaign, and perform the Conversion on the Copy, and keeping the original game as it is.
−
** <s>Tokens with Light on the GM layer are showing that Light to Tokens on other layers.</s> Fixed May 19
+
 
−
** <s>Using CTRL+L on a token will occasionally result in vision of what's beyond Dynamic Lighting barriers.</s> Fixed May 19
+
==History==
−
** <s>Light bleeds through some corners in Dynamic Lighting barriers (in explorer mode, this can result in areas being revealed).</s> Fixed May 21
+
* ?? – First public info on UDL
−
** <s>A "pixel dust" like effect is occurring within certain markings.</s> Fixed June 30
+
* '''March, 2020''' – UDL was made available to Pro members on the [[Dev Server]].
−
** <s>There is no "update only on drop" option.</s>  Fixed June 30
+
* '''April 8th, 2020''' – UDL was released as opt-in feature for Pro/Plus users, after having been available over a month on the Dev Server for Pro subs to try out.{{source|https://blog.roll20.net/post/614847973200969728/a-new-light}}
−
** <s>Night Vision does not allow for Low Light at the moment and appears the same as Bright Light.</s>  Fixed June 30
+
* '''July 30th, 2020''' – Roll20 announced UDL to have reached Feature Parity with LDL, but still have issues and optimization to do.{{source|https://blog.roll20.net/post/625101101120798720/a-new-light-a-new-path-ahead}}
−
** <s>Dragging a token next to a Dynamic Lighting barrier can result in vision past the barrier.</s> Fixed June 30
+
* '''August - December 2020''' – regular updates & fixes where applied to UDL, and these minor change where communicated mostly in the UDL megathread and possibly twitter
 +
** There where no Blog Post or larger announcements during the time for UDL. On the monthly Community Roundtables(Twitch), questions about UDL progress was answered, and possibly some minor changes where mentioned.
 +
** During [[Roll20Con|Roll20Con 2020]], some updates where highlighted
 +
* '''January 14th, 2021''' – Roll20 announced {{source|https://blog.roll20.net/post/640321601818198016/updated-dynamic-lighting-10-is-live}}
 +
** ''"Updated Dynamic Lighting has been in the works for some time, and we see the 1.0 Update not as a finish line, but a checkpoint."''. Despite this, there exists still multiple known issues, such as performance issues, and visual glitches relating to Darkvision.
 +
** With the Update 1.0, they also emphasized that ''"We will still support Legacy Lighting for a while, but we feel it’s only fair to let you know that'' '''we will be deprecating our support for the Legacy system sometime in the future'''. ''"''
 +
** No timeline for phased out [[LDL]] was announced.
 +
** Roll20 would close the current UDL feedback thread shortly and start a new one for '''Update 1.0'''{{source|https://app.roll20.net/forum/permalink/9705531}}
 +
* '''Jan 27th''', new feedback tread opened for '''Update 1.0''': {{forum|permalink/9741240/ UDL 1.0 Updates, Bugs, & Feedback}} (Jan 27th, 2021)
 +
* '''Feb 17th 2021''', it was announced that [[LDL]] will be {{blog|posts/retiring-legacy-dynamic-lighting-what-you-need-to-know/  discontinued '''May 18th 2021'''}}
 +
** Feb 6-17th, several updates related low light/dim light was rolled out. Adding a dim light opacity slider, setting in "Default Settings", and fixes. {{source|https://app.roll20.net/forum/post/9817929/release-note-for-february-16-2021}} {{source|https://app.roll20.net/forum/post/9800084/release-note-for-february-9-2021}}
 +
** Feb 18th, {{forum|permalink/9818207/ Dev comment on UDL situation}}
 +
* '''April 2021''' LDL removal was postponed, no new date was given {{blogs|an-update-to-the-legacy-dynamic-lighting-sunset-plan/ An Update to the Legacy Dynamic Lighting Sunset Plan}}
 +
* '''June-July 2021'''
 +
** DL  User interface update {{fpl|10133896/ June 2nd}}
 +
** [https://portal.productboard.com/glhhkt5gktckwgueetswamfw/c/65-nocturnal-mode Nocturnal Mode] - Darkvision closer to how 5E and PF2E uses it
 +
** Colored lighting {{blogs|lights-camera-action-economy-colored-lights-are-live/ Color Your Creativity With New Lighting Options!}} - Jul 21
 +
** {{fpl|10136021/ more API access}}
 +
** {{fpl|10223955/ Dynamic Lighting - Updates, Bugs, & Feedback}} - new forum thread
 +
** [https://portal.productboard.com/glhhkt5gktckwgueetswamfw/tabs/9-planned-improvements Dynamic Lighting Portal] - released
 +
** {{forum|post/10275639/release-note-for-july-27-2021 Feathered Edges on shadows}}
 +
* '''Sep 1st''' {{hc|articles/360037772613-Change-Log#september-2-2021-0-3 Daylight brightness can be adjusted}}
 +
* '''Sept 8th''' [[Tutorial]] was updated to also showcase Dynamic Lighting, so also free users can try it out - {{forum|post/10365617/new-tutorial-experience-is-live details}})
 +
* '''Sept 18th''' {{fpl|10384414/ Place Light Tool}} made available to tested on [[Dev Server]]
 +
* '''Oct. 1st 2021''' {{Place Light}} released for everyone
 +
* '''2022''' [[One-Way Barrier]] was released, and preparations for doors & windows where made
 +
* '''Jan 5th 2023''' [[Place Tool]] was released, which can be used for placing Lights, Doors, and Windows.{{source|https://help.roll20.net/hc/en-us/articles/360037772613-Change-Log#january-5-2023-0-15 1}}
 +
=API=
 +
{{pro only}}{{apiboxRec}}
 +
[[API|APIs]] have access to most UDL features, and some APIs such as [[TokenMod]] have updated to support UDL as best as it can.
 +
 
 +
There are some API, such as '''{{forum|post/9521203/script-udlwindows-dynamic-lighting-paths-that-block-movement-but-not-vision-or-light-warning-updated-dynamic-lighting-only#post-9532981 UDLWindows}}''', which only works with Updated, and not Legacy.
 +
{{:Dynamic_Lighting/API}}
 +
 
 +
=Related Pages=
 +
* [[Updated Dynamic Lighting]]
 +
** [[Explorer Mode]]
 +
** {{Darkness}}
 +
** {{Place Light}}
 +
** [[One-Way Barrier]]
 +
** [[Window]] - create barriers that stop movement, but not sight.
 +
* [[Optimizing Roll20 Performance]] - general advice
 +
* [[Legacy_Dynamic_Lighting_Examples#Best_Performance_Guide|Best Performance Guide (Legacy) DL]] - older guide written for LDL but ''might'' still be helpful for UDL
 +
* [[Game Management]]
 +
** [[Page Settings]] Info on page-specific settings
 +
* [[Dummy Account]] - good for double-checking how things look like from a player's perspective
  
 
=See Also=
 
=See Also=
−
* [https://blog.roll20.net/post/614847973200969728/a-new-light A New Light] Roll20 Blog post on the UDL release (April 8th 2020)
+
* {{yt.be|IQARZIvpqQA Place Doors and Windows}} 1min, (Jan 2023)
−
* [https://app.roll20.net/forum/post/8422745/a-new-light-bug-thread-updated-dynamic-lighting-and-fog-of-war/?pagenum=1 UDL Bug Report Thread]
+
* {{yt.be|nshvNjpnizo New Dynamic Lighting Showcase}} 59min, (Feb 6th, 2021)
−
* [https://app.roll20.net/forum/post/8422745/a-new-light-bug-thread-updated-dynamic-lighting-and-fog-of-war/?pageforid=8422746#post-8422746 UDL Known Issues List]
+
* {{fpl|10223955/ Dynamic Lighting - Updates, Bugs, & Feedback}} (July 2021)
−
<br>
+
* [https://portal.productboard.com/glhhkt5gktckwgueetswamfw/tabs/9-planned-improvements Dynamic Lighting Portal]
−
<br>
+
 
 +
== Blog Posts==
 +
* {{blogs|12-new-features-on-roll20-you-might-have-missed/ 12 New Features On Roll20 You Might Have Missed}} - Dec 15, 2022
 +
* {{blogs|improved-initiative-a-roll20-product-update Improved Initiative: A Roll20 Product Update - Feb 23, 2022
 +
* {{blogs|tome-of-tips-dynamic-lighting/ Tome of Tips: Dynamic Lighting}} July 2021
 +
* {{blogs|lights-camera-action-economy-colored-lights-are-live/ Color Your Creativity With New Lighting Options!}} - Jul 21 2021
 +
* {{blogs|an-update-to-the-legacy-dynamic-lighting-sunset-plan/ An Update to the Legacy Dynamic Lighting Sunset Plan}} (April 27th, 2021)
 +
* {{blog|posts/retiring-legacy-dynamic-lighting-what-you-need-to-know/ LDL retiring - What you need to know}}} (Feb 17th 2021)
 +
* {{blog|640321601818198016/updated-dynamic-lighting-10-is-live Updated Dynamic Lighting 1.0 is Live}} (Jan 14th, 2021)
 +
* {{blog|625723091466747904/a-new-light-the-convert-lighting-tool-is-now A New Light The Conversion Tool is Now Live!}} (August 6th,2020)
 +
* {{blog|625101101120798720/a-new-light-a-new-path-ahead A New Light A New Path Ahead}} UDL reached Feature Parity with LDL (July 30th, 2020)
 +
* {{blog|614847973200969728/a-new-light A New Light}} UDL is released (April 8th 2020)
 +
 
 +
==Guides==
 +
* [https://www.youtube.com/watch?v=apAEqz5RiSw&list=PLTj75n3v9eTljjooh-nIr_LFAeHatTeI4 UDL Tutorial by Roll20] youtube playlist, (August 2020)
 +
 
 +
==Old threads==
 +
* {{forum|permalink/9741240/ UDL 1.0 Updates, Bugs, & Feedback}} (Jan 27th, 2021)
 +
* {{forum|post/9072910/updated-dynamic-lighting-feedback-thread UDL - Feedback/Bug Report Thread}} (Jan 14th, 2021)
 +
* {{forum|permalink/9072910/ UDL Known Issues List}} (as of Jan 14th, 2021) Legacy Sunset phase
 +
 
 
[[Category:Docs]]
 
[[Category:Docs]]
 +
[[Category:Dynamic Lighting]]
 +
[[Category:UDL]]
 +
[[Category:Plus]]
 +
[[Category:Pro]]
 +
[[Category:New features in 2020]]

Latest revision as of 15:09, 11 March 2023

Wiki-Logo 75x49.png
Page Updated:
  2023-03-11
Plus.png
This page is about a Roll20 feature exclusive to Plus & Pro-subscribers, or to players in a Game created by a Plus/Pro-subscriber. If you'd like to use this feature, consider upgrading your account.

(Updated ) Dynamic Lighting (aka. UDL) is the new version of the Roll20 lightning system, which is replacing the older Legacy Dynamic Lighting(LDL). It features a stronger framework for future feature enhancements, is more performant, and has been updated for more current computing technologies.

How to set up Dynamic Lighting

Contents

Pro
info Features

Feature Breakdown

Plus
info Features

Feature Breakdown

[edit] General

[edit] Official Documentation

UDL was created after Roll20 had moved their Official documentation to the Help Center, so the Community Wiki doesn't have duplicates of these articles, so these features have better pages there:

[edit] Features

Breakdown of the main features.

[edit] Explorer Mode

Explorer Mode & Udl-hide-icon.jpg Darkness Tool

Explorer Mode - reveal map as characters move around the map, and leave previously explored section greyed out.

With the Udl-hide-icon.jpg Darkness Tool you can create patches of explorable or permanent darkness, and it is also used for resetting Explorer Mode.

In LDL, the equivalent to Explorer Mode is AFoW.

You can also use Eclipses and freehand drawings for DL lines.

If you turn on Daylight, you can adjust the brightness of the default light on the map.

Adjust Daylight Brightness


Nocturnal Vision

[edit] Dark Vision

In April 2021, Dark Vision & Alternate Senses where released, making it possible to use D&D5E-accurate dark vision, if you turn on "Nocturnal Vision". Total darkness will by default be shown in grayscale, but you can change the tint to have a color. E.g. Night Vision technology could give you a green tint, while magic-based darkvision might make sense to have a purple tint.

[edit] Darkness Tool

The Udl-hide-icon.jpg Darkness Tool can be used for manage what players can or can't see, reset explored map back to darkness, or draw Permanent Darkness that even blocks normal vision.

It also incorporates features similar to the free Fog of War-tool, and replaces it's position on the Toolbar when UDL is active on a page. (C Fog of War isn't compatible with UDL).

[edit] Colored Lighting

Lights can have colors.

Colored Lighting

[edit] Place Tool

main page: Place Tool

You can quickly place lights, windows and doors on your map, with the Place Tool which can be found on the toolbar.

Roll20:Place Light Tool showcase

[edit] One-Way Barrier

One-way-barrier-beta-2022-03-18.png

Main Page: One-Way Barrier

"A great example of this would be setting it up so players can see there are pillars, but they can't see through the pillars."

[edit] Settings

[edit] Page

Main Page: Page Toolbar

Page DL settings for LDL and UDL are saved on separate tabs.

UDL Page Settings

UDL-PageSettings.png


[edit] Token

Main Page: Token Features

Token settings for LDL and UDL are saved on separate tabs.

UDL Token Settings UDL-TokenSettings.jpg

[edit] Other Features


[edit] API

Pro.png
This section is about a Roll20 feature exclusive to Pro-subscribers (and often to players in a Game created by a Pro-subscriber). If you'd like to use this feature, consider upgrading your account.

There is usually some delay between new UDL features getting introduced, and API scripting getting access to new object keys & functions to interact with them.

TokenMod(by The Aaron is a popular API that's been quickly updated when new UDL features have become API-accessible,

List of APIs using UDL-only features


Related APIs, which utilize UDL to various degree:

[edit] Known Issues


Fixed issues/past threads:




[edit] Comparison to Legacy DL

Roll20 have announced that LDL will be retired eventually More info:

In UDL, the old features of Advanced Fog of War have been renamed Explorer Mode to avoid confusion. Updated Dynamic Lighting uses WebGL, which is available in most computer systems and is supported by all the web browsers that Roll20 supports (Chrome and Firefox). The Legacy Dynamic Lighting has always used WebGL, so the change here is that Explorer Mode (previously Advanced Fog of War) now runs on the same system.

On January 14th, 2021, Roll20 announced Update 1.0(Blog, Archived), saying that "Updated Dynamic Lighting has been in the works for some time, and we see the 1.0 Update not as a finish line, but a checkpoint.". Despite this, there exists still multiple known issues, such as performance issues, and visual glitches relating to Darkvision.

[edit] Parallel Systems

As of Oct. 2021, UDL have several more features than LDL

Currently, UDL exist in parallel with the Legacy Dynamic Lighting(LDL), so you can use either one in your game, but LDL will eventually be discontinued.

While they continue development on Updated Dynamic Lighting and support for licensed products, both the Legacy system and the Updated will exist in parallel. However, when you switch from one to another, the revealed areas are not transferred over. So, for example, if you and your crew have been crawling through a dungeon with Advanced Fog of War on, and you decide to switch to the new Dynamic Lighting with Explorer Mode, your players won't see anything they had previously explored. Players can fix that by moving their tokens around to re-reveal the area.

Similarly, if you switch to Explorer Mode and then decide to hop back over to the Legacy system, anything you had revealed in the UDL system will be reset/hidden when changing to LDL. If you then switch back to the UDL, the revealed areas that you had revealed when you last used UDL(might?) still be there.

The Dynamic Lighting- layer, where you can add barriers that block light and movement, continues to function for both systems, and you do not need to change anything on that layer.

The Convert Lighting Tool making it possible to convert existing games to UDL automatically. This process can't be reversed easily, so if problems occur and you want to change everything back to LDL, you need to manually update all tokens & pages yourself. It's recommended to create a copy of your campaign, and perform the Conversion on the Copy, and keeping the original game as it is.

[edit] History

  •  ?? – First public info on UDL
  • March, 2020 – UDL was made available to Pro members on the Dev Server.
  • April 8th, 2020 – UDL was released as opt-in feature for Pro/Plus users, after having been available over a month on the Dev Server for Pro subs to try out.
    [1]
  • July 30th, 2020 – Roll20 announced UDL to have reached Feature Parity with LDL, but still have issues and optimization to do.
    [2]
  • August - December 2020 – regular updates & fixes where applied to UDL, and these minor change where communicated mostly in the UDL megathread and possibly twitter
    • There where no Blog Post or larger announcements during the time for UDL. On the monthly Community Roundtables(Twitch), questions about UDL progress was answered, and possibly some minor changes where mentioned.
    • During Roll20Con 2020, some updates where highlighted
  • January 14th, 2021 – Roll20 announced
    [3]
    • "Updated Dynamic Lighting has been in the works for some time, and we see the 1.0 Update not as a finish line, but a checkpoint.". Despite this, there exists still multiple known issues, such as performance issues, and visual glitches relating to Darkvision.
    • With the Update 1.0, they also emphasized that "We will still support Legacy Lighting for a while, but we feel it’s only fair to let you know that we will be deprecating our support for the Legacy system sometime in the future. "
    • No timeline for phased out LDL was announced.
    • Roll20 would close the current UDL feedback thread shortly and start a new one for Update 1.0
      [4]
  • Jan 27th, new feedback tread opened for Update 1.0: UDL 1.0 Updates, Bugs, & Feedback(Forum) (Jan 27th, 2021)
  • Feb 17th 2021, it was announced that LDL will be discontinued May 18th 2021(Blog, Archived)
    • Feb 6-17th, several updates related low light/dim light was rolled out. Adding a dim light opacity slider, setting in "Default Settings", and fixes.
      [5]
      [6]
    • Feb 18th, Dev comment on UDL situation(Forum)
  • April 2021 LDL removal was postponed, no new date was given An Update to the Legacy Dynamic Lighting Sunset Plan(Blog)
  • June-July 2021
  • Sep 1st Daylight brightness can be adjusted
  • Sept 8th Tutorial was updated to also showcase Dynamic Lighting, so also free users can try it out - details(Forum))
  • Sept 18th Place Light Tool(Forum) made available to tested on Dev Server
  • Oct. 1st 2021 Place-light-torch-icon.png Place Light Tool released for everyone
  • 2022 One-Way Barrier was released, and preparations for doors & windows where made
  • Jan 5th 2023 Place Tool was released, which can be used for placing Lights, Doors, and Windows.
    1

[edit] API

Pro.png
This is about a Roll20 feature exclusive to Pro-subscribers (and often to players in a Game created by a Pro-subscriber). If you'd like to use this feature, consider upgrading your account.

Roll20 Mod
Mod Suggestions

Mods by Category

Debug

Other

APIs have access to most UDL features, and some APIs such as TokenMod have updated to support UDL as best as it can.

There are some API, such as UDLWindows(Forum), which only works with Updated, and not Legacy.


Dynamic Lighting is a Plus/Pro feature that changes what parts of the map are visible to the players as they move their tokens around. The light-blocking walls are achieved by paths on the walls layer, and tokens are used as point light sources. Scripts which modify either the light emitted by tokens or the walls which block the light belong in this category.

Not all APIs, or all their features work on both Updated DL and Legacy DL, you have to check them closer to know that.

  • DLTool(Forum) - A Dynamic Lighting Control Panel and Troubleshooter by keith
  • Door Knocker -- Script helps quickly open and close doors by controlling the dynamic lighting lines, as well as creating "windows"
  • DLEllipseDrawer -- Draw circles and ellipses on the dynamic lighting layer.
  • Dynamic Light Recorder -- Save dynamic lighting paths for map tiles and automatically regenerate later
  • LightCrumb (UDL version), by Aaron (not tested)
  • Move Lighting -- Move dynamic lighting polygon path objects between layers.
  • Walls -- Builds Dynamic Lighting walls with an exported .svg path file.
  • ShareVision -- Allows normal vision and darkvision to be shared.
  • ToggleDaylight(Forum) -- turn daylight mode on, off, or toggle it for LDL or UDL on the current page.
  • Script:UniversalVTTImporter For importing Dynamic Lighting lines & light sources to Roll20 from map creation programs that can export to Universal VTT-file format.

Following Mods no longer work as well as previous, since real Doors and Windows where introduce:

  • UDLWindows(Forum) -- API for creating "windows", i.e. DL lines that blocks movement, but doesn't block vision.
  • UDLPasswall(Forum) - Walls that block sight, but not movement


APIs that only works with Legacy

  • LightCrumbTrails(Forum) -- Produces lit, shared-vision breadcrumbs behind character tokens. This allows them to see where they've been on maps with dynamic lighting.
  • One-Way Dynamic Lighting(Forum) -- Allows you to set up dynamic lighting walls that allow you to see through one side, but not the other.
  • Torch -- A simple script for giving lights to tokens and turning off and on dynamic lighting.
    • UDL version in the works


[edit] Related Pages

[edit] See Also

[edit] Blog Posts

[edit] Guides

[edit] Old threads

Retrieved from "https://wiki.roll20.net/index.php?title=Updated_Dynamic_Lighting&oldid=32553"