Compatibility
Minecraft: Java Edition
Platforms
Supported environments
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Links
Creators
Details
Light Level 2025
Press F9 to see the block light levels.
Inspired by LightLevel By parzivail, with some improvements implemented.
Dependencies
You can find the dependencies in the description of each release.
-
Fabric Loader
Download from fabricmc.net -
Fabric API
Download from modrinth
View source on GitHub
Features
Dimension-Specific Color Coding
The colors used to represent the light levels can be customized in config/light-level-2025.yaml
as
hex color codes.
Overworld
-
Hostile mobs cannot spawn
- color: green
- conditions:
- block light >= 1
- config field:
text.color.safe
-
Hostile mobs can spawn at night
- color: yellow
- conditions:
- block light = 0
- sky light >= 8
- config field:
text.color.warning
-
Hostile mobs can always potentially spawn
- color: red
- conditions:
- block light = 0
- sky light <= 7
- config field:
text.color.danger
The Nether
-
Mobs cannot spawn
- color: green
- conditions:
- block light >= 12
- config field:
text.color.safe
-
Mobs can always potentially spawn
- color: red
- conditions:
- block light <= 11
- config field:
text.color.danger
The End
-
Mobs cannot spawn
- color: green
- conditions:
- block light >= 1
- config field:
text.color.safe
-
Mobs can always potentially spawn
- color: red
- conditions:
- block light = 0
- config field:
text.color.danger
Adjustable Text Height
If a block that doesn't have a collision box is above the target block and its appearance obstructs the text, the light level will be shown above its visual.
Debug Mode
Press F3 to show both the block light and the sky light levels.
Technical Features
Block Exclusion Conditions
The rendering on a target block will be skipped if:
-
The target block is one of the following (config field:
block.blacklist
):minecraft:air
minecraft:barrier
minecraft:bedrock
minecraft:chain_command_block
minecraft:command_block
minecraft:end_portal
minecraft:nether_portal
minecraft:repeating_command_block
-
The target block is not opaque and visually transparent.
- Examples Excluded:
minecraft:glass
minecraft:ice
- Examples Not Excluded:
minecraft:glowstone
minecraft:packed_ice
- Examples Excluded:
-
The target block does not have a full square top surface.
- Examples Excluded:
- bottom slabs
- right-side-up stairs
- Examples Not Excluded:
- top slabs
- up-side-down stairs
- Examples Excluded:
-
A block above the target block has a collision shape.
- Examples Excluded:
minecraft:ladder
minecraft:snow
(layers count >= 2)
- Examples Not Excluded:
minecraft:vine
minecraft:snow
(layers count = 1)
- Examples Excluded:
Caching
This mod caches information about block positions and the text to be rendered, storing it in memory for faster access.
By setting the cache update frequency in frames, the update rate automatically adjusts based on FPS — updating more frequently in high-FPS environments and less frequently in low-FPS environments.
You can change the update frequency via cache.update_interval_frames
in the config file.
Rendering Culling
This mod does not render the light level for a target block that is invisible to the player.
Configuration
You can customize the mod behavior via config/light-level-2025.yaml
.
-
render_distance
horizontal
: Maximum horizontal distance for rendering- Default:
16
- Default:
vertical
: Maximum vertical distance for rendering- Default:
4
- Default:
-
block
blacklist
: Blocks to exclude from rendering- Default:
minecraft:air
minecraft:barrier
minecraft:bedrock
minecraft:chain_command_block
minecraft:command_block
minecraft:end_portal
minecraft:nether_portal
minecraft:repeating_command_block
- Default:
whitelist
: Blocks to include in rendering- Default:
minecraft:mud
minecraft:slime_block
minecraft:soul_sand
- Default:
-
text
color
:safe
: Light level where hostile mobs cannot spawn- Default:
40FF40
- Default:
warning
: Light level where hostile mobs can spawn at night in Overworld- Default:
FFFF40
- Default:
danger
: Light level where hostile mobs can always potentially spawn- Default:
FF4040
- Default:
neutral
: Display color for unknown or unsupported dimensions- Default:
FFFFFF
- Default:
scale
:normal
: Text size for normal state- Default:
0.03125
- Default:
debug
: Text size for debug screen- Default:
0.020833334
- Default:
offset_y_base
: Height to offset the text from the block- Default:
0.1
- Default:
-
cache
update_interval_frames
: Frequency in frames to update the block cache- Default:
20
- Default: