# 🏆 AchievementHunter
Custom achievements with configurable rewards and progress tracking.
## ✨ Overview
AchievementHunter adds a fully configurable achievement system to your server. Players earn achievements by joining for the first time, mining stone, racking up playtime, and any other milestone you define in the config. Each unlock can run console commands and hand out item rewards, and players can browse their progress in a clean chest-style GUI or a quick chat list.
## 📦 Installation
1. Drop `AchievementHunter.jar` into your server's `/plugins` folder.
2. Restart the server (built for Minecraft **1.21**, api-version `1.21`).
3. Edit the generated `config.yml` to tweak achievements and rewards, then run `/achievements admin` to manage them in-game.
## ⌨️ Commands
| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/achievements` | Main AchievementHunter command. Usage: `/achievements <list\|progress\|admin>`. `list` shows achievements in chat, `progress` opens the GUI, and `admin give <player> <id>` unlocks an achievement for a player. | _none_ | `achievementhunter.use` |
## 🔑 Permissions
- `achievementhunter.use` — Access to the achievements command and GUI. Default: **true** (everyone).
- `achievementhunter.admin` — Allows `/achievements admin give <player> <id>`. Default: **op**.
## ⚙️ Configuration
The `achievements` section defines each achievement by an ID. Per achievement you set:
- `name` and `description` — shown in chat and the GUI.
- `type` — `manual` (admin-granted or event-driven) or `playtime` (auto-tracked minutes played).
- `required` — the threshold to unlock (e.g. mine 64 stone, play 60 minutes).
- `icon` — the Material shown in the GUI.
- `rewards.commands` — console commands run on unlock (supports `%player%`).
- `rewards.items` — items granted, each with a `material` and `amount`.
Defaults ship with **First Steps** (first join), **Stone Miner** (mine 64 stone/cobblestone), and **Veteran** (60 minutes of playtime).
## 📖 Full documentation
---
🤖 *This plugin was created with **Spaleforce AI**. Create your own Minecraft plugins for free at* 🚀 **https://spaleforce.com**
