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
(→‎Official Documentation: update links)
m (→‎Related Pages)
(29 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[File:A-new-light-udl.jpg|right|thumbnail|350px]]
 
[[File:A-new-light-udl.jpg|right|thumbnail|350px]]
−
{{Pro only}}
+
{{Plus only}}
 +
{{notebox|This feature is under active development, so both the community wiki and the Help Desk documentation might lag behind the latest features a updates [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 13:43, 18 January 2021 (UTC) }}
  
−
'''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 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 performant, and has been updated for more current computing technologies. The old system is referred to as '''[[Legacy Dynamic Lighting|Legacy Dynamic Lighting (LDL)]]'''.
  
 
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.
 
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.
  
−
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.
+
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.
−
 
+
<br>
−
On July 30th, 2020, [https://blog.roll20.net/post/625101101120798720/a-new-light-a-new-path-ahead UDL reached Feature Parity with LDL], but still have issues and optimization to do before it becomes superior to the LDL on all aspects.
+
'''Roll20 have announced that [[LDL]] will be retired on soon''' Was <strike>May 18th 2021</strike>. More info:
−
 
+
* '''{{blogs|an-update-to-the-legacy-dynamic-lighting-sunset-plan/ LDL Plans Postoned}}''' (April 27th, 2021)
 +
* '''{{blogs|retiring-legacy-dynamic-lighting-what-you-need-to-know/  LDL retiring - What you need to know}}''' (Feb 17th)
 +
<br>
 
==Official Documentation==
 
==Official Documentation==
−
UDL was created after Roll20 had moved their Official documentation to the [https://roll20.zendesk.com/hc/en-us Help Center], so the Community Wiki doesn't have duplicates of these articles and is unlikely to have in the future either, so it's best to consult the Helpdesk pages for things related to UDL:
+
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:
  
−
* [https://roll20.zendesk.com/hc/en-us/sections/360008317214-Updated-Dynamic-Lighting Updated Dynamic Lighting] - List of All UDL Help Center articles (10 as of August 9th,2020)
+
* {{hc|articles/360052532233-How-to-Setup-a-Game-for-Updated-Dynamic-Lighting Updated Dynamic Lighting - How to Setup Game}}
−
* [https://roll20.zendesk.com/hc/en-us/articles/360052532233-How-to-Setup-a-Game-for-Updated-Dynamic-Lighting How to Setup a Game for Updated Dynamic Lighting]
+
* {{hc|articles/360044771413-Updated-Dynamic-Lighting-Light-Vision-Examples Updated Dynamic Lighting - Vision Examples}}
−
** [https://roll20.zendesk.com/hc/en-us/articles/360044771413-Lighting-Vision-Examples-and-Setups Lighting/Vision Examples and Setups]
+
* {{hc|articles/360046490373-Updated-Dynamic-Lighting-API-Support Updated Dynamic Lighting API Support}}
−
* [https://roll20.zendesk.com/hc/en-us/articles/360045793374-System-Requirements UDL System Requirements]
+
−
* '''Features'''
+
−
** [https://roll20.zendesk.com/hc/en-us/articles/360051768534-Darkness-Tool Darkness Tool] - the UDL name for the old [[FoW|Fog of War]]/ Hide&Reveal Tool
+
−
** [https://roll20.zendesk.com/hc/en-us/articles/360052521913-Page-Settings#page-settings-0-1 Explorer Mode] - the UDL version of  the old [[AFoW|Advanced Fog of War(AFoW)]]
+
−
** [https://roll20.zendesk.com/hc/en-us/articles/360052433093-How-to-Use-the-Convert-Lighting-Tool Convert Lighting Tool]
+
−
* [https://roll20.zendesk.com/hc/en-us/articles/360046490373-Updated-Dynamic-Lighting-API-Support UDL API Support] - Helpdesk article
+
  
 
==Parallel Systems==
 
==Parallel Systems==
−
Currently UDL exist in parallel with the [[Legacy Dynamic Lighting|Legacy Dynamic Lighting(LDL)]] until all issues are resolved, even though it reached feature parity on July 30th. Users will be warned well in advance when LDL will be phased out so people have time to adjust.
+
Currently, UDL exist in parallel with the [[Legacy Dynamic Lighting|Legacy Dynamic Lighting(LDL)]].
  
−
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.
+
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.
 
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 [[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.
+
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.
  
−
[https://blog.roll20.net/post/625723091466747904/a-new-light-the-convert-lighting-tool-is-now On August 6th], the [[Convert Lighting Tool]] was released, making it possible to convert existing games to UDL automatically.
+
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.
  
 
==Features==
 
==Features==
 +
Breakdown of the main features.
 +
===Explorer Mode===
 +
'''Explorer Mode''' - reveal map as characters move around the map, and leave previously explored section greyed out.
 +
 +
With the Darkness Tool you can create patches of darkness that can be explorable, and it can also reset areas that have already been explored.
 +
 +
In [[LDL]], the equivalent to Explorer Mode is [[AFoW]].
 +
 +
Since April, you can also use Eclipses and freehand drawings for DL lines.
 +
 +
====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.
 +
 +
===[[Darkness Tool]]===
 +
The [[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. (FoW isn't compatible with UDL).
 +
 +
===[[Convert Lighting]]===
 +
[[Convert Lighting]] is a one-way tool to automatically convert a campaign's Dynamic Lighting setting(tokens, pages) using [[LDL]] to use UDL.
 +
 +
You access it from your [[Game Management#Settings]].
  
 
===Page===
 
===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]]
Line 45: Line 68:
 
{{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]]
  
 +
===API===
 +
There seems to be a lag between new UDL features and API getting access to 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'''
 +
 +
* '''{{fpl|9919591/ DoorKnocker}}''' -- Script helps quickly open and close doors by controlling the dynamic lighting lines. '''v1.211''' Introduces option to create "[[windows]]", sections that stop movement but not sight. {{repo|Roll20/roll20-api-scripts/tree/master/Door%20Knocker sourcecode}} | {{yt.be|JaRF9LhhPcc Tutorial}}
 +
* {{fpl|9532981 UDLWindows}} -- API for creating 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 API that utilize UDL to various degree:
 +
* [[API:Script_Index#Dynamic_Lighting]]
 +
* [[API:Script_Index#Tokens]]
 +
 +
==Known Issues==
 +
The latest UDL Bug thread lists the {{forum|permalink/9741240/ UDL 1.0 Updates, Bugs, & Feedback}}, and this section (sporadically) updates based on it.
 +
 +
'''Known Issues List: (updated Feb 19th 2021)'''
 +
 +
'''Committed to fix before LDL Sunset:'''{{source|https://blog.roll20.net/post/posts/retiring-legacy-dynamic-lighting-what-you-need-to-know/}}
 +
 +
* '''PAGE REVEAL''': This is an old problem that we believed to be fixed, but we have seen reports of it resurfacing. If you’re experiencing this issue, please let us know!
 +
* '''SETTINGS''': There are reports of UDL settings not saving. We’ve released a patch that we believe solves this but will continue to monitor to see if it crops back up.
 +
* '''JAGGED LINES''': Some usage of UDL can cause jagged lines on the fringes of token vision. We are currently working on an anti-aliasing solution.
 +
* '''LAG''': We’ve heard you: Lag is the number 1 reason users aren’t converting to UDL. Since UDL started, we’ve put out a number of patches to improve performance; we are actively improving response times with each update. We’re currently testing a solution that will significantly improve network performance that we will be rolling out in the next couple of weeks.
 +
* '''NIGHT VISION''': There are parts of Night Vision that still need to be fixed, like Night Vision tokens overlapping and animated tokens having a ghost like effect on the GM layer.
 +
 +
 +
'''Issues that might not get fixed before sunset:'''{{source|https://blog.roll20.net/post/posts/retiring-legacy-dynamic-lighting-what-you-need-to-know/}}
 +
 +
We also have a few issues that we’re still collecting info on. While these bugs are high priority, we’re still investigating the best way to fix them. If you are experiencing any of these, please report it in our bug forum. The following is a list of fixes that will be addressed either before sunsetting LDL or sometime soon after:
 +
 +
* '''RING/BULLSEYE EFFECT''': There is a documented issue where some light sources have a ring/bullseye effect to them.
 +
* '''PAGE FREEZING''': There have been a handful of reports of UDL freezing games. We’re currently determining the root cause of these freezes. This is the bug we currently need the most information on. If you’ve experienced it, please let us know through our Help Center.
 +
* '''GRID''': We’ve received reports of Players and GMs losing sight of the grid when using characters with Night Vision.
 +
* '''VISIBILITY''': We’ve received reports of Players and GMs losing their sight, or experiencing tokens disappearing after moving specific tokens.
 +
 +
 +
'''Fixed issues/past threads:'''
 +
 +
* {{forum|permalink/8422746/ list of solved issues}} - 1st thread, posted April 8th 2020
 +
* {{forum|permalink/9072910/ list of solved issues}} -  2nd thread, posted August 14th 2020
 +
 +
==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.{{source|https://blog.roll20.net/post/614847973200969728/a-new-light}}
 +
* '''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}}
 +
* '''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}}
 +
=API=
 +
{{pro only}}
 +
[[API|APIs]] have access to most UDL features, and some APIs such as [[TokenMod]] have updated to support UDL as best as it can.
  
−
===Known Issues===
+
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 UDL, and not LDL.
−
The UDL Bug thread lists 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  & what is currently worked on], and this section replicates it.
+
  
−
'''(list updated August 9th 2020)'''
+
Check '''[[API:Script_Index#Dynamic_Lighting]]''' for list of some API that interacts with [[UDL]] & [[LDL]].
  
−
'''Currently Working On'''
+
=Related Pages=
−
** Automatic tool to convert Legacy Dynamic Lighting settings - available on the Dev Server for Pro Subscribers
+
* [[Windows (DL)]] - create barriers that stop movement, but not sight.
−
** Updated Dynamic Lighting fails on very large maps.
+
* [[Optimizing Roll20 Performance]] - general advice
−
** 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.
+
* [[Legacy_Dynamic_Lighting_Examples#Best_Performance_Guide|Best Performance Guide (Legacy) DL]] - older guide written for LDL but might help for UDL as well
−
* '''Known Issues List:'''
+
* [[Game Management]]
−
** In certain systems, images from the map layer are being distorted and skewed when viewed using Dynamic Lighting.
+
** [[Page Settings]] Info on page-specific settings
−
** Unexpected behavior is occurring with masks created by circles.
+
* [[Dummy Account]] - good for double-checking how things look like from a player's perspective
−
** Mask outlines are not as smooth as expected.
+
−
** Zooming out with browser zoom, not the VTT zoom, can cause some strange visual issues.
+
−
** If a player's system crashes, they will occasionally have DL masks revealed to them.
+
−
** There is still slight lag with keyboard movements using UDL.
+
−
* '''Fixed issues:'''
+
−
** [https://app.roll20.net/forum/permalink/8422746/ full list of solved issues]
+
−
** <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
+
−
** <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
+
−
** <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
+
−
** <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
+
−
** <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
+
−
** <s>Light bleeds through some corners in Dynamic Lighting barriers (in explorer mode, this can result in areas being revealed).</s> Fixed May 21
+
−
** <s>A "pixel dust" like effect is occurring within certain markings.</s> Fixed June 30
+
−
** <s>There is no "update only on drop" option.</s>  Fixed June 30
+
−
** <s>Night Vision does not allow for Low Light at the moment and appears the same as Bright Light.</s>  Fixed June 30
+
−
** <s>Dragging a token next to a Dynamic Lighting barrier can result in vision past the barrier.</s> Fixed June 30
+
  
 
=See Also=
 
=See Also=
−
* [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]
+
* {{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
 
== Blog Posts==
 
== Blog Posts==
−
* [https://blog.roll20.net/post/625723091466747904/a-new-light-the-convert-lighting-tool-is-now A New Light The Conversion Tool is Now Live!] (August 6th,2020)
+
* {{blog|posts/retiring-legacy-dynamic-lighting-what-you-need-to-know/ LDL retiring - What you need to know}}} (Feb 17th 2021)
−
* [https://blog.roll20.net/post/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|640321601818198016/updated-dynamic-lighting-10-is-live Updated Dynamic Lighting 1.0 is Live}} (Jan 14th, 2021)
−
* [https://blog.roll20.net/post/614847973200969728/a-new-light A New Light] UDL is released (April 8th 2020)
+
* {{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)
 
<br>
 
<br>
 
<br>
 
<br>
 
[[Category:Docs]]
 
[[Category:Docs]]
 
[[Category:Dynamic Lighting]]
 
[[Category:Dynamic Lighting]]
 +
[[Category:UDL]]
 +
[[Category:Plus]]
 +
[[Category:Pro]]

Revision as of 15:55, 21 May 2021

A-new-light-udl.jpg
Plus.png
This 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.
This feature is under active development, so both the community wiki and the Help Desk documentation might lag behind the latest features a updates Andreas J. (talk) 13:43, 18 January 2021 (UTC)


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 performant, and has been updated for more current computing technologies. The old system is referred to as Legacy Dynamic Lighting (LDL).

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), 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.
Roll20 have announced that LDL will be retired on soon Was May 18th 2021. More info:


Contents

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:

Parallel Systems

Currently, UDL exist in parallel with the Legacy Dynamic Lighting(LDL).

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.

Features

Breakdown of the main features.

Explorer Mode

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

With the Darkness Tool you can create patches of darkness that can be explorable, and it can also reset areas that have already been explored.

In LDL, the equivalent to Explorer Mode is AFoW.

Since April, you can also use Eclipses and freehand drawings for DL lines.

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.

Darkness Tool

The 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. (FoW isn't compatible with UDL).

Convert Lighting

Convert Lighting is a one-way tool to automatically convert a campaign's Dynamic Lighting setting(tokens, pages) using LDL to use UDL.

You access it from your Game Management#Settings.

Page

Main Page: Page Toolbar

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

UDL Page Settings

UDL-PageSettings.png


Token

Main Page: Token Features

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

UDL Token Settings UDL-TokenSettings.jpg

API

There seems to be a lag between new UDL features and API getting access to 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 API that utilize UDL to various degree:

Known Issues

The latest UDL Bug thread lists the UDL 1.0 Updates, Bugs, & Feedback(Forum), and this section (sporadically) updates based on it.

Known Issues List: (updated Feb 19th 2021)

Committed to fix before LDL Sunset:
[1]
  • PAGE REVEAL: This is an old problem that we believed to be fixed, but we have seen reports of it resurfacing. If you’re experiencing this issue, please let us know!
  • SETTINGS: There are reports of UDL settings not saving. We’ve released a patch that we believe solves this but will continue to monitor to see if it crops back up.
  • JAGGED LINES: Some usage of UDL can cause jagged lines on the fringes of token vision. We are currently working on an anti-aliasing solution.
  • LAG: We’ve heard you: Lag is the number 1 reason users aren’t converting to UDL. Since UDL started, we’ve put out a number of patches to improve performance; we are actively improving response times with each update. We’re currently testing a solution that will significantly improve network performance that we will be rolling out in the next couple of weeks.
  • NIGHT VISION: There are parts of Night Vision that still need to be fixed, like Night Vision tokens overlapping and animated tokens having a ghost like effect on the GM layer.


Issues that might not get fixed before sunset:
[2]

We also have a few issues that we’re still collecting info on. While these bugs are high priority, we’re still investigating the best way to fix them. If you are experiencing any of these, please report it in our bug forum. The following is a list of fixes that will be addressed either before sunsetting LDL or sometime soon after:

  • RING/BULLSEYE EFFECT: There is a documented issue where some light sources have a ring/bullseye effect to them.
  • PAGE FREEZING: There have been a handful of reports of UDL freezing games. We’re currently determining the root cause of these freezes. This is the bug we currently need the most information on. If you’ve experienced it, please let us know through our Help Center.
  • GRID: We’ve received reports of Players and GMs losing sight of the grid when using characters with Night Vision.
  • VISIBILITY: We’ve received reports of Players and GMs losing their sight, or experiencing tokens disappearing after moving specific tokens.


Fixed issues/past threads:

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.
    [3]
  • July 30th, 2020 – Roll20 announced UDL to have reached Feature Parity with LDL, but still have issues and optimization to do.
    [4]
  • 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
    [5]
    • "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
      [6]
  • 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)
    • 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.
      [7]
      [8]
    • Feb 18th, Dev comment on UDL situation(Forum)

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.

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 UDL, and not LDL.

Check API:Script_Index#Dynamic_Lighting for list of some API that interacts with UDL & LDL.

Related Pages

See Also

Blog Posts

Guides



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