Custom Light
You can customize the light level of all blocks.
- Loaders
- NeoForge
- Downloads on Modrinth
- 798
- Followers on Modrinth
- 0
- versions
- 28
- Updated
- March 27, 2026Mar 27
- Published
- in 2026
At a glance
Needed both in the game and on the server
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" = 15Format Rules
- Configuration items must be written under the
[light]node; - Each line follows the format:
"namespace:block ID" = light level; - The light level ranges from 0 to 15 (0 = no light, 15 = maximum light);
- In theory supports all vanilla Minecraft blocks and mod-added blocks (correct namespace and block ID must be provided);
Notes
- After modifying the configuration file, restart the client/server for changes to take effect;
- Server configuration takes priority over client configuration, and the client configuration will be overwritten when joining the server;
- Do not fill in invalid block IDs, as this may cause configuration failure or game errors;
- 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.
FAQ
How to install Custom Light?
Install NeoForge for your Minecraft version, download Custom Light for the same version and loader, put the file into the mods folder and launch the game with the loader profile.
Which Minecraft versions does Custom Light support?
Custom Light has builds for Minecraft 1.21–1.21.11.
Is Custom Light needed on the server?
Needed in the game and on the server