Description
Gallery
Changelog
Versions
LightLevelOverlay
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
All Versions
+ Add Version
[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
### 🔧 Technical Changes
### 📋 Requirements
| Platform | Version |
|----------|---------|
| Minecraft | 1.21.3 |
| NeoForge | 21.3.95+ |
| Fabric Loader | 0.18.4+ |
| Fabric API | 0.114.1+ |
### 📦 Dependencies
## 🎨 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
ModMenuIntegrationclass for Fabric Mod Menu API - Added
modmenuentrypoint tofabric.mod.json - Added
logoFiletoneoforge.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
### 🔧 Technical Changes
### 📋 Requirements
| Platform | Version |
|----------|---------|
| Minecraft | 1.21.3 |
| NeoForge | 21.3.95+ |
| Fabric Loader | 0.18.4+ |
| Fabric API | 0.114.1+ |
### 📦 Dependencies
## 🎨 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
ModMenuIntegrationclass for Fabric Mod Menu API - Added
modmenuentrypoint tofabric.mod.json - Added
logoFiletoneoforge.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
### 🔧 Technical Changes
### 📋 Requirements
| Platform | Version |
|----------|---------|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.194+ |
| Fabric Loader | 0.16.10+ |
| Fabric API | 0.116.1+ |
### 📦 Dependencies
## 🎉 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
LightLogicclass for cleaner light level calculations - Extracted
LightCacheclass for optimized data storage - Removed legacy
SimpleConfigScreenin 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
### 🔧 Technical Changes
### 📋 Requirements
| Platform | Version |
|----------|---------|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.194+ |
| Fabric Loader | 0.16.10+ |
| Fabric API | 0.116.1+ |
### 📦 Dependencies
## 🎉 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
LightLogicclass for cleaner light level calculations - Extracted
LightCacheclass for optimized data storage - Removed legacy
SimpleConfigScreenin 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
#### Fixed
#### 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
configdirectory.
- 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
Shows light levels when
F9 is pressed (Toggle, rebindable in minecraft control settings)
