Placeholders

zQuests fournit des placeholders PlaceholderAPI pour afficher les informations de quetes partout sur votre serveur. Ces placeholders peuvent etre utilises dans les scoreboards, hologrammes, formats de chat, et bien sur dans les inventaires zMenu.

PrerequisCopier le lien vers ce titre

Pour utiliser les placeholders zQuests en dehors de zMenu, vous avez besoin de :

• PlaceholderAPI installe

Placeholders de quetesCopier le lien vers ce titre

Informations de base des quetesCopier le lien vers ce titre

Remplacez <quete> par la valeur unique name de la quete.

Exemple :

%zquests_name_casseur-pierre-1%

Progression de la queteCopier le lien vers ce titre

Placeholders de groupeCopier le lien vers ce titre

Remplacez <groupe> par l'identifiant du groupe depuis config.yml.

Quetes favoritesCopier le lien vers ce titre

Configuration de la barre de progressionCopier le lien vers ce titre

Configurez l'apparence de la barre de progression dans config.yml :

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

Resultat :

||||||||||||||||||||||||||||||  (vert : complete, gris : restant)

Configuration de la ligne de loreCopier le lien vers ce titre

Configurez le format du placeholder %zquests_lore_line_<quete>% dans config.yml :

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
• %progress% - Nombre de progression actuelle
• %goal% - Objectif de la quete

Placeholder des quetes favoritesCopier le lien vers ce titre

Configurez l'affichage du placeholder %zquests_favorite_quests% dans config.yml :

placeholder-favorite:
  # Nombre maximum de quetes favorites a afficher
  limit: 3
  # Message 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 quetesCopier le lien vers ce titre

Definissez les groupes de quetes dans config.yml pour utiliser les placeholders de groupe :

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"

Utilisation :

Progression Minage : %zquests_group_percent_minage%%

Exemples d'utilisationCopier le lien vers ce titre

Dans un scoreboardCopier le lien vers ce titre

# Exemple de configuration de scoreboard
lines:
  - "&6&lQUETES"
  - ""
  - "&fActive : &e%zquests_is_active_minage-quotidien%"
  - "&fProgression : &a%zquests_progress_minage-quotidien%&7/&f%zquests_objective_minage-quotidien%"
  - "%zquests_progress_bar_minage-quotidien%"

Dans un inventaire zMenuCopier le lien vers ce titre

items:
  info-quete:
    slot: 13
    item:
      material: "%zquests_thumbnail_casseur-pierre%"
      name: "&6%zquests_name_casseur-pierre%"
      lore:
        - "&7%zquests_description_casseur-pierre%"
        - ""
        - "%zquests_lore_line_casseur-pierre%"
        - ""
        - "&7Statut : %zquests_is_completed_casseur-pierre%"

Dans un format de chatCopier le lien vers ce titre

[Quete : %zquests_name_quete-actuelle%] %player_name% : %message%

Dans un hologrammeCopier le lien vers ce titre

# Hologramme zEssentials
lines:
  - "&6&lQUETE QUOTIDIENNE"
  - "&f%zquests_name_quete-quotidienne%"
  - ""
  - "%zquests_progress_bar_quete-quotidienne%"
  - "&7%zquests_progress_quete-quotidienne%&8/&f%zquests_objective_quete-quotidienne%"

Test des placeholdersCopier le lien vers ce titre

Testez les placeholders avec PlaceholderAPI :

/papi parse me %zquests_name_casseur-pierre%
/papi parse me %zquests_progress_casseur-pierre%
/papi parse me %zquests_is_active_casseur-pierre%

DepannageCopier le lien vers ce titre

Le placeholder affiche "Unknown"Copier le lien vers ce titre

• Verifiez que le nom de la quete est correct (sensible a la casse)
• Verifiez que la quete existe dans votre configuration
• Rechargez le plugin : /zquests reload

La barre de progression ne s'affiche pasCopier le lien vers ce titre

• Assurez-vous que progress-bar est configure dans config.yml
• Verifiez les erreurs de syntaxe YAML

Le placeholder de groupe retourne 0Copier le lien vers ce titre

• Verifiez que l'ID du groupe correspond exactement
• Verifiez que les quetes sont listees dans la configuration du groupe
• Assurez-vous que les noms de quetes correspondent a leurs valeurs name

Prochaines etapesCopier le lien vers ce titre

• Configurez les Commandes et Permissions
• Configurez les Inventaires avec les affichages de quetes
• Decouvrez les Waypoints & Hologrammes