> For the complete documentation index, see [llms.txt](https://docs.vexalstudios.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vexalstudios.com/minecraft-plugins/vexal-arrows-free.md).

# Vexal Arrows - Free

## Custom Arrow System for Minecraft

VexalArrows brings a fully-customizable arrow system to Minecraft servers. Create unique arrow types with custom behaviors, effects, GUI selection menus, quivers, crafting recipes, and player arrow storage — all configurable through YAML or SQLite!

This plugin is designed for SMPs, RPG servers, and PvP servers that want **next-level archery mechanics** without needing mods.

***

### ✨ Features

* ✅ Fully custom arrow types
* ✅ Arrow effects & behaviors (explosive, potion-based, utility, etc.)
* ✅ Customizable crafting recipes
* ✅ Quiver system with GUI selector
* ✅ SQLite or YAML player data storage
* ✅ User-friendly GUI menu
* ✅ Permissions-based arrow access
* ✅ `/givearrow`, `/quiver`, `/quiverstandalone` commands
* ✅ Efficient and optimized Bukkit API design

***

### 🛠 Commands

| Command                                | Description                          | Permission                      |
| -------------------------------------- | ------------------------------------ | ------------------------------- |
| `/givearrow <player> <arrow> [amount]` | Gives a custom arrow                 | `vexalarrows.give`              |
| `/quiver`                              | Opens the quiver GUI                 | `vexalarrows.quiver`            |
| `/quiverstandalone`                    | Opens the standalone quiver selector | `vexalarrows.quiver.standalone` |

***

### 🔐 Permissions

| Permission                      | Description                    |
| ------------------------------- | ------------------------------ |
| `vexalarrows.give`              | Allow giving custom arrows     |
| `vexalarrows.quiver`            | Use the quiver system          |
| `vexalarrows.quiver.standalone` | Use standalone quiver menu     |
| `vexalarrows.arrow.*`           | Access all custom arrows       |
| `vexalarrows.arrow.<arrowname>` | Access a specific custom arrow |

***

### ⚙️ Configuration

All configs are found in `/plugins/VexalArrows/`

| File           | Purpose                        |
| -------------- | ------------------------------ |
| `arrows.yml`   | Define custom arrows & effects |
| `quiver.yml`   | Quiver settings                |
| `messages.yml` | Plugin messages                |
| `config.yml`   | Storage & main settings        |

Supports:

* SQLite storage
* YAML storage

***

### 📦 Installation

1. Download latest release
2. Drop into `/plugins/` folder
3. Start server
4. Edit config files as desired
5. Restart server

✅ Works on: **Paper / Spigot 1.20+**\
📌 Recommended: **Paper 1.20+**

***