BetonQuest

Système de quêtes scriptable (conversations, objectifs, événements)

BetonQuest

Type

Roleplay

Développeur

Équipe BetonQuest

Statut

Installé

Ressources

Documentation

Documentation

Site web

Site web

Modrinth

Modrinth

Spigot

Spigot

Code source

GitHub

Compatibilité

Dépendance(s)

Citizens (PNJ), PlaceholderAPI, Vault, Holograms, Parties…

BetonQuest est un plugin de quêtes complet et scriptable. Il s’appuie sur des fichiers YAML (packages) pour définir conversations, objectifs, conditions, événements, menus, journaux, etc. Il offre des commandes joueurs (journal, sac à dos, boussole, annulation de quête) et un outillage admin étendu pour gérer tags/points/objectifs, exécuter des événements, vérifier des conditions et déboguer.

Utilisation en jeu

Les joueurs interagissent via des PNJ (conversations), récupèrent/consultent leurs objectifs et suivent leur progression avec la boussole et le journal. L’admin dispose d’une commande centrale /q (alias /bq, /quest, etc.) pour gérer et diagnostiquer les quêtes en ligne.

Commandes (joueurs)

Commande	Effet
/j	Donne/ouvre le journal de quêtes du joueur.
/backpack	Ouvre le sac à dos (objets de quête, stockage lié aux quêtes).
/compass	Ouvre la boussole de suivi d’objectifs.
/cancelquest	Ouvre le menu d’annulation de quête.
/questlang <lang>	Change la langue d’affichage des textes pour le joueur.

Aliases usuels : /j : bj, journal… ; /backpack : bb… ; /q : bq, quest, quests… (voir doc). ([betonquest.org](https://betonquest.org/2.2/Documentation/Configuration/Commands-and-permissions/))

Commandes (administration)

La commande d’administration est /betonquest (alias /q, /bq, /quest, etc.). Extraits utiles : https://betonquest.org/2.2/Documentation/Configuration/Commands-and-permissions/

Sous‑commande	Usage rapide / Exemple
/q reload	Recharge les configurations BetonQuest.
add|del|complete> <ID>	Lister/ajouter/supprimer/compléter un objectif actif.
add|del> <Tag>	Gérer les tags du joueur.
add|del> <Catégorie> [Montant]	Gérer les points (réputation, etc.).
-> <Package.EventID>	Exécuter un événement (- = statique/sans joueur).
-> <Package.ConditionID>	Tester une condition.
add|del> <Package.Pointer> [Date]	Gérer les entrées de journal.
/q item <Package.ItemID> / /q give <Package.ItemID>	Créer un item (depuis la main) / donner un item de quête.
set|del> …	Gérer les variables d’objectifs.
/q purge <Joueur> / /q delete … / /q rename …	Purge/suppression/renommage de données.
/q backup	Sauvegarde zip (config + base de données) de BetonQuest.
/q update / /q version	Mise à jour / versions (plugin, serveur, hooks).
false|ingame]	Débogage (fichier logs/latest.log et debug in‑game).
/q download <GitHubNS> <ref> <type> <sourcePath> …	Télécharger des modèles/tutos depuis GitHub (liste blanche requise).

Voir la page « Commands and permissions » pour la liste complète, alias et précisions (filtres, packages). ([betonquest.org](https://betonquest.org/2.2/Documentation/Configuration/Commands-and-permissions/))

Exemples rapides

• Lister les objectifs actifs d’Alice : /q objective Alice list
• Donner 20 points de réputation à Bob : /q point Bob add reputation 20
• Lancer un événement giveFoodToPlayer du package tutorialQuest : /q event Bob tutorialQuest.giveFoodToPlayer

Ces usages sont détaillés dans la doc et les tutoriels.

Permissions principales

Permission	Rôle
betonquest.admin	Autorise les commandes admin (/q, menus RPG, etc.).
betonquest.conversation	Autorise à parler aux PNJ (conversations).
betonquest.journal	Utiliser /j.
betonquest.backpack	Utiliser /backpack.
betonquest.compass	Utiliser /compass.
betonquest.cancelquest	Utiliser /cancelquest.
betonquest.language	Utiliser /questlang.

Toutes les permissions et alias sont listés dans la documentation officielle.

Bonnes pratiques

• Travailler par packages et préfixes clairs (ex. main>find_sword) pour éviter les collisions d’IDs.
• Utiliser /q debug ingame et /q reload lors des itérations de conception.
• Sauvegarder avec /q backup avant une migration ou un remaniement majeur. ([betonquest.org](https://betonquest.org/2.2/Documentation/Configuration/Commands-and-permissions/))

Liens

• [Site officiel & Docs] · [Configuration / Commands & Permissions]
• [SpigotMC – Ressource] · [Modrinth – Plugin]
• [GitHub – Code source]