# ArkLife - Lifesteal Plugin for Minecraft 1.16.5

A complete lifesteal plugin where players gain and lose hearts in combat!

## Features

### Lifesteal System
- **Player Death** : Automatically loses 1 heart (absolute priority)
- **Heart Drop** : A heart is dropped on the ground after the loss
- **Heart Usage** : Right click to gain 1 heart
- **PvP Kill** : The killer automatically gains 1 heart

### Security Features
- ✅ Configurable minimum hearts (1 by default)
- ✅ Configurable maximum hearts (20 by default)
- ✅ Automatic data saving
- ✅ Configurable permissions

## ️ Installation

1. **Requirements** : Minecraft 1.16.5 server with Spigot/Paper
2. **Compilation** : Compile the plugin with your Java IDE
3. **Installation** : Place the `.jar` file in `plugins/`
4. **Restart** : Restart your server
5. **Configuration** : Modify `plugins/ArkLife/config.yml` if necessary

## Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/arklife` | Display help | `arklife.admin` |
| `/arklife reload` | Reload configuration | `arklife.admin` |
| `/arklife hearts <player>` | View player's hearts | `arklife.admin` |
| `/arklife give <player> <amount>` | Give hearts | `arklife.admin` |
| `/arklife remove <player> <amount>` | Remove hearts | `arklife.admin` |

**Aliases** : `/ls`, `/life`, `/lifesteal`, `/al`

## Permissions

- `arklife.admin` - Administrator commands (OP by default)
- `arklife.use` - Use hearts (all players by default)

## ⚙️ Configuration

```yaml
# Maximum number of hearts (40 = 20 full hearts)
max-hearts: 40

# Minimum number of hearts (2 = 1 full heart)
min-hearts: 2

# Default hearts for new players
default-hearts: 20

# Enable heart drop on death
drop-heart-on-death: true

# Heart item name (color codes supported)
heart-name: "&c❤ Life Heart"
```

## Usage

1. **New player** : Starts with 10 hearts (configurable)
2. **PvP Combat** : Kill a player = +1 heart, die = -1 heart
3. **Heart item** : Nether Star with special name
4. **Usage** : Right click with the heart to use it
5. **Limits** : Minimum 1 heart, maximum 20 hearts (configurable)

## File Structure

```
plugins/ArkLife/
├── config.yml # Main configuration
├── hearts.yml # Hearts data (auto-generated)
└── ArkLife.jar # Main plugin
```

## Support

- **Minecraft Version** : 1.16.5 - Latest
- **Bukkit API** : 1.16
- **Supported Servers** : Spigot, Paper, and derivatives

## Important Notes

- Data is automatically saved
- Player loses their heart BEFORE the heart is dropped (absolute priority)
- Compatible with protection plugins (WorldGuard, etc.)
- Performance optimized

---

**Developed by ArkLandia**