promotional bannermobile promotional banner

Lightning Torch

Dynamic lighting for held torches

File Details

lightningtorch-2.0-Forge.jar

  • R
  • Jun 2, 2025
  • 13.24 KB
  • 1.7K
  • 1.21.5
  • Forge

File Name

lightningtorch-2.0-Forge.jar

Supported Versions

  • 1.21.5

Curse Maven Snippet

Forge

implementation "curse.maven:lightning-torch-1271946:6609264"
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

CHANGELOG – Version 2.0 (Forge)


New Features & Enhancements

  • Revised Lighting Method

    • Dynamic lighting is now injected directly into the light engine instead of placing a “light block” in the world.

    • This eliminates collisions and rendering issues caused by floating light blocks.

  • Separate Light Levels for Torches and Lanterns

    • Torch: adjustable light level range 0–16 (default: 14).

    • Lantern: adjustable light level range 0–20 (default: 15).

    • Allows precise control over how much light a held torch or lantern emits.

  • Commands for Adjusting Light Levels

    • /torchlight <0–16>

      • Sets the current light level emitted by the torch held in hand.

      • If run without arguments, displays the current torch light level.

    • /lanternlight <0–20>

      • Sets the current light level emitted by the lantern held in hand.

      • If run without arguments, displays the current lantern light level.


Bug Fixes

  • Fixed Water “Disappearing” Issue

    • In previous versions, the light block could interfere with water blocks, causing water to vanish or render incorrectly. By switching to direct light-engine injection, this issue no longer occurs.

  • Fixed Staircase Lighting Glitch

    • Earlier builds sometimes failed to restore correct lighting on stair blocks after the torch/lantern was put away, leading to uneven shadows or complete darkness on stairs. Now, the light engine naturally rebuilds block lighting, and the dynamic torch/lantern light is overlaid correctly.

  • Removed “Light Block” Creation

    • Older versions placed a special “light block” for dynamic lighting, which could conflict with mob pathfinding and redstone. Version 2.0 no longer creates any light block—dynamic lighting is handled entirely through light-engine modifications.


Additional Notes

  • Default Settings

    • Default torch light level: 14

    • Default lantern light level: 15

  • Command Ranges

    • /torchlight accepts values from 0 (no extra light) to 16 (maximum light).

    • /lanternlight accepts values from 0 to 20.

  • Upgrade Instructions

    1. Remove any old mod files (v1.x) from your mods/ folder.

    2. Download or compile the new v2.0 JAR for Forge.

    3. Place the v2.0 JAR into mods/ and restart your client/server.


Thank you for testing and reporting issues!