Informations

Cette page fournit des informations essentielles sur la configuration de zMenu et la comprehension de sa philosophie de configuration.

Comprendre YAMLCopier le lien vers ce titre

zMenu utilise YAML (YAML Ain't Markup Language) pour tous ses fichiers de configuration. Si vous etes nouveau avec YAML, voici quelques points importants a connaitre :

Regles YAML de baseCopier le lien vers ce titre

1. L'indentation compte - Utilisez des espaces (pas des tabulations) pour l'indentation
2. Espacement coherent - Utilisez 2 espaces par niveau d'indentation
3. Sensible a la casse - Material est different de material
4. Les deux-points necessitent des espaces - key: value et non key:value

Exemple de structureCopier le lien vers ce titre

# Ceci est un commentaire
inventory-name: "Mon Inventaire"    # Valeur texte
size: 54                            # Valeur numerique
enabled: true                       # Valeur booleenne

items:                              # Debut d'une section
  mon-bouton:                       # Nom du bouton (cle)
    slot: 0                         # Propriete de mon-bouton
    item:                           # Section imbriquee
      material: DIAMOND
      name: "&bDiamant"

Outils utilesCopier le lien vers ce titre

• Validateur YAML : YAML Lint - Verifiez votre syntaxe YAML
• Extension VS Code : YAML par Red Hat - Coloration syntaxique et validation
• Notepad++ : Editeur leger avec support YAML

Philosophie de configurationCopier le lien vers ce titre

zMenu suit une approche de configuration modulaire :

Organisation des fichiersCopier le lien vers ce titre

plugins/zMenu/
├── config.yml                 # Parametres globaux
├── global-placeholders.yml    # Valeurs partagees
├── commands/                  # Definitions des commandes
│   └── commands.yml
├── inventories/               # Vos menus
│   ├── menu1.yml
│   └── sousdossier/
│       └── menu2.yml
├── patterns/                  # Modeles reutilisables
├── items/                     # Items reutilisables
└── actions_patterns/          # Actions par defaut

Principes clesCopier le lien vers ce titre

1. Un inventaire par fichier - Chaque fichier YAML dans inventories/ definit un inventaire
2. Sous-dossiers supportes - Organisez les inventaires dans des sous-dossiers
3. Reutilisabilite - Utilisez les patterns et items pour eviter les repetitions
4. Rechargement a chaud - Activez le hot reload et vos modifications d'inventaire sont appliquees des que vous enregistrez le fichier, ou utilisez /zm reload pour appliquer les changements sans redemarrage

Codes couleurCopier le lien vers ce titre

zMenu supporte plusieurs formats de codes couleur :

Codes couleur classiquesCopier le lien vers ce titre

En utilisant le symbole & :

Codes de formatageCopier le lien vers ce titre

Couleurs hexadecimalesCopier le lien vers ce titre

name: "&#FF5555Ceci est rouge &#55FF55et ceci est vert"

MiniMessage (Paper/Purpur)Copier le lien vers ce titre

Si vous utilisez Paper, Purpur ou Pufferfish, vous pouvez activer le format MiniMessage dans config.yml :

enable-mini-message-format: true

Puis utilisez la syntaxe MiniMessage :

name: "<gradient:red:blue>Texte en degrade</gradient>"
lore:
  - "<rainbow>Texte arc-en-ciel !</rainbow>"
  - "<bold><gold>Texte or en gras</gold></bold>"
  - "<click:run_command:/spawn>Cliquez pour spawn</click>"

PlaceholdersCopier le lien vers ce titre

zMenu supporte les placeholders dans toutes vos configurations :

PlaceholderAPICopier le lien vers ce titre

Tout placeholder PlaceholderAPI fonctionne dans zMenu :

name: "&6Profil de %player_name%"
lore:
  - "&7Solde : &a$%vault_eco_balance%"
  - "&7Niveau : &e%player_level%"

Placeholders integres zMenuCopier le lien vers ce titre

Voir la page Placeholders pour la liste complete.

Recharger les configurationsCopier le lien vers ce titre

Apres avoir effectue des modifications, rechargez vos configurations :

/zm reload                    # Tout recharger
/zm reload config             # Recharger config.yml uniquement
/zm reload inventory [nom]    # Recharger un inventaire specifique
/zm reload command [nom]      # Recharger une commande specifique

Erreurs courantesCopier le lien vers ce titre

1. Indentation incorrecteCopier le lien vers ce titre

# Faux
items:
my-button:
  slot: 0

# Correct
items:
  my-button:
    slot: 0

2. Guillemets manquants pour les caracteres speciauxCopier le lien vers ce titre

# Faux - causera une erreur d'analyse
name: &6Mon Menu

# Correct
name: "&6Mon Menu"

3. Caracteres de tabulationCopier le lien vers ce titre

YAML n'autorise pas les tabulations. Utilisez toujours des espaces :

# Faux (tabulations)
items:
→ my-button:
→ → slot: 0

# Correct (espaces)
items:
  my-button:
    slot: 0

4. Cles dupliqueesCopier le lien vers ce titre

# Faux - le second 'slot' ecrase le premier
my-button:
  slot: 0
  slot: 1

# Correct
my-button:
  slot: 0
another-button:
  slot: 1

Encodage des fichiersCopier le lien vers ce titre

Sauvegardez toujours vos fichiers avec l'encodage UTF-8 pour supporter correctement :

• Les caracteres speciaux
• Le texte non anglais
• Les codes couleur

La plupart des editeurs de texte modernes utilisent UTF-8 par defaut, mais verifiez les parametres de votre editeur si vous rencontrez des problemes avec les caracteres speciaux.

Prochaines etapesCopier le lien vers ce titre

Maintenant que vous comprenez les bases :

1. Apprenez les Commandes et Permissions
2. Explorez les Placeholders disponibles
3. Creez votre premier inventaire