ZlPvPTrigger 1.0.0

## ✨ Overview

ZlPvPItem is a **lightweight, powerful, and fully configurable plugin** that allows players to **activate PvP simply by holding a specific item**! Perfect for servers that want to enable **optional combat in lobbies or safe zones** without removing protections.

With ZlPvPItem, you can:

* ⚔️ Enable **PvP mode instantly** when holding a configured item.
* 🛡 Keep **safe zones protected** while allowing selective PvP.
* 🎛 Fully customize the **activator item, name, and PvP rules**.
* 🔄 Automatically disable PvP when the item is removed.
* 📦 Control which players can engage in PvP via **permissions**.
* ⚡ Dynamically reload settings without restarting the server.

---

## 🧩 Features

* ✅ PvP activation via item in hand
* ✅ Fully configurable **material & name** for the activator item
* ✅ Automatic PvP enable/disable
* ✅ Permissions support (`zlpvpitem.bypass`)
* ✅ Safe zone compatible
* ✅ Works for **Minecraft 1.18 and above**
* ✅ Lightweight & server-friendly
* ✅ No commands required for basic use

---

## ⚙ Configuration

ZlPvPItem comes with:

* `config.yml` – Configure the activator item, PvP rules, and safe zones.
* `messages.yml` – Customize all messages, including prefix and PvP notifications.

**Example config snippet:**

```yaml
system-enabled: true
pvp-trigger-item: DIAMOND_SWORD
trigger-slot: 0
activation-delay: 1
deactivation-delay: 1

pvp-kit:
  enabled: true
  armor:
    helmet: NETHERITE_HELMET
    chestplate: NETHERITE_CHESTPLATE
    leggings: NETHERITE_LEGGINGS
    boots: NETHERITE_BOOTS
```

**Example message:**

```yaml
general:
  prefix: "&x&0&0&7&f&f&f&lZlPvPTrigger &8» "

errors:
  cannot-move-trigger-item: "%prefix%&cYou cannot move the PvP trigger item."

combat:
  only-pvp-enabled-fight: "%prefix%&cBoth players must have PvP enabled to fight."

pvp:
  activation:
    countdown: "%prefix%&aActivating PvP in &e%seconds% &asecond(s)..."
    enabled: "%prefix%&cPvP mode enabled."
  deactivation:
    countdown: "%prefix%&eDisabling PvP in &6%seconds% &esecond(s)..."
    disabled: "%prefix%&aPvP mode disabled."

commands:
  no-permission: "%prefix%&cYou do not have permission to use this command."
  unknown: "%prefix%&cUnknown subcommand. Use &e/zlpvptrigger help&c."
  reload: "%prefix%&aConfiguration and messages reloaded successfully."
  system-enabled: "%prefix%&aZlPvPTrigger system has been enabled."
  system-disabled: "%prefix%&cZlPvPTrigger system has been disabled."
  help:
    header: "%prefix%&7Available commands:"
    line-1: "%prefix%&e/zlpvptrigger help &7- Show this help menu."
    line-2: "%prefix%&e/zlpvptrigger version &7- Show plugin version."
    line-3: "%prefix%&e/zlpvptrigger support &7- Show support link."
    line-4: "%prefix%&e/zlpvptrigger reload &7- Reload config/messages."
    line-5: "%prefix%&e/zlpvptrigger off &7- Disable the PvP trigger system."
    line-6: "%prefix%&e/zlpvptrigger on &7- Enable the PvP trigger system."
```

---

## 📝 Commands

ZlPvPItem works **automatically** without player commands, but admins can use:

| Command             | Permission        | Description                       |
| ------------------- | ----------------- | --------------------------------- |
| `/zlpvpitem reload` | `zlpvpitem.admin` | Reload configuration and messages |

---

## 🎨 Customization

* Full **color support** in messages: `&`, `&x`, `&#hex`
* **Custom activator item** (material & name)
* Control PvP **permissions and bypass groups**

---

## 💡 Why use ZlPvPItem?

* Adds **optional PvP** without removing protections.
* Perfect for **lobbies, mini-games, or KitPvP servers**.
* Fully **configurable and lightweight**, optimized for modern servers.
* Easy to use with **automatic activation and deactivation**.

---

## 🚀 Installation

1. Place `ZlPvPItem.jar` in your `/plugins` folder.
2. Start the server once to generate config/messages.
3. Configure your **activator item and messages**.
4. Reload with `/zlpvpitem reload` or restart the server.

---

## 📣 Support & Credits

* Developed by **Zeralyth Studios**
* For support, bug reports, or feature requests, open a **ticket on Discord**.

---

### 🎉 Enable PvP on demand while keeping your server safe and fun! ⚔️🛡️