# Herobrine Returns

Experience true terror in Minecraft. Herobrine is back, and he's watching you.

## 🌫️ Overview

This isn't just another Herobrine mod with jump scares. This is a complete psychological horror experience that transforms Minecraft into a nightmare. Herobrine is an intelligent, persistent entity that learns, adapts, and grows more aggressive the longer you survive.

## 👁️ Core Features

### The Entity
- **Intelligent AI**: Herobrine doesn't just spawn randomly - he stalks you from the shadows
- **Two Modes**: Switches between Lurker (stalking/attacking) and Builder (creating structures)
- **Glowing Eyes**: Emissive textures make his white eyes visible in complete darkness
- **Dynamic Behavior**: Teleports when spotted, follows when you're not looking
- **Persistent Threat**: Respawns after 2-4 minutes, always returning

### 😱 Psychological Horror System

**Sanity Meter (0-100)**
- Decreases when near Herobrine
- Low sanity causes hallucinations, nausea, and fake Herobrine spawns
- Regenerates slowly when safe
- Below 30: Visual distortions and phantom entities
- Below 20: Complete mental breakdown

**Wrath System (Progressive Difficulty)**
- Increases from your actions (removing torches, destroying structures, etc.)
- Level 50+: More frequent spawns and aggressive behavior
- Level 100+: Environmental destruction intensifies
- Level 200+: Full fury mode - constant attacks and chaos
- Wrath affects damage dealt to you

### 🎯 Stalking Behaviors

**When You're Looking:**
- Teleports directly in front of you
- Triggers jump scares with screen effects
- Inflicts blindness, nausea, slowness, and knockback
- Plays terrifying scream sounds

**When You're Not Looking:**
- Silently follows at safe distance (12-35 blocks)
- Performs sneak attacks from behind
- Deals progressive damage based on wrath level
- Strikes every 30 seconds when close

### 🏚️ Environmental Manipulation

**Passive Haunting:**
- Removes torches in a 15-block radius
- Replaces normal torches with redstone torches
- Converts lanterns to soul lanterns
- Extinguishes candles mysteriously
- Makes tamed wolves growl and act disturbed

**Active Destruction:**
- Randomly steals items from your inventory
- Corrupts stone/dirt/grass into Netherrack
- Digs mysterious 2x2 tunnels underground
- Sets random fires near your base
- Blocks can disappear without warning

**Builder Mode:**
- Constructs small pyramids made of Netherrack
- Places redstone torches on top as markers
- Leaves structures as territorial warnings
- Only builds once per spawn cycle

### 📜 Ominous Signs

Herobrine leaves threatening messages on oak signs:
- "I am watching"
- "You can't escape"
- "Why did you come here?"
- "Stop building"
- "Leave now"
- "This is my world"
- "HEROBRINE"
- "I'm always behind you"
- "Don't look back"
- "You shouldn't be here"

### 🎁 Cursed Gifts

Occasionally places items in your inventory:
- Gunpowder
- Bones
- Rotten flesh
- Spider eyes
- Fermented spider eyes
- Phantom membranes

### 👻 Possessed Mobs

Herobrine can corrupt nearby entities:
- Zombies, Skeletons, Creepers, Spiders
- Even peaceful mobs: Cows, Pigs, Sheep
- Possessed mobs have:
- Custom name: "Possessed [Mob]"
- Permanent glowing effect
- Increased health (scales with wrath)
- More aggressive behavior

### 🛏️ Sleep Mechanics

**Bed Blocking:**
- Cannot sleep when Herobrine is within 50 blocks
- Warning message: "You cannot sleep, Herobrine is near..."
- Ender dragon-style sleep prevention

**Bed Watcher (20% chance):**
- Herobrine spawns near your bed at night
- Stands watching you attempt to sleep
- Disappears after 10 seconds
- Message: "You feel watched while sleeping..."

### ⛰️ Edge Push Mechanic

When near cliffs and Herobrine is close (15 blocks):
- 1% chance per tick to push you toward edges
- Detects 2+ block drops in all directions
- Violent knockback toward the cliff
- Message: "Something pushes you towards the edge!"
- Deals heavy sanity damage

### 🎵 Audio Design

**Custom Sounds:**
- Terrifying scream for jump scares
- Disturbing whispers in the darkness
- Ambient presence sounds
- Footsteps behind you
- All sounds use emissive audio system

### ⚙️ Technical Features

- **No Local Storage**: Works perfectly in claude.ai environment
- **Optimized Performance**: Smart loop limiting prevents lag
- **Fabric API**: Built for modern Minecraft versions
- **Server-Side Logic**: Works in multiplayer
- **Persistent Entity**: Herobrine doesn't despawn naturally

## 🎮 Gameplay Tips

- Stay in well-lit areas to maintain sanity
- Never look directly at Herobrine for too long
- Keep your wrath level low by avoiding destruction
- Sleeping is dangerous when he's near
- Possessed mobs are harder to kill - avoid when possible
- Low sanity = unreliable reality

## ⚠️ Warning

This mod is designed for psychological horror. Features include:
- Jump scares with sound and visual effects
- Persistent stalking entity
- Sanity-based hallucinations
- Environmental destruction
- Not recommended for young players or those sensitive to horror

## 📋 Requirements

- Minecraft 1.20+ (Fabric)
- Fabric API
- Fabric Language Kotlin (optional)

## 🔧 Configuration

Currently no config file - balanced for maximum horror experience out of the box.

---

**"He's always watching. He's always there. You just haven't seen him yet."**

"He's always watching. He's always there. You just haven't seen him yet."

Herobrine: The Watching