Difference between revisions of "Updated Dynamic Lighting"
From Roll20 Wiki
Andreas J. (Talk | contribs) m |
Andreas J. (Talk | contribs) (Place Light Tool, general updates, "How to use DL"-video) |
||
| Line 1: | Line 1: | ||
| − | {{revdate}}{{Plus only}} | + | {{revdate}}{{Plus only|page}} |
{{notebox|This feature is under active development, so both the community wiki and the [[Help Center]] documentation might lag behind the latest features & updates [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 16:03, 19 September 2021 (UTC) }} | {{notebox|This feature is under active development, so both the community wiki and the [[Help Center]] documentation might lag behind the latest features & updates [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 16:03, 19 September 2021 (UTC) }} | ||
''(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. | ''(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}} | |
==General== | ==General== | ||
| − | |||
| − | |||
| − | |||
==Official Documentation== | ==Official Documentation== | ||
| Line 13: | Line 10: | ||
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: | 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: | ||
| + | * {{hc|articles/4403801475479-What-Is-Dynamic-Lighting What Is Dynamic Lighting?}} | ||
* {{hc|articles/4403861702679-How-To-Set-Up-Dynamic-Lighting How To Set Up Dynamic Lighting}} | * {{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/360044771413-Updated-Dynamic-Lighting-Light-Vision-Examples Updated Dynamic Lighting - Vision Examples}} | ||
| Line 19: | Line 17: | ||
==Features== | ==Features== | ||
Breakdown of the main features. | Breakdown of the main features. | ||
| − | ===Explorer Mode=== | + | ===[[Explorer Mode]]=== |
| − | {{#evp:youtube| | + | {{#evp:youtube|8qVpF0olnVs|Explorer Mode & {{Darkness}} |right|350}} |
| − | '''Explorer Mode''' - reveal map as characters move around the map, and leave previously explored section greyed out. | + | '''[[Explorer Mode]]''' - reveal map as characters move around the map, and leave previously explored section greyed out. |
| − | With the Darkness | + | With the {{Darkness}} 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]]. | In [[LDL]], the equivalent to Explorer Mode is [[AFoW]]. | ||
| Line 30: | Line 28: | ||
If you turn on Daylight, you can adjust the brightness of the default light on the map. | If you turn on Daylight, you can adjust the brightness of the default light on the map. | ||
| − | <br clear= | + | {{#evp:youtube|mtEi8OmmBKE|Adjust Daylight Brightness|left|350}} |
| + | <br clear="left"> | ||
{{#evp:youtube|dXSIKFT7t2Y|Nocturnal Vision|right|350}} | {{#evp:youtube|dXSIKFT7t2Y|Nocturnal Vision|right|350}} | ||
====Dark Vision==== | ====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. | 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> | <br clear=all> | ||
===[[Darkness Tool]]=== | ===[[Darkness Tool]]=== | ||
| − | The | + | 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. |
| − | 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. ( | + | 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=== | ===Colored Lighting=== | ||
| Line 45: | Line 43: | ||
{{#evp:youtube|0-vI21YLr7k|Colored Lighting|center|350}} | {{#evp:youtube|0-vI21YLr7k|Colored Lighting|center|350}} | ||
| − | === | + | ===Place Light=== |
| − | + | ''main page:'' '''{{Place Light}}''' | |
| − | + | ||
| − | + | You can quickly place lights on your map, with the {{Place Light}}, that can be found on the [[toolbar]]. | |
| + | {{#evp:youtube|b0fTN84KyEI| Roll20:[[Place Light Tool]] showcase|center|350}} | ||
| − | ===Page=== | + | ===Settings=== |
| + | ====Page==== | ||
{{main|Page Toolbar}} | {{main|Page Toolbar}} | ||
| Line 60: | Line 60: | ||
| − | ===Token=== | + | ====Token==== |
{{main|Token Features}} | {{main|Token Features}} | ||
| Line 67: | Line 67: | ||
{{hc|articles/360051754954-Token-Settings UDL Token Settings}} | {{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=== | ===API=== | ||
| − | There | + | {{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, | [[TokenMod]](by [[The Aaron]] is a popular API that's been quickly updated when new UDL features have become API-accessible, | ||
| Line 81: | Line 87: | ||
| − | Related | + | Related APIs, which utilize UDL to various degree: |
* [[API:Script_Index#Dynamic_Lighting]] | * [[API:Script_Index#Dynamic_Lighting]] | ||
* [[API:Script_Index#Tokens]] | * [[API:Script_Index#Tokens]] | ||
| Line 99: | Line 105: | ||
==Comparison to Legacy DL== | ==Comparison to Legacy DL== | ||
| + | '''Roll20 have announced that [[LDL]] will be retired eventually''' More info: | ||
| + | * '''{{blogs|an-update-to-the-legacy-dynamic-lighting-sunset-plan/ LDL Plans Postoned}}''' (April 27th, 2021) | ||
| + | |||
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. | ||
| Line 104: | Line 113: | ||
===Parallel Systems=== | ===Parallel Systems=== | ||
| + | {{notebox| As of Oct. 2021, UDL have several more features than LDL}} | ||
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. | 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. | ||
| Line 143: | Line 153: | ||
* '''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 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]] | * '''Sept 18th''' {{fpl|10384414/ Place Light Tool}} made available to tested on [[Dev Server]] | ||
| − | + | * '''Oct. 1st''' {{Place Light}} released for everyone | |
=API= | =API= | ||
{{pro only}} | {{pro only}} | ||
| Line 153: | Line 163: | ||
=Related Pages= | =Related Pages= | ||
| + | * [[Updated Dynamic Lighting]] | ||
| + | ** [[Explorer Mode]] | ||
| + | ** {{Darkness}} | ||
* [[Windows (DL)]] - create barriers that stop movement, but not sight. | * [[Windows (DL)]] - create barriers that stop movement, but not sight. | ||
* [[Optimizing Roll20 Performance]] - general advice | * [[Optimizing Roll20 Performance]] - general advice | ||
Revision as of 16:28, 3 October 2021
 | Page Updated: 2021-10-03 |
 | 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. |
 | This feature is under active development, so both the community wiki and the Help Center documentation might lag behind the latest features & updates Andreas J. (talk) 16:03, 19 September 2021 (UTC) |
(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.
Contents |
General
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:
- What Is Dynamic Lighting?
- How To Set Up Dynamic Lighting
- Updated Dynamic Lighting - Vision Examples
- Updated Dynamic Lighting API Support
Features
Breakdown of the main features.
Explorer Mode
Darkness ToolExplorer 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 explorable or permanent darkness, and it is also used for resetting Explorer Mode.
In LDL, the equivalent to Explorer Mode is AFoW.
Since April, 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.
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. (C Fog of War isn't compatible with UDL).
Colored Lighting
Lights can have colors.
Place Light
main page: 
Place Light Tool
You can quickly place lights on your map, with the Place Light Tool, that can be found on the toolbar.
Settings
Page
Main Page: Page Toolbar
Page DL settings for LDL and UDL are saved on separate tabs.
Token
Main Page: Token Features
Token settings for LDL and UDL are saved on separate tabs.
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
 | 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
- DoorKnocker(Forum) -- 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. sourcecode | Tutorial
- UDLWindows(Forum) -- API for creating DL lines that blocks movement, but doesn't block vision.
- UDLPasswall(Forum) - Walls that block sight but not movement
- UDL version of LightCrumb, by Aaron (not tested)
Related APIs, which utilize UDL to various degree:
Known Issues
- Dynamic Lighting - Updates, Bugs, & Feedback(Forum) (July 2021)
- Dynamic Lighting Portal unified portal for all updates related to it
Fixed issues/past threads:
- list of solved issues(Forum) - 1st thread, posted April 8th 2020
- list of solved issues(Forum) - 2nd thread, posted August 14th 2020
- UDL 1.0 Updates, Bugs, & Feedback(Forum) - 3rd thread, posted Jan 2021
Comparison to Legacy DL
Roll20 have announced that LDL will be retired eventually More info:
- LDL Plans Postoned(Blog) (April 27th, 2021)
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.
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.
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.
- July 30th, 2020 – Roll20 announced UDL to have reached Feature Parity with LDL, but still have issues and optimization to do.
- 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
- "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
- 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.
- 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
- DL User interface update June 2nd(Forum)
- Nocturnal Mode - Darkvision closer to how 5E and PF2E uses it
- Colored lighting Color Your Creativity With New Lighting Options!(Blog) - Jul 21
- more API access(Forum)
- Dynamic Lighting - Updates, Bugs, & Feedback(Forum) - new forum thread
- Dynamic Lighting Portal - released
- Feathered Edges on shadows(Forum)
- 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
Place Light Tool released for everyone
API
| 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
- Updated Dynamic Lighting
- Windows (DL) - create barriers that stop movement, but not sight.
- Optimizing Roll20 Performance - general advice
- 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
- New Dynamic Lighting Showcase 59min, (Feb 6th, 2021)
- Dynamic Lighting - Updates, Bugs, & Feedback(Forum) (July 2021)
- Dynamic Lighting Portal
Blog Posts
- Tome of Tips: Dynamic Lighting(Blog) July 2021
- Color Your Creativity With New Lighting Options!(Blog) - Jul 21
- An Update to the Legacy Dynamic Lighting Sunset Plan(Blog) (April 27th, 2021)
- LDL retiring - What you need to know(Blog, Archived)} (Feb 17th 2021)
- Updated Dynamic Lighting 1.0 is Live(Blog, Archived) (Jan 14th, 2021)
- A New Light The Conversion Tool is Now Live!(Blog, Archived) (August 6th,2020)
- A New Light A New Path Ahead(Blog, Archived) UDL reached Feature Parity with LDL (July 30th, 2020)
- A New Light(Blog, Archived) UDL is released (April 8th 2020)
Guides
- UDL Tutorial by Roll20 youtube playlist, (August 2020)
Old threads
- UDL 1.0 Updates, Bugs, & Feedback(Forum) (Jan 27th, 2021)
- UDL - Feedback/Bug Report Thread(Forum) (Jan 14th, 2021)
- UDL Known Issues List(Forum) (as of Jan 14th, 2021) Legacy Sunset phase
