A client-side virtual lantern mod for Fabric, giving your player configurable vanilla lantern carry visuals with localized dynamic light and no inventory item requirement.

Built for Minecraft 1.21.11. Waylight is client-side only and does not modify server-side gameplay.

Waylight includes:

Vanilla lantern and soul lantern rendering
Carry positions: right hip, left hip, and left hand
First-person and third-person lantern behavior
Procedural carry motion with configurable intensity
Light emission localized to the lantern rig via LambDynamicLights
Optional auto-equip in darkness and auto-unequip in brightness
Underwater extinguish behavior
Full Mod Menu + YACL configuration UI

If you encounter any issues, please report them here.

Controls

G: Toggle lantern on/off

Config Highlights

Lantern type: Lantern or Soul Lantern
Lantern position: Right Hip, Left Hip, or Left Hand
First-person light toggle
First-person hand motion: Physics or Static
Auto-light behavior with threshold (0-15)
Motion intensity slider (25%-200%)
Debug anchor gizmo toggle

Config is saved at config/waylight.json.

Requirements

Minecraft 1.21.11
Java 21+
Fabric Loader >=0.18.4
Fabric API
LambDynamicLights >=4.9.1+1.21.11
Optional: Mod Menu

Behavior Notes

Waylight is virtual and does not require a real lantern item.
In left-hand mode, the lantern suppresses if you are swimming or your offhand is occupied.
With Extinguish Underwater enabled, the lantern can remain visible while light output is disabled.
In first-person hip modes, the model is hidden by default; First-Person Light controls whether light remains active.