Dynamic Lights

_images/icon12.webp

A dropped torch item.

File location

/assets/minecraft/optifine/dynamic_lights.properties /assets/<MOD>/optifine/dynamic_lights.properties

Dynamic Lights allows hand-held and dropped light-emitting items, such as torches, to illuminate the blocks around them in the world.

_images/settings7.webp

Button and tooltip for the option, found in Video Settings ‣ Quality.

_images/cave.webp

An example of dynamic lighting; the held-item torch illuminates the blocks around the player, and the dropped glowstone item also does the same.

This configuration file allows mods to define dynamic light levels for entities and items.

Properties

entities

Values: String: entity:light_level
Optional

Entity light levels. The entity name is automatically expanded with the mod's ID, if applicable.

The light level should be between 0 and 15. For example: entities=basalz:15 blitz:7.

Important

This does not work for minecraft: entities.

items

Values: String: item:light_level
Optional

Item light levels. The item name is automatically expanded with the mod's ID, if applicable.

The light level should be between 0 and 15. For example: items=florb:15 morb:7.

Important

This does not work for minecraft: items.

JSON schema

Note

Although this page is .properties based, it can be mapped to JSON.

{
	"$schema": "http://json-schema.org/draft/2020-12/schema",
	"$id": "https://gitlab.com/whoatemybutter/optifinedocs/-/blob/master/schemas/dynamic_lights.schema.json",
	"title": "Dynamic Lights",
	"description": "Dynamic Lights allows hand-held and dropped light-emitting items such as torches to illuminate the blocks around them in the world.",
	"type": "object",
	"properties": {
		"entities": {
			"type": "string",
			"pattern": "(.*?:\\d{1,2}) ?",
			"description": "Entity light levels."
		},
		"items": {
			"type": "string",
			"pattern": "(.*?:\\d{1,2}) ?",
			"description": "Item light levels."
		}
	},
	"additionalProperties": false
}

Assumes the latest OptiFine version.
Updated to commit dc7b4aca.

Last update: 2024 March 13