
Vintage Story Mod DB · Vintage Story mod
Lumos
This mod is a comprehensive set of changes to block light and partial sunlight. 1) Directional Light. Vanilla block light worked like a liquid, allowing it to spread in all directions without control. Now, each light source emits light in a sphere, illuminat
Quick answer
Which Lumos release matches 1.22.3?
Lumos 1.0.1 targets 1.22.0, 1.22.1, 1.22.2. It must be installed on the client. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is Lumos required on the client, server, or both?
It must be installed on the client. Installation on the dedicated server is optional.
This release supports both sides, but the source does not require it on the server.
What else does Lumos 1.0.1 need?
1.0.1 on 1.22.3. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Lumos without breaking your instance.
Built for Lumos 1.0.1 on 1.22.3. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.0.1. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
It must be installed on the client. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.0.1. It opens that exact file at the source.
About this project
What does Lumos add?
This mod is a comprehensive set of changes to block light and partial sunlight.
1) Directional Light.
Vanilla block light worked like a liquid, allowing it to spread in all directions without control. Now, each light source emits light in a sphere, illuminating everything the beam hits. Each beam can bounce off a surface once. Each beam takes into account the absorption of blocks and their material. Glass and liquids transmit most of the light and reflect some. Other materials can reflect light like a matte surface. This takes into account chiseled blocks and their transmission along each axis.
2) Bug fixes
This mod also fixes a bunch of bugs found in the vanilla game. You can find more details here.
https://github.com/anegostudios/VintageStory-Issues/issues/7779
https://github.com/anegostudios/VintageStory-Issues/issues/9262
https://github.com/anegostudios/VintageStory-Issues/issues/5043
https://github.com/anegostudios/VintageStory-Issues/issues/7533
https://github.com/anegostudios/VintageStory-Issues/issues/3213
https://github.com/anegostudios/VintageStory-Issues/issues/2782
This mod puts a slightly higher CPU load than vanilla lighting. When measuring when mass-enabled lighting in the Archive, it will take four times longer. It's important to understand that lighting is only recalculated after placing or breaking blocks or light sources.
Light sources you've placed will have to be reinstalled, as their light is already "baked" into the chunk. Likewise, lighting in merchants and story locations may be baked and will only update when blocks or light changes.
When working with numerical blocks, lighting is not automatically recalculated. You must manually reposition any blocks or light sources nearby.
Automatically compatible with Stratum
Project description from Vintage Story Mod DB.
Pick your setup
Lumos releases for each Vintage Story version.
Choose the version and loader you play, then open the matching release.
1.22.5
1 loader build1.22.4
1 loader build1.22.3
1 loader build1.22.2
1 loader build1.22.1
1 loader build1.22.0
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Lumos versions and loaders
1.0.1
lumos_1.0.1.zip
1 Aug 2026
1.0.0
lumos_1.0.0.zip
1 Aug 2026
Looking for an older file? The official Vintage Story Mod DB project page is in Resources.