Skip to content

Custom Light

You can customize the light level of all blocks.

NeoForge
Loaders
NeoForge
Downloads on Modrinth
798
Followers on Modrinth
0
versions
28
Updated
March 27, 2026Mar 27
Published
in 2026

At a glance

Runs on NeoForge
For Minecraft 1.21–1.21.11
Needed in the game and on the server
Latest version — 21.11.2 from March 27, 2026
License AGPL-3.0-only — free
Where it's needed
In gamerequiredOn serverrequired

Needed both in the game and on the server

Game versions1.21–1.21.11

NeoForge Minecraft

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:

EnvironmentFile PathFile Name
Client (when launching the game)Game root directory/configcustom_light_Client.toml
Server (when starting the server)Server root directory/configcustom_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.

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

License and source
GNU Affero General Public License v3.0 onlyfree to use and share; changes to the mod itself must be published under the same license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More