DeathHead is a modern, intelligent death management plugin that creates interactive armor stand markers at death locations to preserve and restore player inventories. Unlike traditional death chest plugins, DeathHead uses a smart merge algorithm that prevents inventory loss when retrieving items.

## Key Features

### Smart Inventory Restoration
- **Intelligent Merge System**: Retrieves death items without overwriting your current inventory
- **Priority-Based Placement**: Restores items to original slots when possible, finds empty slots when occupied
- **Zero Item Loss**: Preserves both death items and items collected after death
- **Overflow Protection**: Drops excess items at your location if inventory is full

### Interactive Death Markers
- **Visual Death Heads**: Armor stand markers at death locations for easy identification
- **Player-Specific**: Only the owner can retrieve items from their death head
- **Glowing Effect**: Optional glowing effect for better visibility in dark areas
- **Particle Effects**: Visual feedback when death heads are removed

### ⏰ Automatic Expiration
- **Configurable Timer**: Set custom expiration time (default: 30 minutes)
- **Auto-Cleanup**: Expired death heads drop items and disappear automatically
- **Disable Option**: Set to 0 or negative to disable expiration entirely

### Persistent Storage
- **Server Restart Safe**: Death heads survive server restarts and crashes
- **Automatic Loading**: Restores all death heads when server starts
- **Smart Spawning**: Spawns death heads when players come online

### Complete Inventory Support
- Full inventory (36 slots), armor slots, offhand, and experience preservation

## Installation

1. Download the DeathHead-1.5.jar file
2. Place it in your server's `plugins` folder
3. Restart your server
4. Configure settings in `plugins/DeathHead/config.yml` (optional)

## Configuration

```yaml
# Expiration time in minutes (0 or negative to disable)
expiration-minutes: 30

# Visual effects
glowing-enabled: true
particles-enabled: true

# Customizable messages with color code support (&0-9, &a-f, &l, &m, &n, &o, &r)
messages:
death-head-created: "&7Your items are stored in a death head at your death location"
items-retrieved: "&aSuccessfully retrieved your items!"
not-your-death-head: "&cThis death head belongs to another player"
inventory-full: "&cYour inventory is too full to retrieve these items. Make some space first!"
death-head-expired: "&eYour death head has expired and items were dropped at the location"