GroupeZ Docs
Configurations

config.yml

Fichier de configuration principal de zQuests

Cette page documente toutes les options disponibles dans le fichier de configuration principal config.yml.

Options de debug

# Active l'affichage d'informations detaillees dans la console
# Activez ceci lors du depannage
enable-debug: false

# Active le debug du temps d'execution pour mesurer les performances du plugin
# Utile pour identifier les goulots d'etranglement
enable-debug-time: false

Configuration du stockage

# Options de type de stockage :
# SQLITE - Stockage simple base sur fichier (test/petits serveurs uniquement)
# MYSQL - Connexion MySQL directe
# HIKARICP - MySQL avec pool de connexions (recommande pour la production)
storage-type: SQLITE

# Configuration de la base de donnees (pour MYSQL et HIKARICP)
database-configuration:
  # Prefixe des tables pour toutes les tables zQuests
  table-prefix: "zquests_"
  # IP du serveur de base de donnees
  host: 192.168.10.10
  # Port de la base de donnees (MySQL par defaut : 3306)
  port: 3306
  # Nom d'utilisateur
  user: votre_utilisateur
  # Mot de passe
  password: 'votre_mot_de_passe'
  # Nom de la base de donnees
  database: zquests
  # Activer la journalisation des requetes SQL
  debug: false

Limitations de SQLite

SQLite est recommande uniquement pour les tests. Certaines fonctionnalites peuvent avoir des fonctionnalites limitees. Utilisez HIKARICP pour les serveurs de production.

Configuration des commandes

# Alias pour la commande principale /zquests
main-command-aliases:
  - quests
  - quest
  - q

# Inventaire par defaut ouvert par la commande /quests
main-command-inventory-name: "quests"

# Page de demarrage basee sur les permissions
# Les joueurs avec ces permissions commencent sur differentes pages
main-command-page:
  - permission: "quests.page.2"
    inventory: "quests"
    page: 2
    priority: 1
  - permission: "quests.page.3"
    inventory: "quests"
    page: 3
    priority: 2

Configuration de la barre de progression

Configurez l'apparence des barres de progression dans les placeholders :

progress-bar:
  # Caractere pour la progression completee
  icon: '|'
  # Caractere pour la progression restante
  not-completed-icon: '|'
  # Couleur pour la portion completee (couleur hex)
  progress-color: "#0ff216"
  # Couleur pour la portion restante (couleur hex)
  color: "#828282"
  # Longueur totale de la barre (nombre de caracteres)
  size: 30

Exemple de resultat : |||||||||||||||||||||||||||||| (portion verte = complete, gris = restant)

Configuration de la ligne de lore

Configurez le format du placeholder %zquests_lore_line_<quete>% :

lore-line-placeholder:
  # Format pour les quetes actives (incompletes)
  active: "%progress-bar% &8- &6%progress%&8/&f%goal% &c✘"
  # Format pour les quetes completees
  complete: "%progress-bar% &8- &6%progress%&8/&f%goal% &a✔"

Variables disponibles :

  • %progress-bar% - La barre de progression visuelle
  • %progress% - Nombre de progression actuelle
  • %goal% - Objectif de la quete

Placeholder des quetes favorites

Configurez le placeholder %zquests_favorite_quests% :

placeholder-favorite:
  # Nombre maximum de quetes favorites a afficher
  limit: 3
  # Message affiche quand le joueur n'a pas de favoris
  empty: "&cAucune quete favorite"
  # Format pour chaque quete dans la liste
  result: "&f%quest-description%\n&8%quest-display-name%\n#fcd600%quest-progress%&8/&f%quest-objective%"
  # Separateur entre les quetes
  between: "\n\n"

Variables disponibles dans result :

  • %quest-name% - Nom interne de la quete
  • %quest-display-name% - Nom d'affichage
  • %quest-description% - Description
  • %quest-thumbnail% - Materiau miniature
  • %quest-type% - Type de quete
  • %quest-objective% - Objectif
  • %quest-lore-line% - Ligne de lore formatee
  • %quest-progress-bar% - Barre de progression
  • %quest-percent% - Pourcentage de completion
  • %quest-progress% - Progression actuelle
  • %quest-global-group-name% - Nom du groupe

Groupes de quetes

Organisez les quetes en groupes pour les placeholders :

quests-groups:
  minage:
    display-name: "Quetes de Minage"
    quests:
      - "casseur-pierre-1"
      - "casseur-pierre-2"
      - "mineur-minerai-1"
  agriculture:
    display-name: "Quetes d'Agriculture"
    quests:
      - "fermier-ble-1"
      - "maitre-recoltes-1"

# Nom de groupe par defaut pour les quetes non groupees
global-group-display-name: "General"

Placeholders de groupe :

  • %zquests_group_name_minage% - "Quetes de Minage"
  • %zquests_group_count_minage% - Total de quetes dans le groupe
  • %zquests_group_finish_minage% - Quetes completees
  • %zquests_group_percent_minage% - Pourcentage de completion

Recompenses globales

Recompenses donnees pour TOUTES les completions de quetes :

global-rewards:
  - type: message
    messages:
      - "&aQuete completee : &e%name%"
  - type: sound
    sound: ENTITY_PLAYER_LEVELUP

Placeholders disponibles : %name%, %description%, %goal%

Recompenses personnalisees

Recompenses speciales quand des combinaisons specifiques de quetes sont completees :

custom-rewards:
  - quests:
      - "tutoriel-1"
      - "tutoriel-2"
      - "tutoriel-3"
    actions:
      - type: message
        messages:
          - "&6&lTutoriel Complete !"
      - type: console_command
        commands:
          - "give %player% diamond 10"

Configuration des evenements

Controlez les evenements lies aux quetes et les mises a jour du scoreboard :

events:
  - event: QuestStartEvent
    enabled: true
    update-scoreboard: false

  - event: QuestProgressEvent
    enabled: true
    update-scoreboard: false

  - event: QuestCompleteEvent
    enabled: true
    update-scoreboard: false

  - event: QuestFavoriteChangeEvent
    enabled: true
    update-scoreboard: false

  - event: QuestPostProgressEvent
    enabled: true
    update-scoreboard: false

  - event: QuestUserLoadEvent
    enabled: true
    update-scoreboard: false

Mettez update-scoreboard: true pour rafraichir le scoreboard du joueur quand cet evenement se produit (necessite zEssentials).

Format de date

Configurez le format d'affichage des dates pour les placeholders :

date-format: "dd/MM/yyyy HH:mm:ss"

Utilise les patterns Java SimpleDateFormat.

Detection "Regarder vers"

Configurez la distance de detection pour les types de quetes LOOK_AT :

# Distance maximum pour la detection LOOK_AT_BLOCK
look-at-distance-block: 50

# Distance maximum pour la detection LOOK_AT_ENTITY
look-at-distance-entity: 50

Mises a jour hologrammes et waypoints

Controlez les mises a jour automatiques :

# Mettre a jour les hologrammes quand l'etat de la quete change
update-hologram: true

# Mettre a jour les waypoints quand l'etat de la quete change
update-waypoint: true

Exemple complet

enable-debug: false
enable-debug-time: false

storage-type: HIKARICP

database-configuration:
  table-prefix: "zquests_"
  host: localhost
  port: 3306
  user: minecraft
  password: 'mot_de_passe_securise'
  database: minecraft_quests
  debug: false

main-command-aliases:
  - quests
  - quest
  - q

main-command-inventory-name: "quests"

main-command-page:
  - permission: "quests.vip"
    inventory: "quests_vip"
    page: 1
    priority: 1

progress-bar:
  icon: '█'
  not-completed-icon: '░'
  progress-color: "#00FF00"
  color: "#444444"
  size: 20

lore-line-placeholder:
  active: "%progress-bar% &7%progress%/%goal%"
  complete: "%progress-bar% &a✔ Complete !"

placeholder-favorite:
  limit: 5
  empty: "&7Aucune quete suivie"
  result: "&6%quest-display-name%\n&7%quest-progress%/%quest-objective%"
  between: "\n"

quests-groups:
  quotidien:
    display-name: "&eQuetes Quotidiennes"
    quests:
      - "minage-quotidien"
      - "agriculture-quotidienne"
  hebdomadaire:
    display-name: "&6Quetes Hebdomadaires"
    quests:
      - "boss-hebdomadaire"

global-group-display-name: "Divers"

global-rewards:
  - type: sound
    sound: ENTITY_EXPERIENCE_ORB_PICKUP

custom-rewards:
  - quests:
      - "minage-quotidien"
      - "agriculture-quotidienne"
    actions:
      - type: message
        messages:
          - "&6Bonus quotidien : Toutes les quetes quotidiennes completees !"

events:
  - event: QuestCompleteEvent
    enabled: true
    update-scoreboard: true
  - event: QuestProgressEvent
    enabled: true
    update-scoreboard: false

date-format: "dd MMM yyyy"

look-at-distance-block: 100
look-at-distance-entity: 50

update-hologram: true
update-waypoint: true

Prochaines etapes

Waypoints et Hologrammes

Guidez les joueurs avec des waypoints et hologrammes dans zQuests

API

Documentation developpeur pour l'API zQuests

Sur cette page

Options de debugConfiguration du stockageConfiguration des commandesConfiguration de la barre de progressionConfiguration de la ligne de lorePlaceholder des quetes favoritesGroupes de quetesRecompenses globalesRecompenses personnaliseesConfiguration des evenementsFormat de dateDetection "Regarder vers"Mises a jour hologrammes et waypointsExemple completProchaines 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.