Back to mods
Custom Light project artwork

CurseForge · Minecraft mod

Custom Light

You can customize the light level of all blocks.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Custom Light release should I use?

Updated 6 months ago
Latest stable file Custom_Light-1.21.2-Neoforge-21.2.0-beta-21.2.2.jar
Game version 1.21.2
Loader NeoForge

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 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?

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:

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.

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.

12 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Custom Light versions and loaders

28 of 28 releases match

Looking for an older file? The official CurseForge project page is in Resources.