# 🌟 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

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

1. Import the `.mcpack` into Minecraft Bedrock Edition.
2. Activate the Behavior Pack in your world.
3. Ensure Script API is available (stable API).
4. 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.

---

# 🚀 Version

## v1.0.0

### Initial Release

### Features

- Dynamic Lighting
- Automatic Offhand Torch
- Sneak-to-Place
- Dropped Item Lighting
- Miner Helmet Support
- Multiple Light Levels
- Multiplayer Compatibility
- Performance Optimizations
- Stability Improvements

---

⭐ Thank you for downloading **Ray's Dynamic Lighting & Offhand Torch**!

If you enjoy this addon, consider supporting the project by sharing it with your friends and joining the SKY REALM community.

Happy Mining! ⛏️🔥