Bring dynamic lighting to your Minecraft Bedrock world with **LuminaCore** -

a completely original, modern implementation built from scratch by ZenoCraft.

## ✨ What is LuminaCore?

LuminaCore is a sophisticated dynamic lighting system that creates real-time

light blocks around light-emitting items and mobs. When you hold a torch,

lantern, or glowstone, the area around you lights up dynamically. Mobs like

glow squids and blazes emit light as they move through the world.

## 🎯 Key Features

### 🔦 Light Sources Supported

- **Torches & Soul Torches** (Light level 14/10)

- **Lanterns & Soul Lanterns** (Light level 15/10)

- **Glowstone & Amethyst Clusters** (Light level 15/5)

- **Glow Item Frames** (Light level 7)

- **Lava Buckets** (Light level 15)

- **Magma Blocks** (Light level 13)

- **Crying Obsidian** (Light level 8)

- **Cave Vines** (Light level 14)

- And more!

### 👹 Light-Emitting Mobs

- **Glow Squids** - Emit a gentle glow as they swim

- **Blazes** - Burn bright with intense light

- **Custom Mob Support** - Easily add your own light-emitting mobs

### ⚙️ System Features

- **Real-Time Updates** - Light follows you instantly

- **Multi-Dimensional** - Works in Overworld, Nether, and The End

- **Water Compatible** - Lights work underwater (configurable)

- **Auto Cleanup** - Removes lights when players die or disconnect

- **Performance Optimized** - Minimal lag, efficient resource usage

- **Scalable** - Add new light sources through configuration

## 🔧 Technical Details

### Architecture

- **100% Original Code** - Not based on existing addons, built from scratch

- **Modern ES6+ JavaScript** - Professional quality, well-documented

- **Modular Design** - Clean separation of concerns

- **Event-Driven System** - Proper event handling for all scenarios

### Module Structure

```

LuminaCore/

├─ Light Config API - Manage light source configurations

├─ Light Block System - Handle block placement physics

├─ Entity Light Manager - Control player & mob lighting

└─ Main Controller - System initialization & events

```

### Performance

- **Update Interval**: 40 ticks (2 seconds)

- **Optimized Block Placement**: Efficient caching & cleanup

- **Smart Entity Tracking**: Only updates active entities

- **Dimension Aware**: Respects height limits per dimension

## 📋 Compatibility

- **Minecraft Version**: 1.21.0+

- **Edition**: Bedrock Edition (Windows 10/11, Xbox One, Switch, Mobile)

- **API**: @minecraft/server 2.5.0+

- **Dependencies**: None - fully standalone addon

## 🚀 How It Works

1. **Item Detection** - System scans your mainhand and offhand items

2. **Light Calculation** - Determines appropriate light level

3. **Block Placement** - Places light blocks around you

4. **Real-Time Tracking** - Updates as you move

5. **Auto Cleanup** - Removes lights when source is gone

## 🎮 Installation

1. Download `luminacore_original.mcpack`

2. Open with Minecraft

3. Create/select a world

4. Add LuminaCore as a behavior pack

5. Play and enjoy dynamic lighting!

**Underwater lights not working?**

- By default, some items have `underwater: false`

- This is intentional for realism (torches go out underwater)

- Lava buckets and glowstone work underwater

## 📝 Version History

### v1.0.0 (Release)

- Complete original dynamic lighting system

- Support for 12+ light-emitting items

- Player and mob lighting

- Multi-dimensional support

- Full event system for cleanup

- Fully documented code

Built with care and precision for the Minecraft Bedrock community.

## 🌟 Why LuminaCore?

✅ **Completely Original** - Not a repackage or copy of existing code

✅ **Clean Code** - Professional architecture, fully documented

✅ **Performance First** - Optimized for minimal lag

✅ **Fully Configurable** - Easy to customize light sources

✅ **Active Support** - Built by ZenoCraft developers

✅ **Modern Design** - Uses contemporary JavaScript patterns

Perfect for survival mode players who want ambient lighting!

**Enjoy your journey with dynamic lighting in LuminaCore!** ✨

Lumina Core