Mods / Easy Light Levels

Category: #QoL #Utility
Author: stinky_lizard_
Side: Client
Created: Feb 14th 2022 at 6:08 AM
Last modified: Jul 19th at 12:52 AM
Downloads: 1278
Follow Unfollow 35

Latest file for v1.18.6:
easylightlevels.dll 1-click install

Easy Light Levels

Easy Light Levels is a small mod that allows you to quickly and easily view the light levels of the surrounding blocks.

By default torchlit blocks are highlighted green, sunlit blocks are highlighted yellow, and pitch black blocks are highlighted red, but these rules can be changed in the configuration file.

I made this mod to have a utility similar to the one in VSHUD, without all the extra stuff that VSHUD comes with while also being more flexible.


Enter '.lightlvl' as a command to toggle the highlights on and off.

Enter '.lightlvl radius' to get the current radius of the highlighted area. Enter '.lightlvl radius n' to change the radius to n.

Enter '.lightlvl update' to update the loaded mod configuration from the config file.

Enter '.lightlvl abort' to kill the current highlights, in case it's stuck and won't update.

Enter '.lightlvl help' to see the above in game.


You can assign a macro to .lightlvl to be able to toggle the overlay with a keystroke - simply press ctrl+m to open the macro editor.


Finally, check out the configuration file. All options have descriptions and the rules for light levels and colors can be changed.


Thanks to Novocain and DArkHekRoMaNT for the inspiration and reference!

Version For Game version Downloads Release date Changelog Download 1-click mod install*
v1.0.3 386 Jul 19th at 12:52 AM Show easylightlevels.dll Install now
v1.0.2 394 May 11th 2022 at 12:31 AM Show easylightlevels.dll Install now
v1.0.1 211 Mar 29th 2022 at 7:08 AM Show easylightlevels.dll Install now
v1.0.0 286 Feb 14th 2022 at 6:10 AM Show easylightlevels_1.0.0.dll Install now

12 Comments (oldest first | newest first)

💬 Kishmond, Aug 13th at 4:12 AM

Keenecraft It is created when you first load the game with the mod enabled. It's in [your AppData folder]/Roaming/VintagestoryData/ModConfig/EasyLightLevelsConfig.json

💬 Keenecraft, Aug 1st at 10:01 PM

What configuration file? I do not see one here or on Github

💬 stinky_lizard_Author, Jul 19th at 1:09 AM

Sorry about that, and sorry about the long wait. It's been quite the few weeks for me. I'm not really sure what happened... but it seems to work fine now. Let me know if it doesn't.

💬 Kishmond, Jul 11th at 2:59 AM

Here it is, let's see if Google Drive will let me share a .dll file. Since I don't know what's going on, it may not work for others. Guimoute

💬 Guimoute, Jun 29th at 12:48 PM

@Kishmond Would you like to share the version you compiled? I'd be happy to use that mod.

💬 Kishmond, Jun 11th at 5:29 PM

Well now I'm confused. I compiled the source code myself and it works without changes. Deleted that and went back to the version downloaded here and it didn't work.

💬 Kishmond, Jun 7th at 2:42 AM

This mod would be very useful for me, but it crashes the game in 1.18.5. I made an issue in GitHub with the log details.

💬 stinky_lizard_Author, May 11th 2022 at 12:29 AM

Fluffydreg, it doesn't show the exact light level. However, you can change the levels to be more specific by adding more rules in the Config.

This mod can't show you the light level numbers. You can see the light level of a block by enabling Developer Mode in the Interface tab of the settings, then enabling Extended Debug Info in the Developer tab, then pressing CTRL+F3. The top "Block V" value on the right seems to be the block light level of what you're looking at, and same for "Sun V."

This isn't meant for showing exact light levels. It's meant for showing where enemies can spawn and where they can't.

💬 Fluffydreg, Apr 25th 2022 at 12:47 AM

I'm confused, how do you tell what light level it's at? I only see the colours which tell me WHAT is lighting it; not the level it's at

💬 stinky_lizard_Author, Mar 29th 2022 at 7:11 AM

jaysus273, I'm surprised it isn't clientside only - I've set it to only load on the client side, so installing it on the server shouldn't do anything anyway...

fireztonez, thank you for the feedback! I didn't notice the light is based on the lower face of the block - I've fixed that in the new release. Sorry for the inconvenience.

I did think about the non-full blocks being highlighted, but I ultimately decided to highlight them because top half-slabs can still be spawned on! I don't think there's an easy (or efficient) way to determine if a block is "full" on the top side only, you can only get if it's a full 1x1m block or not...

Since non-full blocks can either spawn or not spawn drifters, I opted to highlight them because the alternative would mean not knowing if a top half-slab is spawnable. If you want, I could add it as a config option to remove the highlight on non-full blocks.

Finally, sorry for the radio silence... Between other games (Elden Ring in particular) and midterms I haven't had any time to check on this.

💬 fireztonez, Mar 27th 2022 at 3:26 AM

Nice and usefull thanks!

I dont think it is totally accurate due to the way it work to know where the drifters can spawn or not. First all blocks are highlighted, including the chests, bed, lower half-slab where mobs can't spawn on. But more importantly, if the lower face of the block is illuminated by a light source, all the block will be highlighted in green, even if on the top face it is pich black. This is without talking about block showed as Sunlit, where the sun clearly can't access at all.

My point here is not to say that the mod is not good or can't be usefull, but the way it work right now you have still have to be careful and not just trust what the mod show. If you build a house with 2 floors and the first floor is perfectly lit up, the second floor may show the floor totally green, even if it is not lit proprelly, and drifter may be able to spawn on that second floor (unless I don`t understand proprelly how spawn mecanic work on VS??)

💬 Jaysus273, Feb 20th 2022 at 6:05 PM

Looks like this doesn't work without being installed on the server too, could you possibly make it clientside only?

(edit comment delete)