Compatibility Lighting becomes Retro Tone Mapping [Sunset + Migration]

LightBeamRays · August 21, 2024, 10:30pm

[Update] September 26, 2024

LightBeamRays:

Hi all!

This is a quick update to inform you that we are delaying the date for phase 2 (Migration opt-out) to October 1st to give you a bit more time to experiment with the migration during the opt-in phase. We are also delaying phase 3 (full sunset of Compatibility) to the week of November 11.

The updated sunset plan is therefore the following:

Phase 2 (Migration Opt-out): October 1

All places using Compatibility Lighting will be automatically migrated to Voxel Lighting + Retro Tone Mapping when opening Studio. You will be able to revert this migration and opt-out from it.

Phase 3 (Full sunset): Week of November 11.

Compatibility Lighting will be removed from the Lighting.Technology dropdown and all places using Compatibility will use Voxel Lighting + Retro Tone Mapping instead. It will not be possible to revert this migration.

Hi Creators,

Today, we are announcing that Compatibility Lighting will be sunset over the course of the next 2 months and migrated to our new Tone Mapping Preset so you can continue achieving a similar visual look for your experience.

This sunset will enable us to make improvements to our lighting system, such as better lighting scalability, which were constrained by the maintenance of Compatibility Lighting, while letting you achieve a similar look.

If you are using Compatibility Lighting in your experiences, we encourage you to migrate your place to Voxel Lighting as early as possible. Voxel is the same code path as Compatibility Lighting and offers the same performance, but it treats light brightness differently.

We provide information on how to migrate and preserve your visuals below.
If you are not using Compatibility Lighting, you have nothing to do .

ColorGradingEffect and ToneMapperPreset

First, today we are releasing ColorGradingEffect, which is a new instance you can add to your post processing effects under “Lighting”. It currently provides only one simple property called ToneMapperPreset which has 2 options:

Default is the current Tone Mapping we use with Future, ShadowMap or Voxel Lighting.
Retro is the Tone Mapping we use for Compatibility Lighting and provides a retro Roblox style many of you like.

All values of ToneMapperPreset can be used with any lighting technology. For example, the “Retro” preset could be used with “Future” Lighting. Read more about the new tone mapping presets in our Creator Documentation.

Removal of Compatibility Lighting

Second, we will be sunsetting Compatibility Lighting over the course of the next 2 months, in 3 phases:

Phase 1 (Migration Opt-in): Starting now

Places using Compatibility be can migrated to Voxel Lighting + Retro Tone Mapping at your convenience, whenever it is the best time for you (we recommend migrating as early as possible).

Please note: Compatibility Lighting will not be available anymore for places already using other lighting technologies (i.e. Future, ShadowMap or Voxel).

Phase 2 (Migration Opt-out): Week of Sept. 16

All places using Compatibility Lighting will be automatically migrated to Voxel Lighting + Retro Tone Mapping when opening Studio. You will be able to revert this migration and opt-out from it.

Phase 3 (Full sunset): Week of Oct. 21

Compatibility Lighting will be entirely removed from the Lighting. Technology dropdown and all places using Compatibility will use Voxel Lighting + Retro Tone Mapping instead. It will not be possible to revert this migration.

How to migrate from Compatibility to Voxel Lighting

During this transition period, we provide you with a migration tool to more easily convert experiences using Compatibility Lighting to Voxel Lighting.

To use this migration tool:

Click on the Lighting > Technology property.
Then click on the … button appearing next to it.
The migration dialog will open. Click on “Migrate”.
As an optional step, you can apply our local lights migration script provided below, under the “optional local lights migration script” section, to adapt your local lights.

This migration will not give you a perfect brightness match for your local lights. In Compatibility, local lights with a brightness > 1.0 are using a brightness of 1.0, but display a larger light radius. This is not achievable in Voxel Lighting. This means those specific lights will look brighter in Voxel to get the same radius, or will have a smaller radius for the same brightness. You might need to adjust your local lights’ brightness to retrieve your original look.

Please migrate as early as possible to have time to adjust your local lights before Compatibility’s full Sunset.

An outdoor scene and a local light with brightness = 5.0.
Compatibility (Left) and Voxel with Retro Tone Mapping (Right)

Optional: Local Lights Migration Script

This script sets all your lights that have a brightness > 1.0 to a brightness of exactly 1.0. This will give you the same brightness your lights had in Compatibility Lighting, but it will not give you the same light radius. It can help accelerate your migration work, but you will need to manually increase the brightness of the local lights you’d like to set at a larger radius.

To execute this script, open View > Command Bar and copy paste the code below. Press Enter. You can roll back this script with CTRL + Z ( ⌘ + Z on Mac).

local ChangeHistoryService = game:GetService("ChangeHistoryService")
local recording = ChangeHistoryService:TryBeginRecording("Clamp Local Lights to 1.0")

for _, part in pairs(workspace:GetDescendants()) do
    if part:IsA("Light") and part.Brightness > 1 then
        part.Brightness = 1
    end
end

ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)

Made with care by the Engine team

As always, please let us know if you experience any challenges with the Compatibility Lighting migration or with using the new ColorGradingEffect.

Thank you.

FAQ

Click here to view the FAQ!

Why are you sunsetting Compatibility Lighting?

Compatibility Lighting was released when we updated our Lighting system many years ago with the intent of being sunset. Its purpose was to imitate Roblox’s old lighting system’s visual look. It is the exact same technology as Voxel Lighting, but it applies a different tone mapping curve and a brightness clamp on lights.

We have several lighting improvement projects in the making, but with Compatibility not being a real Lighting Technology, we are facing complexities in keeping it around. However, we want to allow you to continue achieving a similar look which is why we decided to find a proper home for Compatibility, as a Tone Mapping feature.

Will moving to Voxel Lighting impact my experience’s performance?

Not one bit. Compatibility Lighting uses the exact same code as Voxel Lighting. Compatibility had additional code to change the Tone Mapping curve and it clamped the lights’ brightness to 1.0.

Will you provide more Tone Mapper Presets in the future?

Releasing our new ColorGradingEffect instance is the first step for that. We are not working on releasing more Tone Mapping Presets at this time, but we would like to extend those functionalities in the future. We don’t have concrete plans to announce at this time.

Why are the local lights’ brightness not adjusted with the migration tool?

In Compatibility Lighting, all lights with a brightness > 1.0 display a brightness of exactly 1.0, but can show a larger light radius. This is not achievable in Voxel so we can’t provide a perfect conversion for local lights.

Some developers might find that the migration script provided above accelerates their migration, but that would not be true for all experiences. Additionally, our migration tool is built so that you can revert the migration during the opt-out phase (phase 2). Since an experience can have a very high amount of lights, we are not able to save the original state of all local lights to provide a way to revert it.

What should I do if I use Compatibility and I was scripting lights’ brightness?

For local lights, If you are increasing brightness values above 1.0, we recommend that you verify the visual results obtained and choose if you’d like to lower the brightness values to avoid over-exposure.
For the sunlight, there exists a direct value conversion between Compatibility and Voxel. If desired, you can use the following function to obtain the direct brightness conversion for the Sunlight:

local adjustBrightnessCompatibilityToVoxel = function(brightness: number)

	brightness = math.clamp(brightness, 0.0, 5.0)
	if brightness >= 0.5 then
		brightness = 3.135266 + (0.5605744 - 3.135266) / ((1 + (brightness / 92.74922) ^ 3.400255) ^ 3365850.0)
	else
		brightness *= 1.44611366946
	end
	return brightness
end

[Update] August 27, 2024

LightBeamRays:

Hey everyone,

I’d like to add more clarity into why we are sunsetting Compatibility, and removing Brightness clamp. In a nutshell, we have to balance the pain points from the sunset of Compatibility (i.e. losing brightness clamp and light anisotropy) against helping the vast majority of our developers who are having important issues with the Lighting system’s scalability.

The main problem we’re trying to solve is that automatic scaling, which reduces Lighting quality when an experience runs at a low framerate, often does not respect developers’ intent – it doesn’t make the best performance decision for many existing experiences and it breaks their artistic intent. It also over-aggressively cuts other features such as draw distance.

To respect artistic intent and improve scalability at once, we need to:

Separate artistic decisions from the underlying Lighting Technologies as much as possible

Make sure that any artistic controls work as intended across different Lighting Technologies to preserve artistic intent

Compatibility is not a Lighting Technology (the Technology is Voxel), but it is an artistic choice. The main artistic difference that could be supported across all lighting technologies (Voxel, ShadowMap and Future) is its tone mapping.

As some of you pointed out, the brightness clamp and anisotropic lighting are also part of Compatibility’s aesthetic. The brightness clamp was not extracted into a property because:

It would have incoherent visual results on other Lighting Technologies.

It would also impose significant complexity to our lighting shaders which would impact the performance of every experience, even those not using it.

As a scriptable property, it would fully invalidate the lightgrid every single time the property would change, causing light flickering and performance instabilities.

On the other hand, we tested the migration on a high number of places using Compatibility and we found it is possible to achieve a similar result by adjusting local lights, even if not a perfect 1:1 match. Since similar visual results to Compatibility (although not perfect) can continue being achieved and considering the downsides of the clamp when used with other Lighting Technologies, we decided to sunset it.

system · August 21, 2024, 10:40pm

This topic was automatically opened after 10 minutes.

ColRealPro · August 21, 2024, 10:40pm

well that sucks, but understandable

also will the technology property of lighting ever be scriptable in the future?

HooferBevelops · August 21, 2024, 10:40pm

Happy to see that Roblox is providing tooling to accurately reflect these removals, rather than fully removing them without the ability to replicate that same style. ~~I did notice that the light brightness script doesn’t use ChangeHistoryService, so undoing will have weird side-effects.~~ (Edit: this is now fixed! I’ll leave the code here.)

game:GetService("ChangeHistoryService"):SetWaypoint("Brightness Change Start")

for _, part in pairs(workspace:GetDescendants()) do
    if part:IsA("Light") and part.Brightness > 1 then
        part.Brightness = 1
    end
end

game:GetService("ChangeHistoryService"):SetWaypoint("Brightness Change Complete")

Archiitectt · August 21, 2024, 10:41pm

Thanks to the Engine team for the clear guidance on this transition! While it’s bittersweet to see Compatibility Lighting go, the new Retro Tone Mapping offers a great way to maintain that classic Roblox look. I’d suggest everyone migrate early to avoid last-minute issues and take advantage of the new lighting capabilities. Let’s embrace this change and see how it can enhance our creations!

QALOLTHING · August 21, 2024, 10:42pm

Well this should be better. I hope that tone mapping will be used for more interesting things in the future!

supernovasalmon · August 21, 2024, 10:42pm

I was just talking with my friend about what the ColorGradingEffect could be a bit ago. Hopefully this gets expanded with more advanced lighting options in the future, like with color LUTs.

keyre124 · August 21, 2024, 10:43pm

I PREDICTED THIS. NOOOOOOOoooooo

JuJuGamer7 · August 21, 2024, 10:46pm

Nice to see color grading be added but i’m incredibly sad you can’t do more with it.

It’s also sad to see compatibility go but atleast you did the best to maintain the compatibility feel with the tonemapper preset.

Hopefully one day we can use the color grading effect like other game engines.

abidbmt · August 21, 2024, 10:46pm

Great! I hope more technologies that are barely used anymore will be sunset which allows more focus on developing new features and improving upon already existing features which need improvement

cfnaw · August 21, 2024, 10:46pm

It’s unfortunate that compatibility is getting removed, but I will say that this change was handled very well compared to some others in recent memory. I’m not really into gamedev but I can see tone mapping really helping creators with making the lighting in their games pop out. Also glad that you didn’t out right remove compatibility but rather made it into a tone map, which is pretty convenient for anyone wanting to make a classic styled game

keyre124 · August 21, 2024, 10:48pm

Its being used in thousands of games right now

GuilleLopezD · August 21, 2024, 10:55pm

Welp, the day that i always had in the back of my head has arrived.

I still use compatibility for most of my work and i am thankful for there being a way to get a similar look, thanks for at least not out right removing it and instantly forcing Voxel onto games that already use compatibility out of nowhere.

While im not happy with the removal of Compatibility i can sort of see why its being removed (not a lot of games using it, it basically emulating Legacy, which hasnt existed for 5 years (RIP).

The gradient does a good job at replicating the Compatibility feel, but it does have a few issues such as the lights and shadows being a bit different, i wonder if there will be a way for old, abandoned games to not get their lighting kind of screwed by very bright lights (which seems to be the number 1 issue for me at least)

TLDR: While im not happy in the slightest about Compatibility lighting getting removed, i like the color gradient being added instead of a full on removal.

(also will there ever be a way to replicate the Legacy lighting neon look? I’d like that to be honest.)

Please feel free to correct me if i am wrong in anything that i said.

Ahmitey · August 21, 2024, 10:58pm

Hope roblox will eventually add the ability to make custom shaders & custom lighting.

Linux_55 · August 21, 2024, 11:05pm

Thanks for updating the lighting engine and providing us with the new post processing effects! Is it also possible that we could get Gobo Lighting feature in near future? Gobo (lighting) - Wikipedia

EmeraldCamera_Man · August 21, 2024, 11:08pm

I think we’re getting closer to the launch of volumetric lighting (PLEASE)

LvieReal · August 21, 2024, 11:14pm

Will stuff finally render behind transparent glass at some point?

Visuile · August 21, 2024, 11:15pm

My lights have a brightness is 5 in Compatibility. When I migrate, these lights give off a severe glow to all of the parts they’re being shined on. I can’t decrease the brightness, because then the effectiveness of the light is decreased.
What can I do about this?

BrucelWayneBatman · August 21, 2024, 11:18pm

As much as I love Compatibility I understand why this change was needed and I appreciate it that you guys created the new legacy version so classic style games can continue to exist accurately. Thanks for keeping us updated as always, looking forward to seeing some of the known issues with Compatibility’s replacement posted by others fixed.

abidbmt · August 21, 2024, 11:26pm

Really? I havent seen any good games that use compatibility in a while