ZlAutoGive 1.0.0

## ✨ Overview

ZlAutoGive is a **powerful, lightweight, and fully configurable plugin** that automatically gives players the **vanilla drops** of blocks directly to their inventory! Perfect for servers that want to streamline resource collection while keeping the **vanilla Minecraft experience intact**.

With ZlAutoGive, you can:

* 💎 Automatically get blocks and items from mining or harvesting **without losing vanilla mechanics**.
* 🍏 Receive **apple drops from oak leaves** with the same probability as vanilla.
* 🛠 Respect **Silk Touch & Fortune enchantments** on your tools.
* 🎛 Apply **multipliers per permission group** (e.g., VIP, MVP) to increase drops.
* 📦 Handle **full inventories gracefully**, dropping items to the ground with a clear warning message.
* ⚡ Enable or disable the system dynamically, reload config/messages, and customize **prefixes & colors**.

---

## 🧩 Features

* ✅ Automatic vanilla drops
* ✅ Silk Touch & Fortune support
* ✅ Multipliers per permission (`zlautogive.multiplier.X`)
* ✅ Configurable messages with **colors** (`&x`, `&#hex`, `&`)
* ✅ Inventory full handling with item drop + warning message
* ✅ Works for **Minecraft 1.18 and above**
* ✅ Lightweight & server-friendly

---

## ⚙ Configuration

ZlAutoGive comes with:

* `config.yml` – Enable/disable system, set multipliers per permission.
* `messages.yml` – Customize all messages, including prefix, help, and inventory full warnings.

**Example config snippet:**

```yaml
system-enabled: true
multipliers:
  vip: 3
  mvp: 5
```

**Example message:**

```yaml
inventory-full: "%prefix%&cYour inventory is full! Dropped &b%amount%x &f%item%"
```

---

## 📝 Commands

| Command              | Permission              | Description                                |
| -------------------- | ----------------------- | ------------------------------------------ |
| `/zlautogive on`     | `zlautogive.admin` / OP | Enable the system (applies after restart)  |
| `/zlautogive off`    | `zlautogive.admin` / OP | Disable the system (applies after restart) |
| `/zlautogive reload` | `zlautogive.admin` / OP | Reload config and messages                 |
| `/zlautogive`        | Any with permission     | Show help message                          |

---

## 🎨 Customization

* Full **color support**: `&`, `&x`, `&#hex`
* **Prefix customization** in `messages.yml`
* Control multipliers per **LuckPerms groups**

---

## 💡 Why use ZlAutoGive?

* Saves players time without breaking vanilla Minecraft.
* Perfect for **semi-vanilla, survival, and minigame servers**.
* Fully **configurable and permission-based**, giving you complete control.
* Lightweight and **optimized for 1.18+ servers**.

---

## 🚀 Installation

1. Place `ZlAutoGive.jar` in your `/plugins` folder.
2. Start your server once to generate config/messages.
3. Configure multipliers and messages to your liking.
4. Reload with `/zlautogive reload` or restart the server.

---

## 📣 Support & Credits

* Developed by **Zeralyth Studios**
* For support or suggestions, contact your server dev team or reach out to Zeralyth Studios.

---

### 🎉 Enjoy streamlined mining & harvesting while keeping Minecraft fully vanilla! 🍀💎