CurseForge · Minecraft mod
Custom Light
You can customize the light level of all blocks.
Quick answer
Which Custom Light release should I use?
Custom Light Custom_Light-1.21.2-Neoforge-21.2.0-beta-21.2.2.jar targets 1.21.2 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is Custom Light required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does Custom Light Custom_Light-1.21.2-Neoforge-21.2.0-beta-21.2.2.jar need?
Custom_Light-1.21.2-Neoforge-21.2.0-beta-21.2.2.jar. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Custom Light without breaking your instance.
Built for Custom Light Custom_Light-1.21.2-Neoforge-21.2.0-beta-21.2.2.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use Custom_Light-1.21.2-Neoforge-21.2.0-beta-21.2.2.jar. It targets 1.21.2 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside Custom_Light-1.21.2-Neoforge-21.2.0-beta-21.2.2.jar. It opens that exact file at the source.
About this project
What does Custom Light add?
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
- 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.
Project description from CurseForge.
Pick your setup
Custom Light by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.10
1 loader build1.21.9
1 loader build1.21.8
1 loader build1.21.7
1 loader build1.21.6
1 loader build1.21.5
1 loader build1.21.4
1 loader build1.21.3
1 loader build1.21.2
1 loader build1.21.1
1 loader build1.21
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Custom Light versions and loaders
Custom_Light-1.21.2-Neoforge-21.2.0-beta-21.2.2.jar
16 Mar 2026
Custom_Light-1.21.11-Neoforge-21.11.0-beta-21.11.2.jar
16 Mar 2026
Custom_Light-1.21.10-Neoforge-21.10.63-21.10.2.jar
16 Mar 2026
Custom_Light-1.21.9-Neoforge-21.9.0-beta-21.9.2.jar
16 Mar 2026
Custom_Light-1.21.8-Neoforge-21.8.9-21.8.2.jar
16 Mar 2026
Custom_Light-1.21.7-Neoforge-21.7.0-beta-21.7.2.jar
16 Mar 2026
Custom_Light-1.21.6-Neoforge-21.6.0-beta-21.6.2.jar
16 Mar 2026
Custom_Light-1.21.5-Neoforge-21.5.74-21.5.2.jar
16 Mar 2026
Custom_Light-1.21.4-Neoforge-21.4.121-21.4.2.jar
16 Mar 2026
Custom_Light-1.21.3-Neoforge-21.3.56-21.3.2.jar
16 Mar 2026
Custom_Light-1.21.1-Neoforge-21.1.1-21.1.2.jar
16 Mar 2026
Custom_Light-1.21.0-Neoforge-21.0.143-21.0.3.jar
16 Mar 2026
Looking for an older file? The official CurseForge project page is in Resources.