Ore ESP

Ore ESP is a Minecraft Bedrock Edition addon that helps players locate ores by displaying colored outlines around detected ore blocks.

The addon uses a custom entity rendering system to display ore outlines without modifying the original appearance of Minecraft blocks.

---

✨ Features

• 🔍 Automatic ore detection
• 🎨 Colored outlines for different ores
• 💎 Diamond Ore detection
• 🟢 Emerald Ore detection
• 🟡 Gold Ore detection
• ⚪ Iron Ore detection
• ⚫ Coal Ore detection
• 🔴 Redstone Ore detection
• 🔵 Lapis Ore detection
• 🟠 Copper Ore detection
• ⚪ Nether Quartz detection
• 🟤 Ancient Debris detection
• 🟡 Nether Gold Ore detection
• ⚙️ In-game configuration menu
• 🔄 Enable or disable individual ores
• 📦 Custom Ore ESP menu item
• 🚀 Lightweight scanning and rendering system
• 🧩 Separate Behavior Pack and Resource Pack architecture

---

⛏️ Supported Ores

Ore	Default Outline
Coal Ore	Black
Iron Ore	Light Gray
Gold Ore	Yellow
Diamond Ore	Blue
Emerald Ore	Lime
Lapis Ore	Blue
Redstone Ore	Red
Copper Ore	Orange
Nether Quartz Ore	White
Ancient Debris	Brown
Nether Gold Ore	Yellow

Both normal and deepslate variants are supported where applicable.

---

📦 Requirements

• Minecraft Bedrock Edition
• Minecraft Bedrock 1.26.33+
• Bedrock Script API

The addon is developed and tested against modern Minecraft Bedrock versions.

Older versions may not be supported.

---

📥 Installation

1. Download the latest release.
2. Import the Behavior Pack into Minecraft.
3. Import the Resource Pack into Minecraft.
4. Create a new world or edit an existing world.
5. Activate both the Behavior Pack and Resource Pack.
6. Enter the world.
7. The Ore ESP item will automatically be given to the player.

Both packs are required for the addon to work correctly.

---

🎮 Usage

After entering the world, you will receive the Ore ESP item.

Use the item to open the Ore ESP menu.

From the menu, you can configure which ores should be detected and highlighted.

When an enabled ore is detected within the scanning area, the addon creates a visual outline around the ore.

---

⚙️ How It Works

Ore ESP consists of two main components.

Behavior Pack

The Behavior Pack handles:

• Ore scanning
• Ore detection
• Entity spawning
• Entity removal
• Player data
• Ore configuration
• Color configuration
• Menu interaction
• Custom item
• Recipe

Resource Pack

The Resource Pack handles:

• Custom entity rendering
• Outline geometry
• Render controllers
• Outline materials
• Outline textures
• Custom item textures

The scanner detects blocks and creates a visual entity at the corresponding position.

The entity receives a color index which determines the outline texture used by the render controller.

Ore Block
    ↓
Ore Scanner
    ↓
Ore Registry
    ↓
Color Index
    ↓
Glow Block Entity
    ↓
Render Controller
    ↓
Colored Outline

---

## 🧩 Project Structure

```text
Ore-ESP/
│
├── BP/
│   ├── entities/
│   │   └── glowBlock.entity.json
│   │
│   ├── items/
│   │   └── ore_esp_menu.item.json
│   │
│   ├── recipes/
│   │   └── ore_esp_menu.recipe.json
│   │
│   └── scripts/
│       ├── core/
│       ├── data/
│       ├── ui/
│       └── main.js
│
├── RP/
│   ├── entity/
│   │   └── glowBlock.entity.json
│   │
│   ├── materials/
│   │   └── outline.material
│   │
│   ├── models/
│   │   └── glowBlock.geo.json
│   │
│   ├── render_controllers/
│   │   └── glowBlock.render_controller.json
│   │
│   └── textures/
│       ├── blocks/
│       │   └── outline/
│       │
│       └── items/
│           └── ore_esp_menu.png
│
├── README.md
├── LICENSE
└── .gitignore

---

## 🛠️ Development

Ore ESP is built for Minecraft Bedrock Edition using the Bedrock Script API.

The project is divided into two main parts:

### Behavior Pack

Handles the addon logic, including:

- Ore scanning
- Ore detection
- ESP entity management
- Player data
- Ore and color registries
- Menu interaction
- Custom item
- Recipe

### Resource Pack

Handles the visual system, including:

- ESP entity
- Outline geometry
- Render controller
- Outline material
- Outline textures
- Custom item texture

---

## 📁 Data System

Ore and color information are stored separately from the main scanner logic.

### Ore Registry

The ore registry contains:

- Minecraft block ID
- Ore name
- Texture index
- Outline color
- Enabled state

### Color Registry

The color registry maps each color to an index used by the render controller.

The indexes must remain synchronized between the Behavior Pack and Resource Pack.

---

## 📌 Version

**Current Version:** `1.0.0`

**Target Minecraft Version:** `1.26.33+`

---

## 📜 License

Copyright © 2026 Aizhu.

**All Rights Reserved.**

This project and its source code, assets, textures, models, and other associated files are proprietary.

Permission is granted to view the source code for personal and educational purposes.

Redistribution, re-uploading, modification and redistribution, commercial use, or reuse of the project's source code or assets in other projects is not permitted without explicit permission from the copyright holder.

See [`LICENSE`](LICENSE) for the complete terms.

---

## ⚠️ Disclaimer

Ore ESP is an independent Minecraft Bedrock addon.

Minecraft is a trademark of Mojang Studios and Microsoft.

This project is not affiliated with, sponsored by, or endorsed by Mojang Studios or Microsoft.

---

## 👤 Author

**Aizhu**

Minecraft Bedrock Addon Developer