GroupeZ Docs
Configurations

Waypoints et Hologrammes

Guidez les joueurs avec des waypoints et hologrammes dans zQuests

zQuests peut afficher des hologrammes et des waypoints pour guider les joueurs vers les objectifs de quetes. Ces fonctionnalites necessitent un plugin compatible comme zEssentials.

Prerequis

Pour utiliser les waypoints et hologrammes, vous avez besoin de :

  • zEssentials ou un autre fournisseur compatible d'hologrammes/waypoints

Configuration globale

Les deux fonctionnalites peuvent etre definies globalement dans des fichiers dedies et referencees par les quetes.

Hologrammes

Creez plugins/zQuests/holograms.yml :

holograms:
  - name: ZONE_MINAGE
    location: "world,100,65,200"
    texts:
      - "&6&lQuete de Minage"
      - "&7Cassez des minerais dans cette zone"
      - "&aSuivez la balise !"
    scale: 1.5
    billboard: VERTICAL

  - name: QUETE_PNJ
    locations:
      - "world,50,70,100"
      - "world,-50,70,-100"
    text: "&e&lParlez au villageois"
    scale: 1.2

Options des hologrammes

OptionDescriptionPar defaut
nameIdentifiant unique (requis)-
locationEmplacement unique monde,x,y,z-
locationsEmplacements multiples-
textTexte sur une ligne-
textsLignes multiples-
billboardMode de rotation : CENTER, FIXED, HORIZONTAL, VERTICALCENTER
scaleMultiplicateur de taille (valeur unique ou x,y,z)1
translation-xDecalage X0
translation-yDecalage Y0
translation-zDecalage Z0
brightness-blockNiveau de lumiere des blocs15
brightness-skyNiveau de lumiere du ciel15
shadow-radiusTaille de l'ombre du texte0
shadow-strengthIntensite de l'ombre1.0
visibility-distanceDistance de visibilite max-1 (defaut)
text-backgroundCouleur de fond (hex, nom, transparent, default)-
text-alignmentAlignement du texte : CENTER, LEFT, RIGHTCENTER
text-shadowActiver l'ombre du textefalse
see-throughVisible a travers les blocsfalse

Waypoints

Creez plugins/zQuests/waypoints.yml :

waypoints:
  - name: ZONE_MINAGE
    location: "world,100,65,200"
    texture: marqueur_quete
    color: gold

  - name: EMPLACEMENT_FERME
    location: "world,200,70,150"
    texture: icone_ferme
    color: green

Options des waypoints

OptionDescriptionPar defaut
nameIdentifiant unique (requis)-
locationEmplacement cible monde,x,y,z-
textureNom de la texture de l'icone-
colorCouleur de la balise (nom ou hex)white

Utilisation dans les quetes

Reference aux definitions globales

Referencez les hologrammes et waypoints definis globalement par leur nom :

quests:
  - type: BLOCK_BREAK
    name: "quete-minage"
    display-name: "Quete de Minage"
    goal: 100
    actions:
      - material: STONE
    hologram: ZONE_MINAGE
    waypoint: ZONE_MINAGE

Definitions en ligne

Definissez les hologrammes et waypoints directement dans la quete :

quests:
  - type: CUBOID
    name: "trouver-village"
    display-name: "Trouver le Village"
    goal: 1
    actions:
      - cuboid: "world,100,60,100,200,100,200"
    hologram:
      location: "world,150,80,150"
      texts:
        - "&6&lQuete du Village"
        - "&7Trouvez le village cache"
        - "&aCherchez la balise !"
      scale: 2
      billboard: VERTICAL
      see-through: true
    waypoint:
      location: "world,150,65,150"
      texture: marqueur_village
      color: "#FFD700"

Emplacements multiples

Affichez des hologrammes a plusieurs emplacements :

quests:
  - type: ENTITY_KILL
    name: "chasse-squelettes"
    display-name: "Chasse aux Squelettes"
    goal: 50
    actions:
      - entity: SKELETON
    hologram:
      locations:
        - "world,100,65,100"
        - "world,-100,65,100"
        - "world,100,65,-100"
        - "world,-100,65,-100"
      texts:
        - "&c&lZone Dangereuse"
        - "&7Des squelettes apparaissent ici"

Configuration dans config.yml

Controlez les mises a jour des hologrammes et waypoints :

# 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

Exemples d'hologrammes

Marqueur de quete simple

hologram:
  location: "world,100,70,200"
  text: "&e&l! Quete ici"
  scale: 1.5

Informations detaillees de quete

hologram:
  location: "world,100,72,200"
  texts:
    - "&6&lMaitre Mineur"
    - ""
    - "&7Cassez 500 blocs de pierre"
    - "&7dans cette zone pour completer"
    - "&7la quete !"
    - ""
    - "&a↓ Commencez ici ↓"
  scale: 1.2
  billboard: CENTER
  text-alignment: CENTER

Point d'interaction PNJ

hologram:
  location: "world,50,73,100"
  texts:
    - "&e&l? Parlez-moi"
    - "&7J'ai une quete pour vous !"
  scale: 1.0
  translation-y: 2.5  # Flotte au-dessus du PNJ
  billboard: CENTER

Integration pack de ressources

hologram:
  location: "world,100,70,200"
  text: "%img_marqueur_quete%"  # Image ItemsAdder/Oraxen
  scale: 3
  text-background: transparent

Exemples de waypoints

Balise simple

waypoint:
  location: "world,100,65,200"
  color: blue

Icone personnalisee

waypoint:
  location: "world,100,65,200"
  texture: quete_diamant
  color: "#00FFFF"

Commande de rafraichissement

Si les hologrammes ou waypoints ne se mettent pas a jour correctement :

/zquests refresh-hologram

Cela force un rafraichissement de tous les hologrammes et waypoints actifs.

Visibilite

Les hologrammes et waypoints sont visibles uniquement quand :

  1. La quete est active pour le joueur
  2. La quete n'est pas completee
  3. Le joueur est dans la visibility-distance (si definie)

Une fois une quete completee, les hologrammes et waypoints associes disparaissent automatiquement.

Bonnes pratiques

  1. Utilisez des noms significatifs - Nommez les definitions globales clairement (ex: MARQUEUR_QUETE_MINAGE)
  2. Hauteurs coherentes - Placez les hologrammes a des hauteurs coherentes au-dessus du sol
  3. N'en abusez pas - Trop d'hologrammes peuvent distraire
  4. Testez la visibilite - Verifiez les hologrammes du point de vue du joueur
  5. Considerez les performances - Beaucoup d'hologrammes peuvent impacter les performances du serveur

Depannage

Les hologrammes ne s'affichent pas

  1. Verifiez que zEssentials est installe et active
  2. Verifiez que les coordonnees d'emplacement sont correctes
  3. Assurez-vous que la quete est active pour le joueur
  4. Essayez /zquests refresh-hologram

Les waypoints ne fonctionnent pas

  1. Confirmez que le fournisseur de waypoints est installe
  2. Verifiez que le format d'emplacement est correct
  3. Verifiez que la quete est demarree

Hologrammes a la mauvaise position

  1. Utilisez translation-y pour ajuster la hauteur
  2. Verifiez que le nom du monde correspond exactement
  3. Verifiez les fautes de frappe dans les coordonnees

Prochaines etapes

Inventaires

Configurez les inventaires de quetes avec zMenu

config.yml

Fichier de configuration principal de zQuests

Sur cette page

PrerequisConfiguration globaleHologrammesOptions des hologrammesWaypointsOptions des waypointsUtilisation dans les quetesReference aux definitions globalesDefinitions en ligneEmplacements multiplesConfiguration dans config.ymlExemples d'hologrammesMarqueur de quete simpleInformations detaillees de quetePoint d'interaction PNJIntegration pack de ressourcesExemples de waypointsBalise simpleIcone personnaliseeCommande de rafraichissementVisibiliteBonnes pratiquesDepannageLes hologrammes ne s'affichent pasLes waypoints ne fonctionnent pasHologrammes a la mauvaise positionProchaines 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.