Legendary Herobrine

# Legendary Herobrine Mod v1.5.0 - Configuration & Enhanced Zombies Update

## 🎮 New Features

### ⚙️ Block Whitelist System

- **Server Configuration**: Administrators can now control exactly which blocks Herobrine can destroy

- **Dual Whitelists**: Separate configuration for mining AI and thrown pickaxe attacks

- **Performance Optimized**: Includes 1-minute caching system for better server performance

- **Safe by Default**: Automatically prevents breaking of bedrock, portals, command blocks, and other critical blocks

- **Easy Configuration**: Uses standard Minecraft block registry names (e.g., 'minecraft:stone')

### 🧟 Enhanced Zombie System

- **New Enemy Type**: Enhanced Zombies with configurable equipment

- **Customizable Tools**: Configure zombie weapons via server config:

  - Tool types: sword, axe, pickaxe, shovel, or hoe

  - Materials: wood, stone, iron, gold, diamond, or netherite

- **Smart AI**: Enhanced zombies retain all vanilla zombie behaviors plus new abilities

- **Loot System**: 10% chance to drop their equipped tool when defeated

- **Creative Mode**: New spawn egg for easy testing

### 🏗️ Zombie Tower Building AI

- **Intelligent Building**: Zombies now build towers to reach players above them

- **Fully Configurable**:

  - Enable/disable tower building behavior

  - Set block type for towers (default: cobblestone)

  - Maximum tower height (1-10 blocks)

  - Build chance and cooldown timers

- **Smart Detection**: Only builds when target is 2+ blocks above and within range

- **Realistic Behavior**: Places blocks beneath themselves and jumps to continue building

## 📋 Configuration Options

### Herobrine Configuration

```

herobrine.spawnsNaturally = false

herobrine.breakableBlocks = [list of blocks]

herobrine.pickaxeBreakableBlocks = [optional separate list]

```

### Enhanced Zombie Configuration

```

enhancedZombie.enabled = true

enhancedZombie.toolType = "sword"

enhancedZombie.toolMaterial = "iron"

enhancedZombie.towerBuildingEnabled = true

enhancedZombie.towerBlock = "minecraft:cobblestone"

enhancedZombie.towerMaxHeight = 5

enhancedZombie.towerBuildChance = 0.05

enhancedZombie.towerBuildCooldown = 40

```

## 🔧 Technical Improvements

- Added `BlockWhitelistHelper` utility class for centralized block permission checking

- Implemented proper caching system for configuration values

- Fixed deprecated ResourceLocation constructor usage

- Improved code organization with new utility package

## 🐛 Bug Fixes

- Fixed configuration file structure for proper category organization

- Resolved compilation issues with entity spawn methods

- Corrected import statements for server-side compatibility

## 📝 Default Block Whitelist

The default configuration allows Herobrine to break most common blocks including:

- All stone variants (stone, cobblestone, deepslate, granite, etc.)

- Dirt, grass, sand, gravel, clay

- All ore blocks (including deepslate variants)

- Netherrack, end stone, obsidian

- And many more common building/mining blocks

## 🎯 Balance Notes

- Enhanced zombies spawn with iron swords by default (configurable)

- Tower building has a 5% chance per tick when conditions are met

- Maximum tower height is limited to prevent excessive building

- All features can be disabled via configuration

## 📦 Installation

Simply place the mod file in your mods folder. Configuration file will be generated on first run at:

`config/legendaryherobrine-common.toml`

## 🔄 Compatibility

- Minecraft 1.20.1

- Forge 47.3.0+

- Server-side configuration sync

- Full multiplayer support

---

**Note**: This update focuses on giving server administrators more control over the mod's behavior while adding new challenging enemies to complement the Herobrine boss fight. All new features are optional and configurable!