Skip to content

Light Profiles

Scotticles edited this page Nov 4, 2026 · 7 revisions

Overview

MC Engine's Light Profiles system allows you to create and switch out sets of Lights in real time to allow for more dynamic world lighting and region-based loading for extra performance.

Light Profile Editor UI Screenshot

Default Profile

All worlds start with a default Light Profile named "lights" (saved as "lights.json). This profile is automatically and created when the world is first created (or joined with MC Engine installed) and all lights made will save to this profile unless another is manually created and loaded.

Auto Saving And Loading

When leaving the world or stopping the server, all lights currently loaded will save to the currently opened Light Profile. When you rejoin the world or start the server again, that same Light Profile will load, allowing you to continue right where you left off.

Custom Profiles

Custom Light Profiles only have a Name parameter. The name parameter is how you'll interact with custom Light Profiles within the Light Profile Editor.

Saving

Custom Light Profiles can be created or saved to by inputting the name of the profile you want to interact with into the name text box under Light Profile Editing in the Light Profile Editor and clicking the save button under the same header. If a Light Profile exists with the chosen name, all Lights currently loaded in the world will be saved to a file with the same name. If a Light Profile with the chosen name doesn't exist, a new file will be created with the same name and all currently loaded Lights will be saved to it. If the file or directory is for any reason not accessible, the Light Profile will not save and an error message will be send to all players with the Engine UI currently open. An empty name cannot be used for the Light Profile.

Loading

After creating a custom Light Profile, the profile can be later loaded by entering the name of the profile you wish to load into text box under Light Profile Editing in the Light Profile Editor and clicking the load button under the same header. If a Light Profile exists with the chosen name, all Lights from that profile will be loaded and the Light Profile Editor's current profile text will update to show the newly loaded Light Profile. If a Light Profile doesn't exist by the chosen name, an error message will be sent to all players with the Engine UI currently open and the currently loaded Light Profile will remain open. An empty name cannot be used for the Light Profile.

Commands & Region Interaction

Light Profiles can be saved and loaded using a custom command, "/ligthprofile". This command takes two parameters: {action} and {profileName}. The action parameter can be either Save or Load and will function the same as the Save and Load buttons within the Light Profile Editor. The profileName works the same as the name parameter in the Light Profile Editor and can be any valid String with no spaces. This command also allows light profiles to be changed on Region enter or exit. The command needs to be run as a player, so if you want to use the command in the enter or exit commands of a Region, run the command from within an execute command as the nearest player. An example could look like this: "/execute as @p run lightprofile load lights".

Navigation

Fully Implemented Features

Work In Progress Features

Not Started Features

Sequences

Decals

Engine Modularity

Clone this wiki locally