Today, 19:02

Copy link

Ray's Dynamic Lighting

Go to files

🌟 Ray's Dynamic Lighting & Offhand Torch

Realistic Dynamic Lighting for Minecraft Bedrock Edition with Automatic Offhand Torch Support.

📖 Overview

Ray's Dynamic Lighting & Offhand Torch is a lightweight, high-performance Minecraft Bedrock Behavior Pack that brings immersive real-time lighting to your survival adventures.

Explore caves, mines, and the night with dynamic illumination from torches, lanterns, glowstone, and many other light-emitting items. The addon automatically equips supported light sources into your offhand, allowing you to continue mining or fighting while keeping your surroundings illuminated.

Designed to feel like a vanilla Minecraft feature while remaining highly optimized, multiplayer-friendly, and requiring no experimental gameplay.

✨ Features

🔦 Real-Time Dynamic Lighting

Light sources emit realistic dynamic lighting while held in the player's hand or offhand.

Supported Sources

Torch
Soul Torch
Lantern
Soul Lantern
Glowstone
Sea Lantern
Campfire
End Rod
Beacon
Jack o'Lantern
Shroomlight
Froglight
Redstone Torch
Redstone Block
Amethyst Cluster
Sea Pickle
Magma Block
Blaze Rod
Glow Berries
And many more...

🏮 Automatic Offhand Torch

Using a supported light source automatically equips it into the offhand, allowing players to:

Mine with a Pickaxe
Fight with a Sword
Build normally
Explore caves safely

All without manually switching items.

🥷 Sneak-to-Place

While sneaking, any supported light source held in the offhand can be placed directly into the world. The addon verifies successful placement before removing the item, preventing accidental item loss.

🌍 Dropped Item Lighting

Dropped light-emitting items continue producing light while on the ground.

Perfect for:

Cave exploration
Base decoration
Adventure maps
Multiplayer survival

👷 Miner Helmet Support

Custom helmets tagged with:

ray:miner_helmet

automatically emit maximum brightness while worn.

⚡ Performance Optimized

The addon has been designed for smooth gameplay.

Optimizations include:

Active light caching
Smart light updates
Dynamic property indexing
Minimal block updates
Automatic cleanup
Multiplayer optimization

No unnecessary world scans or permanent blocks are created.

🎮 Compatibility

Minecraft Bedrock Edition

Minimum Version

1.26.30

Script API

@minecraft/server 2.8.0

No experimental gameplay features are required.

📦 Installation

Import the .mcpack into Minecraft Bedrock Edition.
Activate the Behavior Pack in your world.
Ensure Script API is available (stable API).
Start your adventure.

🧩 Project Structure

offhand_torch_bp/
├── manifest.json
├── README.md
├── pack_icon.png
└── scripts/
    ├── main.js
    ├── dynamicLighting.js
    ├── offhandSwap.js
    ├── sneakPlace.js
    └── lightLevels.js

🔧 Technical Highlights

Dynamic light generated using invisible minecraft:light_block.
Automatic cleanup prevents leftover light blocks.
Multiple light levels (3–15) based on item brightness.
Optimized update engine minimizes block changes.
Dynamic property tracking improves performance.
Supports player-held, offhand-held, helmet, and dropped light sources.

🐞 Fixed Issues

Fixed offhand item deletion.
Fixed failed offhand writes caused by Bedrock's offhand restrictions.
Fixed sneak-place consuming unsupported items.
Fixed unnecessary light block updates.
Fixed global light cleanup on player leave.
Optimized active light tracking.
Improved multiplayer stability.

📈 Performance

✔ Lightweight
✔ Multiplayer Friendly
✔ Survival Friendly
✔ Stable Script API
✔ Optimized Tick Updates
✔ Automatic Memory Cleanup

👨‍💻 Developer

Chriz

Discord Username

chriz__3656

GitHub

https://github.com/chriz-3656

Community

https://skyrealm.fun

Discord Server

https://discord.gg/23TpMX5Mrj

❤️ Credits

Created and maintained by Chriz.

Special thanks to the Minecraft Bedrock scripting community and everyone who tested the addon and provided valuable feedback during development.

📜 License

You may not redistribute, modify, re-upload, sell, or republish this addon or any part of its source code without prior written permission from the author.