Custom Light

Overview

Custom Light allows players/server administrators to customize the light emission levels of in-game blocks. The light level of any block can be modified through a simple configuration file without altering core game files, supporting both client and server environments.

Configuration File Generation

The mod automatically generates corresponding configuration files based on the running environment, located as follows:
| Environment | File Path | File Name |
|------------------------|--------------------------|--------------------|
| Client (when launching the game) | Game root directory/config | custom_light_Client.toml |
| Server (when starting the server) | Server root directory/config | custom_light_Server.toml |

Configuration Synchronization

When a client joins a server with this mod installed, it will automatically synchronize the server's custom_light_Server.toml configuration file to ensure consistent block lighting effects between the client and server.

Configuration File Instructions

The default configuration files for the client and server are identical. Below is the default configuration example and format explanation:

# Custom Light config
# 格式: [light] 下方的 "命名空间:方块ID" = 亮度(0-15)
# Format: Under [light], "namespace:block ID" = light level (0-15)
[light]
"minecraft:torch" = 15
"minecraft:wall_torch" = 15

Format Rules

1. Configuration items must be written under the [light] node;
2. Each line follows the format: "namespace:block ID" = light level;
3. The light level ranges from 0 to 15 (0 = no light, 15 = maximum light);
4. In theory supports all vanilla Minecraft blocks and mod-added blocks (correct namespace and block ID must be provided);

Notes

1. After modifying the configuration file, restart the client/server for changes to take effect;
2. Server configuration takes priority over client configuration, and the client configuration will be overwritten when joining the server;
3. Do not fill in invalid block IDs, as this may cause configuration failure or game errors;
4. Due to the limitations of Minecraft's save file format, light levels greater than 15 may have unknown consequences, so do not attempt to set light levels above 15.