# LuxLifeSteal – Installation & Usage Guide

## Installing the Plugin

Follow these steps to install **LuxLifeSteal** on your Minecraft server.

1. Download the `LuxLifeSteal.jar` file.
2. Place the `.jar` file inside your server's `plugins/` folder.
3. Start or restart your **Spigot server (API version 1.21)**.
4. Verify the plugin loaded correctly:
- Check the server console for `LuxLifeSteal`.
- Run `/lifesteal` in-game.

If the folder `plugins/LuxLifeSteal/` is created, the plugin has installed successfully.

---

# Commands

| Command | Description | Permission |
|--------|-------------|------------|
| `/lifesteal` or `/ls` | Opens the admin GUI (players only) | `luxlifesteal.admin` |
| `/lifesteal bans` | Opens the banned players menu (players only) | `luxlifesteal.admin` |
| `/lifesteal set <player> <amount>` | Sets a player's life count | `luxlifesteal.admin` |
| `/lifesteal add <player> <amount>` | Adds lives to a player | `luxlifesteal.admin` |
| `/lifesteal remove <player> <amount>` | Removes lives from a player | `luxlifesteal.admin` |
| `/lifesteal revive <player>` | Unbans a player and restores starting lives if required | `luxlifesteal.admin` |
| `/lifesteal reload` | Reloads plugin configuration files | `luxlifesteal.admin` |
| `/hearts` | Shows your own hearts/lives | None |
| `/hearts <player>` | Shows another player's hearts/lives | `luxlifesteal.hearts.others` |

---

# Permissions

| Permission | Description | Default |
|-----------|-------------|---------|
| `luxlifesteal.admin` | Access to all LuxLifeSteal admin commands and GUI | `op` |
| `luxlifesteal.hearts.others` | Allows viewing other players' hearts | `op` |

---

# Quick Admin Tutorial

Typical workflow for server administrators:

1. Give yourself **OP** or the `luxlifesteal.admin` permission.
2. Run `/lifesteal` to open the **admin GUI**.
3. Manage player lives using:
- `/lifesteal set`
- `/lifesteal add`
- `/lifesteal remove`
4. If a player reaches **zero lives** and is banned, run: