# 🔮 CraftSpell
_Craft magic scrolls, spend mana, and unleash devastating spells._
## ✨ Overview
CraftSpell adds a magic system built around craftable spell scrolls and a mana resource. Players craft scrolls at a crafting table using themed ingredients, then right-click to cast — consuming the scroll and a bit of mana. Spells include Lightning, Healing, Freeze, Fireball, Invisibility, and Teleport, each with its own mana cost. Mana regenerates over time, and the current amount is shown in the action bar after every cast.
## 📦 Installation
1. Drop `CraftSpell.jar` into your server's `/plugins` folder.
2. Restart the server (built for Minecraft **1.21**, api-version `1.21`).
3. Players craft scrolls, then right-click to cast. Tune mana and spell costs in `config.yml`.
## ⌨️ Commands
| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/spell` | CraftSpell main command. Usage: `/spell <list\|mana\|give>`. `list` shows every spell and its mana cost, `mana` checks your current mana, and `give <player> <spell>` hands a scroll to a player. | `spells`, `cs` | _none_ |
## 🔑 Permissions
- `craftspell.give` — Allows giving spell scrolls to players via `/spell give`. Default: **op**.
- `craftspell.cast` — Allows casting spells. Default: **true** (everyone).
## ⚙️ Configuration
- `mana.max` (default `100`) — the maximum mana a player can hold.
- `mana.regen-amount` (default `5`) — mana regenerated each interval.
- `mana.regen-interval-ticks` (default `100`) — ticks between regen ticks (20 ticks = 1 second).
- `spells` — per-spell `enabled` flag and `mana-cost` for lightning, healing, freeze, fireball, invisibility, and teleport.
### 🧪 Scroll recipes
Each scroll is crafted with paper plus a themed core ingredient: Lightning (blaze rod), Healing (glistering melon slice), Freeze (packed ice), Fireball (fire charge), Invisibility (fermented spider eye), and Teleport (ender pearl).
## 📖 Full documentation
---
🤖 *This plugin was created with **Spaleforce AI**. Create your own Minecraft plugins for free at* 🚀 **https://spaleforce.com**
