GroupeZ Docs
Configurations

Configuration des quetes

Apprenez a configurer les quetes dans zQuests

Cette page explique comment configurer les quetes dans zQuests. Chaque quete est definie en utilisant une configuration YAML avec diverses options pour personnaliser le comportement, les objectifs et les recompenses.

Structure de base

Les quetes sont definies dans des fichiers YAML situes dans le dossier plugins/zQuests/quests/. Vous pouvez organiser les quetes en plusieurs fichiers pour une meilleure gestion.

quests:
  - type: BLOCK_BREAK
    name: "casseur-de-pierre-1"
    display-name: "Casseur de Pierre"
    description: "Cassez 500 blocs de pierre"
    thumbnail: STONE
    goal: 500
    auto-accept: true
    actions:
      - material: STONE
      - material: COBBLESTONE
    rewards:
      - type: message
        messages:
          - "&aVous avez complete la quete Casseur de Pierre !"
      - type: console_command
        commands:
          - "give %player% diamond 5"

Options de configuration

type

Specifie le type de quete. Cela determine comment la progression est suivie.

  • Requis : Oui
  • Par defaut : Aucun
type: BLOCK_BREAK

Voir Types de quetes pour tous les types disponibles.

name

Un identifiant unique pour la quete. Cette valeur est utilisee en interne pour suivre la progression des joueurs et ne doit jamais changer une fois que les joueurs ont commence la quete.

  • Requis : Oui
  • Par defaut : Aucun
name: "casseur-de-pierre-1"

Important

Le nom de la quete doit etre unique dans tous les fichiers de quetes. Changer cette valeur apres que des joueurs ont commence la quete reinitialise leur progression !

display-name

Le nom affiche aux joueurs dans les inventaires et messages. Supporte les codes couleur et les placeholders.

  • Requis : Non
  • Par defaut : Utilise la valeur de name
display-name: "&6Casseur de Pierre"

description

Une description de la quete montree aux joueurs. Supporte les codes couleur.

  • Requis : Non
  • Par defaut : "no description"
description: "Cassez 500 blocs de pierre pour completer cette quete"

placeholder-description

Une description alternative qui supporte les placeholders dynamiques. Utile pour montrer la progression restante.

  • Requis : Non
  • Par defaut : Utilise description
placeholder-description: "Cassez encore %quest-remaining% blocs de pierre"

Placeholders disponibles :

  • %quest-remaining% - Quantite restante
  • %quest-progress% - Progression actuelle
  • %quest-goal% - Objectif de la quete

thumbnail

Le materiau utilise comme icone de la quete dans les inventaires.

  • Requis : Non
  • Par defaut : Aucun
thumbnail: DIAMOND_PICKAXE

Utilise les noms de materiaux Bukkit.

goal

La quantite cible pour completer la quete.

  • Requis : Oui
  • Par defaut : 1
goal: 500

auto-accept

Si la quete demarre automatiquement quand elle est disponible pour le joueur.

  • Requis : Non
  • Par defaut : false
auto-accept: true

use-global-rewards

Si les recompenses globales doivent etre incluses quand la quete est completee.

  • Requis : Non
  • Par defaut : true
use-global-rewards: true

Mettez false si vous voulez seulement les recompenses specifiques a la quete.

favorite

Si la quete est marquee comme favorite quand elle demarre.

  • Requis : Non
  • Par defaut : false
favorite: true

can-change-favorite

Si les joueurs peuvent changer le statut favori de cette quete.

  • Requis : Non
  • Par defaut : true
can-change-favorite: true

unique

Quand active, la progression sur cette quete empeche la progression sur d'autres quetes du meme type. Utile pour les quetes d'histoire ou une seule quete doit avancer a la fois.

  • Requis : Non
  • Par defaut : false
unique: true

hidden

Si la quete est cachee du bouton ZQUESTS_HISTORY.

  • Requis : Non
  • Par defaut : false
hidden: true

custom-model-id

ID de modele personnalise pour l'integration de pack de ressources, disponible via le placeholder %quest-model-id%.

  • Requis : Non
  • Par defaut : 0
custom-model-id: 1001

actions

Definit ce qui compte pour la progression de la quete. Le format depend du type de quete.

  • Requis : Depend du type de quete
  • Par defaut : Liste vide
# Pour les quetes BLOCK_BREAK
actions:
  - material: STONE
  - material: COBBLESTONE
  - tag: LOGS  # Tags Bukkit

# Pour les quetes ENTITY_KILL
actions:
  - entity: ZOMBIE
  - entity: SKELETON

rewards

Actions executees quand la quete est completee. Supporte toutes les actions zMenu.

  • Requis : Non
  • Par defaut : Liste vide
rewards:
  - type: message
    messages:
      - "&aQuete completee !"
  - type: console_command
    commands:
      - "give %player% diamond 10"
  - type: sound
    sound: ENTITY_PLAYER_LEVELUP

Voir Actions zMenu pour tous les types d'actions disponibles.

start-actions

Actions executees quand la quete demarre.

  • Requis : Non
  • Par defaut : Liste vide
start-actions:
  - type: message
    messages:
      - "&eQuete demarree ! Bonne chance !"
  - type: sound
    sound: ENTITY_EXPERIENCE_ORB_PICKUP

permissible-rewards

Recompenses bonus donnees seulement si le joueur remplit certaines conditions.

  • Requis : Non
  • Par defaut : Liste vide
permissible-rewards:
  - requirements:
      - type: permission
        permission: quests.vip
    actions:
      - type: message
        messages:
          - "&6Bonus VIP : Recompenses supplementaires !"
      - type: console_command
        commands:
          - "give %player% diamond 5"

action-requirements

Conditions qui doivent etre remplies pour que la progression compte. Si le joueur ne remplit pas ces conditions, ses actions n'avanceront pas la quete.

  • Requis : Non
  • Par defaut : Liste vide
action-requirements:
  - type: permission
    permission: quests.can-progress
  - type: world
    world: survival

hologram

Affiche un hologramme quand la quete est active. Peut referencer un hologramme global par nom ou definir en ligne.

  • Requis : Non
  • Par defaut : Aucun

Reference hologramme global :

hologram: MON_HOLOGRAMME

Definition en ligne :

hologram:
  location: "world,100,65,200"
  texts:
    - "&aEmplacement de quete ici !"
    - "&7Suivez le chemin..."

Voir Waypoints & Hologrammes pour la configuration complete.

waypoint

Affiche un waypoint guidant le joueur vers un emplacement. Peut referencer un waypoint global ou definir en ligne.

  • Requis : Non
  • Par defaut : Aucun

Reference waypoint global :

waypoint: EMPLACEMENT_QUETE

Definition en ligne :

waypoint:
  location: "world,100,65,200"
  texture: marqueur_quete
  color: gold

Voir Waypoints & Hologrammes pour la configuration complete.

Exemple complet

Voici une configuration de quete complete montrant la plupart des options :

quests:
  - type: BLOCK_BREAK
    name: "maitre-mineur"
    display-name: "&6Maitre Mineur"
    description: "Cassez 1000 blocs de minerai"
    placeholder-description: "Cassez encore %quest-remaining% blocs de minerai"
    thumbnail: DIAMOND_ORE
    goal: 1000
    auto-accept: false
    use-global-rewards: true
    favorite: false
    can-change-favorite: true
    unique: false
    hidden: false
    custom-model-id: 0
    actions:
      - material: COAL_ORE
      - material: IRON_ORE
      - material: GOLD_ORE
      - material: DIAMOND_ORE
      - material: EMERALD_ORE
      - material: LAPIS_ORE
      - material: REDSTONE_ORE
      - material: COPPER_ORE
    action-requirements:
      - type: world
        world: survival
    start-actions:
      - type: message
        messages:
          - "&eVous avez demarre la quete Maitre Mineur !"
          - "&7Cassez 1000 blocs de minerai pour la completer."
    rewards:
      - type: message
        messages:
          - "&a&lQuete Completee !"
          - "&7Vous etes maintenant un Maitre Mineur !"
      - type: console_command
        commands:
          - "give %player% diamond 64"
          - "eco give %player% 10000"
      - type: sound
        sound: UI_TOAST_CHALLENGE_COMPLETE
    permissible-rewards:
      - requirements:
          - type: permission
            permission: rank.vip
        actions:
          - type: message
            messages:
              - "&6&lBONUS VIP : +32 diamants !"
          - type: console_command
            commands:
              - "give %player% diamond 32"
    hologram: ZONE_MINAGE
    waypoint: ZONE_MINAGE

Organisation des fichiers

Vous pouvez organiser les quetes en plusieurs fichiers :

plugins/zQuests/quests/
├── debutant/
│   ├── tutoriel.yml
│   └── quetes-demarrage.yml
├── quotidien/
│   ├── minage.yml
│   └── agriculture.yml
├── histoire/
│   └── histoire-principale.yml
└── evenements/
    └── halloween.yml

Chaque fichier doit contenir une liste quests :

# quests/debutant/tutoriel.yml
quests:
  - type: BLOCK_BREAK
    name: "tutoriel-1"
    # ... config quete

  - type: CRAFT
    name: "tutoriel-2"
    # ... config quete

Prochaines etapes

Installation

Comment telecharger, installer et configurer zQuests sur votre serveur Minecraft

Types de quetes

Tous les types de quetes disponibles dans zQuests

Sur cette page

Structure de baseOptions de configurationtypenamedisplay-namedescriptionplaceholder-descriptionthumbnailgoalauto-acceptuse-global-rewardsfavoritecan-change-favoriteuniquehiddencustom-model-idactionsrewardsstart-actionspermissible-rewardsaction-requirementshologramwaypointExemple completOrganisation des fichiersProchaines etapes
GroupeZ MCP

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.