Description

Gallery

Changelog

Versions

LightLevelOverlay

Name: Light Level Overlay
Author: Nesuwu

Shows light levels on blocks. That is it. That is the mod.

Features

Numbers on blocks so you can see exactly where mobs can spawn
Color coded: Red (0), Yellow (1-7), Green (8+)
Renders above foliage so you do not have to squint through grass
Hides behind walls and only shows what you can actually see
Fast, cached and optimized so it will not tank your FPS
Underwater mode for drowned spawn prevention

Platforms

Works on both Fabric and NeoForge.

Controls

Key	Action
F9	Toggle overlay
F10	Open config

Config

Press F10 or edit config/lightleveloverlay-client.json

Range: How far to scan (horizontal/vertical)
Update Interval: Cache refresh rate in ms
Colors: Customize the RGB values
Show Only Spawnable: Hide safe blocks, show only danger zones
Text Scale: Make numbers bigger or smaller
Underwater Mode: Show light levels in water

Installation

Install Fabric or NeoForge for Minecraft 1.21.1
Install Architectury API for your loader
Install Cloth Config for your loader
Drop the jar in your mods folder
Done

Dependencies

Architectury API (required)
Cloth Config (required)
Fabric API (required for Fabric only)

Credits

Inspired by Light Level 2025 by dark-lion-jp. This is a standalone implementation, not a port, not affiliated. Bug reports go here, not there.

License

MIT

How to Install Light Level Overlay (Mod)

Light Level Overlay by Nesuwu is verified for Fabric, Neoforge across Minecraft versions 1.21.1, 1.21.10, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8 (latest release: 1.3.0, file size: 37 KB). Follow the steps below to install it safely from ModCraft.tv:

Click the Download button above and select your Minecraft version (1.21.1, 1.21.10, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8) and platform (Fabric, Neoforge).
Make sure you have the compatible loader or environment installed for Fabric, Neoforge.
Move the downloaded Light Level Overlay file into your Minecraft .minecraft/mods folder and launch the game.

All Versions

+ Add Version

Game Version

Mod Loader

Release Channel

Name	Game version	Platforms	Published	Downloads	Actions
R Light Level Overlay 1.3.0 [Fabric - 1.21.3]	1.21.3	Fabric	10mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.3.0 [NeoForge - 1.21.3]	1.21.3	Neoforge	10mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.3.0 -[NeoForge - 1.21.1]	1.21.1	Neoforge	10mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.3.0 - [Farbic - 1.21.1]	1.21.1	Fabric	10mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.2.0	1.21.1	Neoforge	10mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.1.3	1.21.1	Neoforge	11mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.6.0	1.21.x	Neoforge	11mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.5.0	1.21.x	Neoforge	11mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.4.0	1.21.5	Neoforge	11mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.2.0	1.21.x	Neoforge	11mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.1.2	1.21.1	Neoforge	11mo ago	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.1.0	1.21.1	Neoforge	last yr.	1	Download Open in new tab Copy link Report
R Light Level Overlay 1.0.0	1.21.1	Neoforge	last yr.	1	Download Open in new tab Copy link Report

[1.3.0] Light Level Overlay 1.3.0 [Fabric - 1.21.3] by Nesuwu on Jan 14, 2026

Download

# Light Level Overlay 1.3.0

## 🎨 Mod Menu Integration & Quality of Life

This release adds proper Mod Menu integration and finally adds features from 1.21.1 to 1.21.3.

### ✨ What's New

Mod Icon** - Custom icon now appears in mod lists (Fabric & NeoForge)
Mod Menu Config Button** - Config screen accessible via hover button in Mod Menu (Fabric)

### 🔧 Technical Changes

Added ModMenuIntegration class for Fabric Mod Menu API
Added modmenu entrypoint to fabric.mod.json
Added logoFile to neoforge.mods.toml
Added TerraformersMC maven repository for Mod Menu dependency

### 📋 Requirements

| Platform | Version |
|----------|---------|
| Minecraft | 1.21.3 |
| NeoForge | 21.3.95+ |
| Fabric Loader | 0.18.4+ |
| Fabric API | 0.114.1+ |

### 📦 Dependencies

Cloth Config** (required on both platforms)
Architectury API** (required on both platforms)
Mod Menu** (optional, recommended for Fabric)

Thanks for using Light Level Overlay! Report issues on [GitHub](https://github.com/nesuwu/llo).*

[1.3.0] Light Level Overlay 1.3.0 [NeoForge - 1.21.3] by Nesuwu on Jan 14, 2026

Download

# Light Level Overlay 1.3.0

## 🎨 Mod Menu Integration & Quality of Life

This release adds proper Mod Menu integration and finally adds features from 1.21.1 to 1.21.3.

### ✨ What's New

Mod Icon** - Custom icon now appears in mod lists (Fabric & NeoForge)
Mod Menu Config Button** - Config screen accessible via hover button in Mod Menu (Fabric)

### 🔧 Technical Changes

Added ModMenuIntegration class for Fabric Mod Menu API
Added modmenu entrypoint to fabric.mod.json
Added logoFile to neoforge.mods.toml
Added TerraformersMC maven repository for Mod Menu dependency

### 📋 Requirements

| Platform | Version |
|----------|---------|
| Minecraft | 1.21.3 |
| NeoForge | 21.3.95+ |
| Fabric Loader | 0.18.4+ |
| Fabric API | 0.114.1+ |

### 📦 Dependencies

Cloth Config** (required on both platforms)
Architectury API** (required on both platforms)
Mod Menu** (optional, recommended for Fabric)

Thanks for using Light Level Overlay! Report issues on [GitHub](https://github.com/nesuwu/llo).*

[1.3.0] Light Level Overlay 1.3.0 -[NeoForge - 1.21.1] by Nesuwu on Jan 09, 2026

Download

# Light Level Overlay 1.3.0

## 🎉 Now Available on Both Fabric and NeoForge!

This release brings **multiplatform support** with a complete rewrite using the Architectury framework.

### ✨ What's New

Fabric Support** - The mod now runs on Fabric with Fabric API
NeoForge Support** - Full compatibility with NeoForge 21.1+
Unified Codebase** - Single source for both platforms, fewer bugs
Cloth Config** - Beautiful, modern configuration UI on both platforms

### 🔧 Technical Changes

Migrated to **Architectury** multiplatform framework
Extracted LightLogic class for cleaner light level calculations
Extracted LightCache class for optimized data storage
Removed legacy SimpleConfigScreen in favor of Cloth Config
Code cleanup and optimization

### 📋 Requirements

| Platform | Version |
|----------|---------|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.194+ |
| Fabric Loader | 0.16.10+ |
| Fabric API | 0.116.1+ |

### 📦 Dependencies

Cloth Config** (required on both platforms)
Architectury API** (required on both platforms)

Thanks for using Light Level Overlay! Report issues on [GitHub](https://github.com/nesuwu/llo).*

[1.3.0] Light Level Overlay 1.3.0 - [Farbic - 1.21.1] by Nesuwu on Jan 09, 2026

Download

# Light Level Overlay 1.3.0

## 🎉 Now Available on Both Fabric and NeoForge!

This release brings **multiplatform support** with a complete rewrite using the Architectury framework.

### ✨ What's New

Fabric Support** - The mod now runs on Fabric with Fabric API
NeoForge Support** - Full compatibility with NeoForge 21.1+
Unified Codebase** - Single source for both platforms, fewer bugs
Cloth Config** - Beautiful, modern configuration UI on both platforms

### 🔧 Technical Changes

Migrated to **Architectury** multiplatform framework
Extracted LightLogic class for cleaner light level calculations
Extracted LightCache class for optimized data storage
Removed legacy SimpleConfigScreen in favor of Cloth Config
Code cleanup and optimization

### 📋 Requirements

| Platform | Version |
|----------|---------|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.194+ |
| Fabric Loader | 0.16.10+ |
| Fabric API | 0.116.1+ |

### 📦 Dependencies

Cloth Config** (required on both platforms)
Architectury API** (required on both platforms)

Thanks for using Light Level Overlay! Report issues on [GitHub](https://github.com/nesuwu/llo).*

[1.2.0] Light Level Overlay 1.2.0 by Nesuwu on Dec 24, 2025

Download

### 1.2.0

#### Added

Underwater mode for drowned spawn prevention (Issue #2)
Enable in config (F10 → Underwater tab)
Three display modes: Floor, Surface, Both (auto-switches based on player position)
Customizable underwater color (default: orange for visibility)

#### Fixed

Replaced deprecated hasChunkAt() with isLoaded()
Removed unused imports and fields

[1.1.3] Light Level Overlay 1.1.3 by Nesuwu on Nov 25, 2025

Download

## 1.1.3

Added
No rendering when underwater or in lava
Improved
Cleaner codebase for easier maintenance across versions
Technical
Separated scanning logic into pure Java classes
Render stage changed to AFTER_CUTOUT_BLOCKS

[1.6.0] Light Level Overlay 1.6.0 by Nesuwu on Nov 23, 2025

Download

### 1.6.0

Added**
Support for 1.21.9 - 1.21.10

[1.5.0] Light Level Overlay 1.5.0 by Nesuwu on Nov 23, 2025

Download

### 1.5.0

Added**
Support for 1.21.6 - 1.21.8

[1.4.0] Light Level Overlay 1.4.0 by Nesuwu on Nov 22, 2025

Download

### 1.4.0

Added**
Support for 1.21.5

[1.2.0] Light Level Overlay 1.2.0 by Nesuwu on Nov 22, 2025

Download

### 1.2.0

Added**
Support for 1.21.3 - 1.21.4

[1.1.2] Light Level Overlay 1.1.2 by Nesuwu on Nov 22, 2025

Download

### 1.1.2

Fixed**
[File mods/lightleveloverlay-1.1.1.jar is not a valid mod file](https://github.com/nesuwu/llo/issues/1) crashing the game. The culprit was a missing file in the release file. Sorry for the little screw-up!

[1.1.0] Light Level Overlay 1.1.0 by Nesuwu on Aug 08, 2025

Download

### 1.1.0

Added**
Light level overlay** rendered on top-facing solid surfaces within a configurable radius.
Keybinds**: open config (F10).
In‑game configuration UI** (Cloth Config):
Horizontal range (1–128)
Vertical range (1–64)
Update interval (16–2000 ms)
Colors for 0, 1–7, and safe (≥8)
Show only spawnable (0–7)
Text scale (0.015–0.06)
JSON config** with safe clamping and legacy flag migration; auto‑created in the standard config directory.

Performance**
Caching with configurable refresh interval.
Scans only topmost valid surfaces (solid block with air above) in the search column.

Compatibility**
Cloth Config is used for the in‑game settings screen. (Yeah, the dependency free idea got scrapped really quick.)

Bugs**
The change in the rendering method caused a bug where some blocks dont show the light level - Working on a hotfix ASAP

[1.0.0] Light Level Overlay 1.0.0 by Nesuwu on Jul 31, 2025

Download

A very bare bones release.

Shows light levels when F9 is pressed (Toggle, rebindable in minecraft control settings)

Light Level Overlay

LightLevelOverlay

Features

Platforms

Controls

Config

Installation

Dependencies

Credits

License

How to Install Light Level Overlay (Mod)

All Versions

No compatible versions found

🌟 Related Projects

AutoModpack

Geckolib

Cobblemon Info for REI / JEI / EMI

Loot Beams: Refork