SuperQuest

## 🏆 SuperQuest — Quêtes collaboratives pour Minecraft

**SuperQuest** est un plugin de quêtes globales où **tous les joueurs avancent ensemble** vers un objectif commun. Le serveur entier s'entraide, chaque action compte, et les récompenses sont attribuées automatiquement aux participants les plus actifs.

---

### ✨ Fonctionnalités principales

**6 types de quêtes configurables :**

- 🔨 `BREAK_BLOCK` — Casser un type de bloc précis

- 🪨 `PLACE_BLOCK` — Poser des blocs

- ⚔️ `KILL_MOB` — Tuer un type de mob

- 💀 `KILL_PLAYER` — Kills PvP

- 🎣 `FISH` — Attraper des poissons

- ⚒️ `CRAFT_ITEM` — Crafter un item spécifique

**4 types de récompenses :**

- 🎁 Items (material + quantité + data value 1.8)

- 💰 Argent via Vault

- 💻 Commande console personnalisée (`%player%`)

- 📣 Broadcast serveur

**Interface graphique intuitive :**

- `/sq gui` — Visualiser toutes les quêtes actives avec progression

- `/sq rewards` — Réclamer ses récompenses en un clic

- Pagination intégrée, entièrement configurable dans `config.yml`

---

### 🔗 Intégration PlaceholderAPI

Plus de 10 placeholders disponibles :

`%superquest_quest__name%` · `%superquest_quest__bar%` · `%superquest_quest__percent%` · `%superquest_quest__time%` · `%superquest_quest__contribution%` · `%superquest_quest__participants%` · et bien d'autres...

Alias `%superquest_first_*%` pour la première quête active — parfait pour les scoreboards.

---

### ⚙️ Configuration avancée

- Durée par quête : illimitée ou avec countdown

- Participation minimum pour être éligible à la récompense

- Auto-start et auto-rotate des quêtes au démarrage

- Sauvegarde automatique configurable (intervalle en secondes)

- ActionBar en temps réel à chaque contribution

- Annonces chat périodiques (quête unique ou multi-quêtes)

- Barre de progression 100% personnalisable (caractères, couleurs, longueur)

- Fichier de langue `fr.yml` entièrement éditable

---

### 🛠️ Commandes & permissions

| Commande | Description | Permission |

|----------|-------------|------------|

| `/sq gui` | Ouvrir l'interface des quêtes | Tous |

| `/sq rewards` | Réclamer ses récompenses | Tous |

| `/sq list` | Lister toutes les quêtes | Tous |

| `/sq info ` | Détails d'une quête | Tous |

| `/sq start ` | Démarrer une quête | `superquest.admin` |

| `/sq stop ` | Arrêter une quête | `superquest.admin` |

| `/sq give  ` | Forcer une récompense | `superquest.admin` |

| `/sq reload` | Recharger la config | `superquest.admin` |

| `/sq announce` | Broadcast manuel | `superquest.admin` |

| `/sq debug ` | Diagnostiquer une quête | `superquest.admin` |

---

### 📋 Configuration requise

- Spigot / Paper **1.8+**

- Java 8+

- **Vault** (obligatoire si récompenses money)

- **PlaceholderAPI** (optionnel — pour les placeholders)

---

### 📁 Fichiers générés

- `config.yml` — paramètres globaux, GUI, ActionBar, barre de progression

- `quests.yml` — définition complète des quêtes et récompenses

- `fr.yml` — tous les messages, totalement personnalisables

---

*Plugin développé par **Supern0v4***

Support :

Un souci ou une question ? Contactez-moi directement sur Discord :

Supern0v4#1491