
# VoltNetworks Premium Crates Add-on
Created by rapidfawn2489 (VoltNetworks Addons)

## Description
A comprehensive crate system for Minecraft Bedrock Edition featuring placeable crates, holograms, custom animations, and a full in-game admin UI.

## Features
- **Placeable Crates**: Use custom blocks for Common, Rare, Epic, and Legendary crates.
- **Holograms**: Floating text above crates indicates type and instructions.
- **Admin UI**: Easily manage crate types, settings, and rewards without config files.
- **Key System**: Optional key requirements for crates.
- **Animations**: Visual and sound effects when opening crates.

## Installation
1. Import the Behavior Pack (.mcpack) and Resource Pack (.mcpack).
2. Activate both packs in your world settings.
3. Enable "Beta APIs" and "Holiday Creator Features" (if required for blocks) in Experiments.
   - *Note: This add-on uses the stable Script API 1.16.0+, ensure your Minecraft version is compatible.*

## How to Use

### For Admins
1. **Get Access**: Tag yourself as an admin: `/tag @s add admin` OR be an Operator.
2. **Open Admin Menu**: Type `!crateadmin` in chat.
3. **Manager Crates**: Use the UI to create new crate types or edit existing defaults.
4. **Place Crates**: Get the crate block from the creative inventory (switch on "Operator" tab or search "Crate") or use `/give @s volt:crate_common`.
5. **Add Rewards**: In the Admin UI, select a crate -> Manage Rewards -> Add Reward (hold the item you want to add).

### For Players
1. **Find a Crate**: Look for crate blocks with holograms.
2. **Open**: Interact (Right-click/Tap) the crate to preview rewards.
3. **Unlock**: If you have the required key, click "Open Crate" to receive rewards with an animation.

## Commands
- `!crateadmin`: Opens the Admin Panel (Admin/Op only).

## Troubleshooting
- **Missing Textures**: ensure the Resource Pack is at the top of the list.
- **No UI**: ensure "Beta APIs" experiment is enabled.
