# Aura BlockFill

Automatically regenerate mining areas while protecting your server with configurable SafeZones.

Aura BlockFill is a production-ready Hytale plugin that allows server owners to create protected mining regions that automatically regenerate over time. Players can freely mine inside designated areas while the surrounding environment remains protected from griefing and unwanted modifications.

Designed for Prison, Survival, RPG, Factions and Hub servers, Aura BlockFill provides a simple in-game configuration workflow without requiring complex configuration files.

---

# Features

## Automatic Mine Regeneration

- Create fully configurable mining regions.
- Automatically regenerate blocks after a configurable timer.
- Weighted random block generation.
- Fully automatic regeneration cycle.

## Safe Zones

Protect important areas from griefing.

- Prevent block breaking.
- Prevent block placement.
- Prevent unwanted interactions.
- Fill regions remain mineable while still being protected by the surrounding SafeZone.

## In-Game Region Selection

Configure everything directly inside the game.

- Select Fill Zones.
- Select Safe Zones.
- No external editors required.

## Visual Fill Configuration

Instead of editing percentages manually, simply open the Fill Chest and place the blocks you want to generate.

The amount of each block inside the chest determines its generation weight automatically.

Example:

- 64 Stone
- 16 Iron Ore
- 4 Diamond Ore

Stone will naturally generate much more frequently than Diamond.

## Automatic Player Safety

Before regeneration starts:

- Players inside the mining region are detected.
- Players are moved to a safe location.
- The mine regenerates instantly.
- Prevents players from being trapped inside regenerated blocks.

## Configurable Announcements

Customize:

- Regeneration interval
- Warning messages
- Countdown
- Chat messages
- Labels
- Prefixes

Everything is configurable through JSON.

## Persistent Storage

All regions and configured blocks are automatically saved.

Uses atomic file writing to reduce the risk of data corruption.

---

# Commands

| Command | Description |
|---------|-------------|
| `/aurablock` | Show help |
| `/aurablock fill` | Start Fill Zone selection |
| `/aurablock safezone` | Start SafeZone selection |
| `/aurablock confirm` | Confirm current selection |
| `/aurablock cancel` | Cancel current selection |
| `/aurablock fillchest` | Open the Fill Chest configuration |
| `/aurablock disclaim` | Remove all configured regions |

---

# Typical Workflow

1. Create a SafeZone.
2. Create a Fill Zone inside it.
3. Open the Fill Chest.
4. Place the blocks you want to generate.
5. Done.

Players can immediately begin mining while the plugin automatically handles protection and regeneration.

---

# Configuration

Aura BlockFill provides configurable options including:

- Regeneration interval
- Warning countdown
- Safe teleport height
- Chat messages
- GUI labels
- Plugin prefix
- Block variants

No code changes are required.

---

# Perfect For

- Prison Servers
- Survival Servers
- RPG Servers
- Factions
- Hub Mining Areas
- Resource Worlds
- Public Mines

---

# Current Features

- Automatic mine regeneration
- SafeZone protection
- Weighted random block generation
- Virtual Fill Chest configuration
- Automatic player evacuation before regeneration
- Configurable announcements
- Persistent storage
- In-game region selection
- Production-ready architecture

---

# Planned Features

Future updates may include:

- Multiple independent mining regions
- Selection wand tool
- Native teleport implementation
- Visual particle and sound effects during regeneration

---

# Why Aura BlockFill?

Unlike traditional mine reset plugins that rely on complex configuration files, Aura BlockFill focuses on simplicity and in-game administration.

Configure everything visually, protect your world from griefing, and keep your mining areas automatically regenerated with minimal setup.

Built specifically for Hytale and designed to evolve alongside future SDK updates.