Installation

De zéro à un serveur fonctionnel avec CustomiZer en cinq minutes.

Prérequis

Configuration étape par étape

resourcepack:
  enabled: true
  url: "http://123.456.789.0"   # Votre IP publique
  port: 7270                     # Port pour le serveur HTTP du pack (ouvrez ce port dans votre pare-feu !)

Structure des dossiers après le premier démarrage

config.yml

Le fichier de configuration principal — serveur de pack de ressources, langue, messages, bonus économiques.

Paramètres du pack de ressources

C'est la section la plus importante. Elle contrôle comment le pack est construit et servi aux joueurs.

resourcepack:
  enabled: true

  # L'URL publique depuis laquelle les joueurs téléchargeront le pack.
  # Doit être accessible depuis internet. Utilisez l'IP publique ou le domaine de votre serveur.
  url: "http://YOUR.PUBLIC.IP"

  # Le port HTTP sur lequel le plugin écoute. Ouvrez ce port dans votre pare-feu.
  port: 7270

  # Version du format du pack de ressources. 46 = Minecraft 1.21.x
  format: 46

  # Optionnel : fusionner des ZIPs de packs de ressources externes dans le pack généré.
  # Les chemins sont relatifs à votre dossier plugins/.
  merge-packs:
    - "ModelEngine/resource pack.zip"

Langue & Messages

language: en   # "en" ou "fr"

# Afficher un message dans la barre d'action quand les joueurs gagnent des récompenses
hotbar_message_enabled: true
hotbar_message_format: "&a{job} XP: &b{jobsxp}  &aMoney: &b{money}"

# Afficher un message dans la barre de boss
bossbar_message_enabled: true
bossbar_message_format: "{job} | XP: {jobsxp} | Money: {money}"
bossbar_color: BLUE     # BLUE, PURPLE, YELLOW, GREEN, WHITE
bossbar_style: SOLID    # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20

Bonus de région WorldGuard

Si WorldGuard est installé et activé dans settings.yml, vous pouvez multiplier ou diviser les récompenses dans des régions spécifiques :

# Les joueurs dans "vip_mine" gagnent 2x XP et argent
Multiplier:
  vip_mine: 2.0
  elite_zone: 3.0

# Les joueurs dans "noob_area" gagnent la moitié des récompenses
Diviser:
  noob_area: 2.0

# Bonus global temporel (tous les joueurs)
GlobalBoost:
  start: "18:00"
  end: "20:00"
  multiplier: 1.5

settings.yml

Mode débogage, toggles d'intégration optionnels, et paramètres de pack spécifiques aux clients.

# Mettre à true pour des logs de débogage détaillés dans la console. Laissez false en production.
debug: false

dependencies:
  # Activer si vous avez ItemsAdder ET voulez que ses blocs personnalisés donnent
  # des récompenses CustomiZer (XP Jobs, argent, etc.)
  itemsadder_support: false

  # Activer si vous avez WorldGuard ET voulez des multiplicateurs basés sur les régions.
  worldguard_integration_support: false

  # Activer si vous avez Jobs Reborn ET voulez que les blocs personnalisés donnent des XP Jobs.
  jobs_support: false

esc_menu:
  # Quand true : les joueurs Feather Client reçoivent le pack SANS l'art du menu ESC.
  # Feather Client est détecté automatiquement. Aucune configuration nécessaire.
  ignore_feather_client: false

  # Quand true : les joueurs Lunar Client reçoivent le pack SANS l'art du menu ESC.
  # Nécessite le plugin Apollo-Bukkit.
  ignore_lunar_client: false

Comment fonctionne le pack de ressources

Comprendre ce qui se passe automatiquement pour savoir ce que vous N'avez PAS à faire.

Le processus automatique

Quand le serveur démarre (ou quand vous exécutez /z reload), CustomiZer fait tout ceci automatiquement :

Priorité du contenu

Quand deux sources essaient de définir le même fichier, cet ordre détermine lequel l'emporte :

Créer un Pack

Un guide convivial pour les débutants pour ajouter votre premier pack personnalisé.

Qu'est-ce qu'un "Pack" ?

Un pack est un dossier à l'intérieur de plugins/CustomiZer/packs/ qui contient deux choses :

• Un dossier assets/ avec vos fichiers de textures et de modèles (comme un pack de ressources Minecraft standard)
• Un dossier configs/ avec des fichiers YAML qui indiquent à CustomiZer quels objets et blocs existent dans ce pack

Étape par étape : votre premier pack

info:
  namespace: my_first_pack   # Doit correspondre au nom de votre dossier assets

items:
  ruby:
    display_name: "Ruby"
    resource:
      generate: true          # Générer automatiquement le modèle depuis la texture
      material: PAPER         # Objet vanilla utilisé comme base
      model_id: 200350        # Numéro unique — ne doit pas entrer en conflit avec d'autres packs
      textures:
        - items/ruby.png      # Relatif à assets/my_first_pack/textures/

# items/my_first_pack/gui.yml  ← affiché dans /zitems (outil admin)
name: "My First Pack"
slot: 20   # Position dans le menu principal /zitems

icon:
  pack: my_first_pack
  id: ruby
  lore:
    - "My custom items"

gui:
  title: "My First Pack"
  size: 6

items:
  - type: pack_item
    pack: my_first_pack
    id: ruby

Règles de namespace

• Le namespace dans info.namespace doit être en minuscules, sans espaces, sans caractères spéciaux
• Il doit correspondre au nom du dossier dans assets/
• Vous référencez les objets de ce pack comme namespace:item_key — par exemple my_first_pack:ruby

Éléments du pack

Définissez des objets d'affichage personnalisés dans votre pack. Il s'agit de la couche visuelle — à quoi ressemble l'objet.

Objet simple avec modèle auto-généré

Utilisez ceci quand vous avez une texture PNG plate et voulez que CustomiZer crée automatiquement un modèle d'objet Minecraft :

info:
  namespace: my_pack

items:
  # La clé "ruby" est la façon dont vous référencez cet objet partout ailleurs.
  # Format : namespace:key → "my_pack:ruby"
  ruby:
    display_name: "Ruby"   # Affiché en jeu (supporte les codes couleur)
    resource:
      generate: true        # true = générer automatiquement le modèle depuis les textures
      material: PAPER       # Matériau vanilla (PAPER est un choix courant pour les objets plats)
      model_id: 200350      # Custom Model Data (doit être globalement unique)
      textures:
        - items/ruby.png    # Dans assets/my_pack/textures/items/ruby.png

Objet avec un modèle fait à la main

Utilisez ceci quand vous avez un modèle 3D JSON pré-fait (par exemple depuis Blockbench) :

  dragon_sword:
    display_name: "Dragon Sword"
    resource:
      generate: false                        # false = utiliser le modèle à model_path
      material: IRON_SWORD                   # Utiliser un matériau d'épée pour l'animation en main
      model_path: weapons/dragon_sword       # Dans assets/my_pack/models/weapons/dragon_sword.json

Objet avec permission

Seuls les joueurs avec la permission spécifiée peuvent voir ou utiliser cet objet :

  vip_gem:
    display_name: "VIP Gem"
    permission: myserver.vip.gem   # Nœud de permission optionnel
    resource:
      generate: true
      material: PAPER
      model_id: 200351
      textures:
        - items/vip_gem.png

Référence des champs d'objet

Blocs du pack

Blocs personnalisés pouvant être placés dans le monde, utilisant les états du bloc de note sous le capot pour un placement solide réel avec des textures personnalisées.

⚠️ Deux fichiers sont toujours requis

Chaque bloc personnalisé nécessite deux fichiers de configuration séparés. C'est la chose la plus importante à comprendre :

Fichier 1 — packs/your_pack/configs/blocks.yml

Ce fichier enregistre le bloc dans le pack de ressources. Gardez-le purement visuel — textures, ID de modèle, type de placement, et sons de casse uniquement.

# packs/my_pack/configs/blocks.yml

info:
  namespace: my_pack

items:
  silver_ore:
    display_name: "Silver Ore"    # Nom de base pour le registre du pack
    resource:
      generate: true
      material: PAPER             # Toujours PAPER pour les blocs personnalisés
      model_id: 200426            # CMD unique — ne doit pas entrer en conflit avec un autre pack
      textures:
        - blocks/silver_ore.png   # Chemin dans assets/my_pack/textures/

    specific_properties:
      block:
        placed_model:
          type: REAL_NOTE         # Requis — utilise l'astuce du bloc de note
        sound:
          break:
            name: "BLOCK_STONE_BREAK"
            volume: 1
            pitch: 1

  deepslate_silver_ore:
    display_name: "Deepslate Silver Ore"
    resource:
      generate: true
      material: PAPER
      model_id: 200427            # CMD différent de silver_ore ci-dessus
      textures:
        - blocks/deepslate_silver_ore.png
    specific_properties:
      block:
        placed_model:
          type: REAL_NOTE
        sound:
          break:
            name: "BLOCK_DEEPSLATE_BREAK"
            volume: 1
            pitch: 1

Fichier 2 — CustomiZe!/your_pack/blocks.yml

Ce fichier contrôle tout le gameplay : temps de minage, résistance aux explosions, outils pouvant casser le bloc, ce qu'il drop, s'il brille, et récompenses XP Jobs. Consultez la page Blocs personnalisés (CustomiZe!) pour le format complet et toutes les options.

Outils du pack

Outils et armes vanilla retexturisés — mêmes statistiques, apparence personnalisée.

Les outils de pack sont définis exactement comme les éléments de pack, mais avec un matériau d'outil comme base. Ils héritent de toutes les statistiques vanilla (durabilité, vitesse de minage, dégâts d'attaque) de ce matériau.

info:
  namespace: my_pack

items:
  silver_sword:
    display_name: "Silver Sword"
    resource:
      generate: true
      material: IRON_SWORD    # Statistiques d'une épée en fer, texture personnalisée
      model_id: 200500
      textures:
        - tools/silver_sword.png

  silver_pickaxe:
    display_name: "Silver Pickaxe"
    resource:
      generate: true
      material: IRON_PICKAXE  # Statistiques d'une pioche en fer, texture personnalisée
      model_id: 200501
      textures:
        - tools/silver_pickaxe.png

  mythril_axe:
    display_name: "Mythril Axe"
    resource:
      generate: true
      material: DIAMOND_AXE   # Statistiques diamant
      model_id: 200502
      textures:
        - tools/mythril_axe.png

Bons choix de matériaux par type d'outil

Images de police (Glyphes)

Images PNG rendues comme caractères texte — utilisées pour les arrière-plans de GUI, badges de rang, icônes dans la description, et art du menu ESC.

Qu'est-ce qu'une image de police ?

Minecraft supporte les polices personnalisées où chaque caractère peut être remplacé par une image PNG. CustomiZer l'utilise pour afficher des images partout où le texte est affiché — y compris les titres d'inventaire, la description d'objet, le chat, les tableaux de score, et le menu ESC.

C'est ainsi que fonctionnent les arrière-plans de GUI élaborés, les icônes de rang dans le chat, et les logos du menu ESC. Ce sont tous simplement des images PNG soigneusement positionnées rendues comme des "caractères".

Définir des images de police dans un pack

Créez un font.yml (ou tout fichier .yml) dans le dossier configs/ de votre pack :

info:
  namespace: my_pack

font_images:
  my_icon:                           # Clé utilisée pour afficher cette image
    path: "font/my_icon.png"         # Dans assets/my_pack/textures/font/my_icon.png
    scale_ratio: 11                  # Taille de l'image en pixels (hauteur)
    y_position: 9                    # Décalage vertical par rapport à la ligne de base du texte

Utiliser une image de police dans le texte

Une fois définie, vous affichez l'image en utilisant la balise MiniMessage <font_image> :

title: "<font_image:my_pack:my_icon>"
# ou dans la description d'objet :
lore:
  - "<font_image:my_pack:my_coin> 500 pièces"

L'image apparaît en ligne partout où du texte apparaît — dans les titres d'inventaire, les noms d'objets, les lignes de description, les messages de chat, etc.

Glyphes de badges de rang (exemple gem_ranks)

Les images de police peuvent être soumises à permission. Quand show_in_gui: true est défini, les joueurs avec la permission requise voient leur badge de rang affiché dans le GUI :

info:
  namespace: gem_ranks

font_images:
  bronze_amethyst_i:
    permission: bronze_amethyst_i     # Le joueur a besoin de cette permission pour voir ce glyphe
    show_in_gui: true                 # Afficher dans le GUI de rang
    path: "bronze_amethyst_i"         # assets/gem_ranks/textures/bronze_amethyst_i.png
    scale_ratio: 12
    y_position: 9.5

  gold_diamond_iii:
    permission: gold_diamond_iii
    show_in_gui: true
    path: "gold_diamond_iii"
    scale_ratio: 12
    y_position: 9.5

Donnez à un joueur la permission gem_ranks.bronze_amethyst_i et il verra ce badge apparaître à côté de son nom ou dans le GUI de rang.

Images de police d'arrière-plan GUI

L'arrière-plan du GUI (l'image derrière la grille d'inventaire) est également une image de police. Elle est rendue dans le titre de l'inventaire avec des caractères de décalage de pixels spéciaux :

info:
  namespace: CustomiZerInternal

font_images:
  "1":
    path: custom/30main_gui/1    # L'image d'arrière-plan du GUI
    scale_ratio: 255             # Grande échelle = arrière-plan complet de l'inventaire
    y_position: 46
    x_position: -6.5

Puis dans le titre du GUI :

title: "<white><shift:-8><font_image:CustomiZerInternal:1>"

Le <shift:-8> est un décalage de pixel qui positionne correctement l'image d'arrière-plan.

Conseils pour les images de police

• scale_ratio : La hauteur de l'image en pixels de jeu. 11–12 est bien pour les petites icônes. 255 est utilisé pour les arrière-plans GUI plein écran.
• y_position : Déplacez l'image vers le haut ou le bas par rapport à la ligne de texte. Positif = haut, négatif = bas.
• Utilisez toujours des PNG avec transparence pour les icônes et badges.
• Testez vos glyphes en vous donnant un objet papier avec la balise de police dans son nom.

Commandes de glyphes en jeu

CustomiZer inclut un ensemble complet de commandes d'administration pour parcourir, rechercher, prévisualiser et gérer les glyphes directement en jeu. Toutes nécessitent la permission cxp.admin.

/zpack fonts

Liste chaque image de police enregistrée dans tous les packs. Affiche le nom du pack, l'ID de police, le codepoint Unicode, et la balise exacte à coller dans gui.yml :

# Exemple de sortie dans le chat :
# [CustomiZer] Images de police enregistrées (12) :
#   gem_ranks:bronze_amethyst_i  U+E000  → gui.yml: <font_image:gem_ranks:bronze_amethyst_i>
#   my_pack:my_icon              U+E001  → gui.yml: <font_image:my_pack:my_icon>

/zpack font <packName> <fontId>

Prévisualise un seul glyphe. L'envoie à votre barre d'action pour que vous puissiez voir exactement son apparence en jeu. Exécutez cette commande chaque fois que vous ajoutez une nouvelle image de police et voulez vérifier sa taille et position.

/zpack glyph list [packName]

Liste tous les glyphes enregistrés (avec les métadonnées de l'API Glyph). Ajoutez un nom de pack pour filtrer uniquement les glyphes de ce pack :

# Tous les glyphes :
/zpack glyph list

# Uniquement les glyphes de "gem_ranks" :
/zpack glyph list gem_ranks

Chaque entrée affiche le nom du pack, l'ID de police, le codepoint Unicode et deux liens cliquables — [copier balise] copie la balise <font_image:pack:id> complète prête à coller dans n'importe quel YAML, et [copier char] copie le caractère Unicode rendu lui-même. Pas besoin d'ouvrir un fichier YAML — trouvez le glyphe que vous voulez dans le chat, cliquez copier, collez-le où vous en avez besoin.

/zpack glyph <packName> <fontId>

Affiche des informations détaillées sur un glyphe spécifique — son codepoint, le caractère Unicode, et la balise YAML pour l'utiliser.

/zpack glyph search <query>

Recherche tous les glyphes enregistrés par nom. Utile quand vous avez de nombreuses images de police et ne vous souvenez pas de l'ID exact :

/zpack glyph search bronze

/zpack glyph export

Affiche des extraits YAML pour chaque glyphe enregistré. Utile si vous voulez verrouiller les codepoints pour qu'ils ne changent pas après un rechargement (copiez la sortie dans vos configs de pack).

/zpack glyph regenerate

Efface tout le registre de codepoints de glyphes et réattribue tous les codepoints de zéro. Utilisez ceci si les codepoints se sont désalignés après l'ajout ou la suppression de glyphes. Attention : les joueurs doivent re-télécharger le pack de ressources après avoir exécuté cette commande.

Intégration PlaceholderAPI

Si PlaceholderAPI est installé, vous pouvez utiliser des glyphes comme placeholders partout où PAPI est supporté :

Exemple dans un préfixe LuckPerms : [%customizer_glyph_gem_ranks_gold_i%] — cela affiche l'icône de rang or à côté du nom du joueur dans le chat.

Personnalisation du menu ESC

Remplacez le texte du menu pause vanilla (comme "Menu du jeu" et "Se déconnecter") par des images PNG personnalisées.

Comment ça fonctionne

Les boutons du menu ESC de Minecraft affichent du texte depuis les fichiers de langue — par exemple, le titre affiche la traduction de menu.game. CustomiZer injecte des caractères de police personnalisés dans ces chaînes de traduction, remplaçant le texte par vos caractères d'image PNG.

Le résultat : les joueurs ouvrent leur menu ESC et au lieu de "Menu du jeu", ils voient l'image du logo de votre serveur.

Configuration

Créez un fichier de configuration YAML dans le dossier configs/ de votre pack :

info:
  namespace: my_esc_pack

minecraft_lang_overwrite:
  esc_menu_texts:
    entries:
      # Remplacer le titre "Menu du jeu" par votre image de logo
      "menu.game": ":top_logo_1::offset_-1:"

      # Remplacer le texte du bouton "Se déconnecter" par une image de bannière personnalisée
      "menu.disconnect": ":offset_-10::offset_-256::bottom_banner::offset_-256:"

    # Appliquer à tous les fichiers de langue (ALL), ou à des spécifiques : [en_us, fr_fr]
    languages:
      - ALL

    # Pour les joueurs Lunar Client (nécessite Apollo-Bukkit) :
    # Définissez ceci sur l'emplacement de ressource de la même image de logo
    apollo_icon: "my_esc_pack:textures/top_logo_1.png"

La syntaxe des tokens

Dans la valeur de la chaîne, vous utilisez des tokens entourés de deux-points :

• :my_image_key: — affiche l'image de police définie comme my_image_key dans votre font.yml
• :offset_-256: — déplace le curseur vers la gauche de 256 pixels (utilisé pour positionner les images)
• :offset_10: — déplace le curseur vers la droite de 10 pixels

Compatibilité client

Le dossier CustomiZe!

Où vous configurez les mécaniques de gameplay — complètement séparé du système de packs visuels.

Pourquoi est-il séparé ?

Le dossier packs/ gère l'apparence — textures, modèles, sons. Le dossier CustomiZe!/ gère le comportement — comment les objets fonctionnent dans le jeu.

Cette séparation existe parce que de nombreux serveurs veulent utiliser des packs de ressources tiers (achetés ou téléchargés) exactement tels quels, sans les modifier. En gardant la configuration de comportement séparée, vous pouvez utiliser les textures de n'importe quel pack tout en contrôlant entièrement le fonctionnement de ces objets sur votre serveur.

Structure des dossiers

Comment la fusion fonctionne

Tous les fichiers CustomiZe!/*/swords.yml sont fusionnés en profondeur au moment du chargement. __global__ se charge en premier, puis chaque dossier de pack par ordre alphabétique. Cela signifie :

• Vous pouvez ajouter des épées spécifiques au pack dans CustomiZe!/my_pack/swords.yml sans toucher au fichier global
• Les objets/blocs/épées/etc. de tous les packs sont combinés en une grande liste
• Si deux fichiers définissent la même clé, le fichier chargé en dernier l'emporte (ordre alphabétique)

Référence rapide — quel fichier pour quoi ?

Objets personnalisés

Objets utilisables avec actions au clic, temps de recharge, utilisations limitées et effets alimentaires.

Qu'est-ce qu'un objet personnalisé ?

Un objet personnalisé est tout objet qui fait quelque chose de spécial au clic droit (ou quand on le mange). Exemples : un parchemin qui exécute une commande, une potion de santé qui restaure des cœurs, un sac d'argent qui donne de la monnaie, un aliment qui applique des effets de potion.

Les objets personnalisés sont définis ici. La texture provient d'un élément de pack dans packs/. Vous les connectez en faisant correspondre le numéro MODELDATA au model_id dans votre pack.

Exemple complet

items:
  teleport_scroll:
    TYPE: PAPER                     # Matériau vanilla (doit correspondre au matériau de l'élément de pack)
    NAME: "&d✦ Teleport Scroll"
    LORE:
      - "&7Right-click to teleport to spawn."
      - "&8Cooldown: 30 seconds"
      - "&8Uses: &f%uses% &8remaining"
    MODELDATA: 12000               # Doit correspondre au model_id dans votre définition d'élément de pack
    COOLDOWN: 30                   # Secondes entre les utilisations
    USE: 5                         # L'objet se casse après 5 utilisations (-1 = illimité)
    INTERACTS:
      - RIGHT_CLICK_AIR
      - RIGHT_CLICK_BLOCK
    ACTION:
      TYPE: COMMAND
      COMMAND: "spawn %player%"    # %player% est remplacé par le nom du joueur

Tous les types d'ACTION

Options INTERACTS

Contrôle quels clics déclenchent l'action :

Objets alimentaires

N'importe quel objet peut être rendu comestible — même le PAPIER. Ajoutez un bloc FOOD et définissez ACTION TYPE: EAT :

items:
  magic_herb:
    TYPE: PAPER
    NAME: "&aMagic Herb"
    LORE:
      - "&7Eat to gain Regeneration and Speed."
    MODELDATA: 12010
    COOLDOWN: 0
    USE: -1
    INTERACTS: []       # Vide — manger déclenche l'action, pas le clic
    ACTION:
      TYPE: EAT
    FOOD:
      NUTRITION: 4              # Barres de faim restaurées (2 = un pilon)
      SATURATION: 0.6           # Saturation ajoutée (0.0–1.0)
      CAN_ALWAYS_EAT: true      # Le joueur peut manger ceci même s'il n'a pas faim
      EFFECTS:
        - effect: REGENERATION
          duration: 200          # ticks (20 ticks = 1 seconde, donc 200 = 10 secondes)
          amplifier: 1           # 0 = Niveau I, 1 = Niveau II, 2 = Niveau III
          chance: 1.0            # 100% de chance
        - effect: SPEED
          duration: 100          # 5 secondes
          amplifier: 0           # Vitesse I
          chance: 0.5            # 50% de chance — peut ne pas s'appliquer !

Placeholders de description

Dans la description de l'objet, vous pouvez utiliser %uses% pour afficher les utilisations restantes dynamiquement. Les codes couleur (&a, &6, etc.) et les balises MiniMessage fonctionnent dans NAME et LORE.

Épées & Haches personnalisées

Armes personnalisées avec attributs, enchantements, effets de coup, dégâts élémentaires et vol de vie. Chaque fonctionnalité listée ci-dessous est optionnelle — une épée n'a besoin d'aucune configuration spéciale pour fonctionner comme un simple objet personnalisé.

Toutes les clés de configuration

Attributs

Écrits comme une map plate sous attributes:. Les valeurs s'ajoutent aux statistiques par défaut du matériau de base. Tous sont optionnels — incluez uniquement ce dont vous avez besoin.

Enchantements

Écrits comme section enchantments: avec nom d'enchantement (clé de registre Bukkit) → niveau :

enchantments:
  sharpness: 5
  unbreaking: 3
  looting: 2
  fire_aspect: 2
  knockback: 2
  sweeping_edge: 3

Effets de coup (effects-enemy / effects-self)

Chaque entrée sous effects-enemy ou effects-self est une clé d'effet de potion avec deux sous-clés :

Le nom de l'effet est la clé de registre Bukkit PotionEffectType. Les plus courants :

Dégâts élémentaires

Définissez elemental_damage sur l'une de ces valeurs. Chacune déclenche un effet différent au coup :

Vol de vie

Le vol de vie est automatique quand le bloc rarity est présent — vous ne le configurez pas manuellement. Le montant s'adapte au niveau de rareté actuel :

Placeholders de description

Exemple minimal (sans niveaux)

swords:
  fire_sword:
    type: IRON_SWORD
    display_name: "&c&l🔥 Fire Sword"
    durability: 3000
    HIDE-ENCHANTS: true
    lore:
      - "&7A sword kissed by flame."
      - "&8Durability: %custom_durability% / %max_custom_durability%"
    attributes:
      GENERIC_ATTACK_DAMAGE: 8.0
      GENERIC_ATTACK_SPEED: 1.8
    enchantments:
      unbreaking: 3
      looting: 2
    effects-enemy:
      slowness:
        chance: 0.5        # 50% de chance par coup
        duration: 60       # 3 secondes
    elemental_damage: Fire

Exemple complet (avec niveaux de rareté)

swords:
  dragon_blade:
    type: IRON_SWORD
    display_name: "&4Dragon Blade"
    durability: 5000
    HIDE-ENCHANTS: true
    lore:
      - "&8Rarity: %rarity%"
      - "&8Progress: %progress% / %required% kills"
      - "&8Durability: %custom_durability% / %max_custom_durability%"
    attributes:
      GENERIC_ATTACK_DAMAGE: 10.0
      GENERIC_ATTACK_SPEED: 1.6
    enchantments:
      sharpness: 3
      looting: 2
    effects-enemy:
      slowness:
        chance: 0.40
        duration: 60
      weakness:
        chance: 0.25
        duration: 100
    effects-self:
      strength:
        chance: 0.15
        duration: 120
    elemental_damage: Fire

    # Supprimez entièrement ce bloc rarity si vous ne voulez pas de niveaux
    rarity:
      common:
        custom_model_data: 32001
        name: "&7Common Dragon Blade"
      rare:
        custom_model_data: 32002
        name: "&9Rare Dragon Blade"
      epic:
        custom_model_data: 32003
        name: "&5Epic Dragon Blade"
      legendary:
        custom_model_data: 32004
        name: "&6Legendary Dragon Blade"
      mythical:
        custom_model_data: 32005
        name: "&dMythical Dragon Blade"

Armures personnalisées

Pièces d'armure avec bonus de statistiques, effets de potion quand portées, cosmétiques de marque d'armure, et modèles 3D équipables.

Toutes les clés de configuration

Attributs

Les attributs sont une liste. Chaque entrée est une map avec trois clés : attribute, amount, et operation. Tous sont liés à l'emplacement d'équipement de l'armure automatiquement.

Opérations d'attribut

Effets de potion (pendant que portée)

Chaque entrée dans potion_effects est une map avec trois clés :

Marque d'armure

Ajoute une superposition de motif purement cosmétique sur la texture de l'armure. Les deux clés sont requises si vous incluez la section trim.

trim:
  material: GOLD         # Couleur de la marque (GOLD, IRON, DIAMOND, NETHERITE, etc.)
  pattern: WAVY          # Motif de marque (SENTRY, DUNE, COAST, WILD, WARD, EYE, VEX, TIDE,
                         # SNOUT, RIB, SPIRE, SILENCE, FLOW, BOLT, WAVY, SHAPER, RAISER, HOST)

Équipable (Modèle 3D porté)

La section equippable définit un modèle 3D qui apparaît sur le corps du joueur quand il porte l'armure. Nécessite des clients Minecraft 1.21.4+.

equippable:
  model: "my_pack:dragon_armor"               # Emplacement de ressource du modèle équipable
  equip_sound: "minecraft:item.armor.equip_diamond"  # Son lors de l'équipement

Exemple complet

custom_armors:
  dragon_helmet:
    pack_id: "my_pack:dragon_helmet"   # Tire matériau + CMD de PackManager

    display_name: "&4&lDragon Helmet"
    lore:
      - "&7Forged from dragonscale."
      - "&8+4 Max Health | +3 Armor"

    attributes:
      - attribute: GENERIC_MAX_HEALTH
        amount: 4.0
        operation: ADD_NUMBER        # +2 cœurs supplémentaires
      - attribute: GENERIC_ARMOR
        amount: 3.0
        operation: ADD_NUMBER

    potion_effects:
      - effect: fire_resistance
        duration: 999999             # Permanent pendant le port
        amplifier: 0                 # Niveau I
      - effect: night_vision
        duration: 999999
        amplifier: 0

    trim:
      material: GOLD
      pattern: WAVY

    equippable:
      model: "my_pack:dragon_armor"
      equip_sound: "minecraft:item.armor.equip_diamond"

Blocs personnalisés — Côté gameplay

Ce fichier contrôle tout ce qui se passe quand un bloc personnalisé est placé ou miné — dureté, résistance aux explosions, drops, outils requis, émission de lumière, nom d'affichage, description, sons, particules et XP Jobs. C'est le complément de packs/blocks.yml qui gère uniquement les textures.

La règle des deux fichiers (rappel rapide)

Configuration complète de bloc

Voici un exemple complet montrant chaque option disponible pour un bloc. N'utilisez que les champs dont vous avez besoin — la plupart sont optionnels.

# CustomiZe!/my_pack/blocks.yml

blocks:
  silver_ore:
    # Lie cette entrée à packs/my_pack/configs/blocks.yml → silver_ore
    # Format : "namespace:item_key"  (namespace = valeur info.namespace du pack)
    pack_id: "my_pack:silver_ore"

    # Nom d'affichage riche montré dans la description et les messages de casse.
    # Supporte les balises MiniMessage (dégradés, couleurs, gras, etc.)
    display_name: "Silver Ore"

    # Lignes de description affichées quand le bloc est dans la main du joueur.
    lore:
      - "A pale metallic ore."
      - "▸ Drops Raw Silver when mined."

    # Temps de minage — reflète les valeurs de dureté vanilla.
    # Plus élevé = plus lent à miner. Omis = utilise le timing vanilla NOTE_BLOCK (très rapide).
    # Référence : stone=1.5, iron_ore=3.0, deepslate_ore=4.5, obsidian=50.0
    hardness: 3.0

    # Résistance aux explosions. Les blocs avec cette valeur sont entièrement protégés
    # de la TNT, des creepers et autres explosions. Omis = permet la destruction.
    blast_resistance: 3.0

    # Niveau d'émission de lumière (0 = pas de lumière, 15 = lumière niveau torche).
    # Quand supérieur à 0, le serveur place un bloc LIGHT caché pour que la vraie
    # lumière se propage. Les joueurs voient toujours la texture du minerai, pas le bloc de lumière.
    light_level: 8

    # Si le bloc drop son propre objet quand cassé.
    # false = utiliser la liste de drops ci-dessous (recommandé pour les minerais)
    # true  = l'objet bloc lui-même drop (bon pour les blocs décoratifs)
    drop_self: false

    # ── Quels outils peuvent casser ce bloc ──────────────────────────────────
    # Listez les noms de matériaux vanilla et/ou les IDs de pioches personnalisées de pickaxes.yml.
    # Omettez cette clé → n'importe quel outil fonctionne (y compris la main nue).
    # Définissez à une liste vide [] → complètement indestructible en survie.
    break_with:
      - IRON_PICKAXE
      - GOLDEN_PICKAXE
      - DIAMOND_PICKAXE
      - NETHERITE_PICKAXE
      - silver_lithium_pickaxe    # Une clé de pioche personnalisée de CustomiZe!/pickaxes.yml

    # ── Ce que le bloc drop quand cassé ──────────────────────────────────
    # Plusieurs drops sont tous lancés indépendamment (chacun a sa propre chance).
    drops:
      # type: plugin_item — un objet personnalisé défini dans CustomiZe!/items.yml
      - type: plugin_item
        item: "my_pack:raw_silver"   # format : "pack_namespace:item_key"
        amount: 1                     # montant exact
        chance: 100                   # 100 = drop toujours

      # Utilisez amount_min / amount_max pour une plage aléatoire :
      - type: plugin_item
        item: "my_pack:silver_shard"
        amount_min: 0
        amount_max: 2
        chance: 40                    # 40% de chance de dropper 0–2 éclats

      # type: vanilla — tout nom de matériau Bukkit standard
      - type: vanilla
        item: EXPERIENCE_BOTTLE
        amount_min: 1
        amount_max: 1
        chance: 20                    # 20% de chance

      # type: command — exécute une commande console quand ce bloc est cassé
      # %player% est remplacé par le nom du casseur
      - type: command
        command: "eco give %player% 5"
        chance: 50                    # 50% de chance de donner 5 pièces

    # Son optionnel joué au casseur quand le bloc est miné.
    # Utilisez n'importe quelle clé de son Minecraft (complétion auto avec /playsound).
    soundeffectonmined: "block.amethyst_block.break"

    # Effet de particule optionnel affiché quand le bloc est miné.
    # Utilisez n'importe quel nom d'enum Bukkit Particle.
    visualeffectonmined: "VILLAGER_HAPPY"


  # ── Exemple de bloc décoratif (drop_self: true) ──────────────────────────
  oak_beam:
    pack_id: "my_pack:oak_beam"
    display_name: "&fOak Beam"
    lore:
      - "&7A decorative oak wood beam."
    hardness: 2.0            # Mine à la vitesse des bûches
    blast_resistance: 2.0
    drop_self: true          # Drop l'objet bloc lui-même (pas besoin de liste de drops)
    break_with:
      - HAND                 # Peut être cassé à la main nue
      - WOODEN_AXE
      - STONE_AXE
      - IRON_AXE
      - GOLDEN_AXE
      - DIAMOND_AXE
      - NETHERITE_AXE


# ── Récompenses XP et argent ─────────────────────────────────────────────────────
# Fonctionne pour VOS blocs de pack personnalisés ET les blocs Minecraft vanilla.
# Ajoutez cette section n'importe où dans le fichier (ou dans __global__/blocks.yml).
xp_values:

  # Bloc personnalisé : utilisez "namespace:item_key" (identique à pack_id ci-dessus)
  my_pack:silver_ore:
    name: "Silver Ore"
    jobsxp: 8.0              # XP donné au job du plugin Jobs
    job: "Miner"             # Le nom du job Jobs (doit correspondre à votre config jobs)
    money: 5.0               # Argent économique Vault donné au joueur
    points: 2.0              # Points de serveur / monnaie personnalisée
    cancel-vanilla-drops: false   # true = arrête les drops vanilla (utile pour les minerais personnalisés)

  # Bloc vanilla : utilisez le nom de matériau Bukkit
  COAL_ORE:
    name: "Coal Ore"
    jobsxp: 2.0
    job: "Miner"
    money: 1.0
    points: 0.5
    cancel-vanilla-drops: false

Tous les champs en un coup d'œil

Types de drops

Pioches personnalisées

Pioches qui montent de niveau quand les joueurs minent — chaque niveau débloque de nouvelles textures, un minage en zone et des effets de Hâte.

Comment fonctionne la progression des pioches

Chaque pioche suit combien de blocs le joueur a minés avec elle. Quand le compte atteint blocks_required pour le niveau actuel, la pioche se met automatiquement à niveau. L'amélioration :

• Change le Custom Model Data → nouvelle texture apparaît
• Augmente la durabilité, le rayon de minage et le niveau d'effet
• Met à jour la description pour afficher les nouvelles statistiques
• Notifie le joueur

Exemple de configuration complète

pickaxes:
  tier_pickaxe:
    type: DIAMOND_PICKAXE
    display_name: "⛏ Tier Pickaxe"
    lore:
      - "⛏ Level: %level% / %max_level%"
      - "Blocks mined: %blocks_mined% / %blocks_required%"
      - "Durability: %current_durability% / %max_durability%"
      - "Mining area: %radius%×%radius%"
      - "%bonuses%"

    levels:
      # Niveau 1 — Tier de départ
      1:
        name: "⛏ Tier Pickaxe [Lvl. 1]"
        custom_model_data: 30041        # Texture pour le niveau 1 (aspect bois)
        durability: 2000
        radius: 1                       # Mine 1×1 (juste le bloc sur lequel vous cliquez)
        height_radius: 0                # 0 = seulement le niveau de hauteur exact miné
        effect_on_hold: haste
        effect_amplifier: 0             # 0 = Hâte I
        blocks_required: 200            # Minez 200 blocs pour atteindre le niveau 2
        bonus:
          - "• Haste I while held"

      # Niveau 2
      2:
        name: "⛏ Tier Pickaxe [Lvl. 2]"
        custom_model_data: 30042        # Nouvelle texture (aspect pierre)
        durability: 4000
        radius: 1
        height_radius: 1               # Mine 1 bloc au-dessus et en-dessous aussi (3 de hauteur)
        effect_on_hold: haste
        effect_amplifier: 0
        blocks_required: 500
        bonus:
          - "• Haste I while held"
          - "• 1×3 column mining"

      # Niveau 3
      3:
        name: "⛏ Tier Pickaxe [Lvl. 3]"
        custom_model_data: 30043        # Nouvelle texture (aspect fer)
        durability: 7000
        radius: 3                       # Mine une zone 3×3
        height_radius: 1
        effect_on_hold: haste
        effect_amplifier: 1             # Hâte II
        blocks_required: 1000
        bonus:
          - "• Haste II while held"
          - "• 3×3 area mining"

      # Niveau 4 — Tier final
      4:
        name: "⛏ Tier Pickaxe [Lvl. 4]"
        custom_model_data: 30044        # Nouvelle texture (aspect diamant/netherite)
        durability: 12000
        radius: 3
        height_radius: 3               # Mine une zone de 3×7 de hauteur
        effect_on_hold: haste
        effect_amplifier: 1
        blocks_required: 0             # 0 = NIVEAU MAX, pas d'amélioration supplémentaire
        bonus:
          - "• Haste II while held"
          - "• 3×7 area mining"
          - "• MAX LEVEL"

Toutes les clés de configuration par niveau

Placeholders de description

Houes moissonneuses

Houes à récolte automatique et replantation automatique avec un système de niveaux basé sur l'XP, des tables de drops personnalisées et une vente automatique via l'économie Vault. Le système de niveaux est intégré.

Comment fonctionnent les houes moissonneuses

Quand un joueur fait un clic droit sur une culture avec une houe moissonneuse configurée, le plugin :

1. Vérifie si le type de culture est dans supported-crops pour cette houe
2. Récolte la culture et drop optionnellement des objets personnalisés (depuis la table drops)
3. Si auto-replant est activé, replante la culture à replant-growth-stage
4. Si auto-sell est activé, dépose de l'argent pour la récolte directement dans la balance du joueur
5. Accorde de l'XP depuis xp-values et vérifie experience.level-up-requirements pour une montée de niveau
6. Décrémente uses de 1. Quand les utilisations atteignent 0, la houe se casse.

Clés de houe de niveau supérieur

Cultures supportées (supported-crops)

Utilisez les noms de matériaux de blocs Minecraft vanilla :

Capacités (système de niveaux)

La section abilities est là où vit le système de niveaux. Chaque sous-clé est un nom de niveau (ex. level-0, level-1). level-0 est l'état de départ quand la houe est créée. Le plugin monte au prochain nom de niveau quand les seuils XP sont atteints.

Clés de capacité par niveau

Montée de niveau XP (experience)

La section experience.level-up-requirements mappe les noms de niveaux aux totaux XP cumulatifs. Quand l'XP accumulé du joueur atteint le seuil, la houe monte automatiquement à ce niveau :

experience:
  level-up-requirements:
    level-1: 100     # Atteindre 100 XP → monter au level-1
    level-2: 300     # Atteindre 300 XP total → monter au level-2
    level-3: 600     # Atteindre 600 XP total → monter au level-3

L'XP est gagné par récolte. Le montant provient de xp-values :

xp-values:
  WHEAT: 5           # +5 XP par blé récolté
  CARROTS: 7         # +7 XP par carotte
  POTATOES: 6        # +6 XP par pomme de terre
  CUSTOM_CROP: 3     # XP pour toute culture personnalisée (du système de cultures de CustomiZer)

Table de drops personnalisée (drops)

Définit quels objets droppent quand une culture est récoltée. Organisée par matériau de culture → entrées de drop nommées :

drops:
  WHEAT:                          # Type de culture
    wheat_item:                   # N'importe quelle clé unique pour cette entrée de drop
      item: WHEAT                 # Nom de matériau vanilla OU mappage vanilla
      chance: 1.0                 # Probabilité 0.0–1.0 (1.0 = 100%)
      quantity: 1                 # Combien dropper
    seeds:
      item: WHEAT_SEEDS           # Graines de blé comme drop bonus
      chance: 0.5                 # 50% de chance
      quantity: 2

  CARROTS:
    carrot_drop:
      item: CARROT                # Note : le plugin mappe automatiquement le bloc CARROTS → objet CARROT
      chance: 1.0
      quantity: 1
    bonus_carrot:
      item: CARROT
      chance: 0.3
      quantity: 3

Prix de vente automatique (economy)

Requis si un niveau de capacité a auto-sell: true. Le prix est par unité, multiplié par le drop-multiplier du niveau actuel :

economy:
  sell-prices:
    WHEAT: 50.0        # 50 pièces par blé
    CARROTS: 75.0
    POTATOES: 60.0
    BEETROOTS: 45.0

Messages

Toutes les clés de message sont optionnelles. Si non défini, aucun message n'est envoyé pour cet événement.

Placeholders de description

Un seul placeholder spécial existe pour la description de houe :

Exemple complet

hoes:
  harvest_hoe:
    base-item: GOLDEN_HOE
    custom-model-data: 10000        # CMD de départ (le CMD level-0 surcharge ceci)
    name: "🌾 Harvest Hoe"
    uses: 100                       # Utilisations de base au niveau-0

    supported-crops:
      - WHEAT
      - CARROTS
      - POTATOES
      - BEETROOTS

    xp-values:
      WHEAT: 5
      CARROTS: 7
      POTATOES: 6
      BEETROOTS: 4

    experience:
      level-up-requirements:
        level-1: 100
        level-2: 300
        level-3: 700

    drops:
      WHEAT:
        wheat:
          item: WHEAT
          chance: 1.0
          quantity: 1
        seeds:
          item: WHEAT_SEEDS
          chance: 0.4
          quantity: 1

    abilities:
      level-0:
        name: "&7🌾 Harvest Hoe [Lv.0]"
        lore:
          - "&8Uses: &f<uses>"
          - "&7Harvest crops automatically."
        model-data: 10000
        use-multiplier: 1
        drop-multiplier: 1
        auto-sell: false
        auto-replant: true
        replant-growth-stage: 0

      level-1:
        name: "&a🌾 Harvest Hoe [Lv.1]"
        lore:
          - "&8Uses: &f<uses>"
          - "&7+50% drops | Auto-replant"
        model-data: 10001           # Nouvelle texture
        use-multiplier: 2           # 100 × 2 = 200 utilisations à ce niveau
        drop-multiplier: 2          # 50% de drops en plus (entier, double effectivement)
        auto-sell: false
        auto-replant: true

      level-2:
        name: "&6🌾 Harvest Hoe [Lv.2]"
        lore:
          - "&8Uses: &f<uses>"
          - "&7Auto-sell enabled | Double drops"
        model-data: 10002
        use-multiplier: 3           # 100 × 3 = 300 utilisations
        drop-multiplier: 2
        auto-sell: true             # Cultures vendues directement dans le portefeuille
        auto-replant: true

economy:
  sell-prices:
    WHEAT: 50.0
    CARROTS: 75.0
    POTATOES: 60.0
    BEETROOTS: 45.0

messages:
  exp-gain: "&aGained &f{amount} &aXP! &8Total: &f{total}"
  level-up: "&6🎉 Your {hoe} levelled up to &e{level}&6!"
  auto-sell: "&aAuto-sold crops for &6{amount} coins."

Cosmétiques

Objets décoratifs portables — chapeaux, objets de dos, ailes — que les joueurs peuvent équiper sans remplacer leur armure.

cosmetics:
  cool_hat:
    pack_id: "my_pack:cool_hat"      # Référence l'élément de pack pour la texture
    display_name: "✦ Cool Hat"
    slot: hat                         # Où équiper : hat | back | wings | offhand
    lore:
      - "A very stylish hat."
      - "Right-click to equip or swap!"
    permission: "myserver.hats.cool"  # Optionnel — seuls les joueurs avec cette perm peuvent l'utiliser

  angel_wings:
    pack_id: "my_pack:angel_wings"
    display_name: "🪶 Angel Wings"
    slot: back

Sacs à dos

Objets sac à dos physiques qui ouvrent un inventaire persistant. L'inventaire est lié à l'objet, pas au joueur — échangez le sac à dos pour transférer tout son contenu.

Comment ça fonctionne

• Chaque objet sac à dos reçoit un UUID unique marqué dans son PDC (customizer:backpack_instance_uuid) lors de l'attribution.
• L'inventaire est stocké par cet UUID (SQLite ou MongoDB) — donc deux sacs à dos du même type ont des inventaires séparés.
• Les joueurs exécutent /backpack en tenant le sac à dos dans leur main secondaire (ou en le portant sur le plastron) pour l'ouvrir.
• Les hoppers et plugins ne peuvent pas déplacer des objets vers ou depuis un inventaire de sac à dos ouvert.

storage:
  type: sqlite          # "sqlite" ou "mongodb"
  sqlite:
    file: db/backpacks.db  # stocké dans plugins/CustomiZer/db/

backpacks:
  adventure_backpack_1:
    pack_id: "elitecreatures:adventure_backpack_cosmetic_backpack_1"
    display_name: "<gold><bold>🎒 Adventure Backpack I"
    slots: 18           # 9, 18, 27, 36, 45, ou 54  (ou utilisez rows: 1-6)
    permission: "myserver.backpack.tier1"   # optionnel
    lore:
      - "<dark_gray>18 emplacements"
      - "<gray>Portez sur la poitrine ou tenez en main secondaire, exécutez <yellow>/backpack"

  large_backpack:
    pack_id: "elitecreatures:large_backpack"
    display_name: "<green>🎒 Large Backpack"
    rows: 4             # équivalent à slots: 36

Donner des sacs à dos

Ajoutez le sac à dos comme entrée type: backpack dans votre gui.yml — il apparaîtra dans /zitems et cliquer dessus donne l'objet physique (avec UUID marqué et description appliquée) :

items:
  - type: backpack
    pack: elitecreatures
    id: adventure_backpack_cosmetic_backpack_1
    name: "<gold><bold>🎒 Adventure Backpack I"
    lore:
      - "<dark_gray>18 emplacements"
      - "<gray>Tenez en main secondaire → /backpack"

Backends de stockage

Emplacements de gemmes

Un système d'emplacements où les joueurs insèrent des gemmes dans les armes et armures pour des bonus de statistiques qui s'usent avec le temps.

Exemple — Steve insère une 🔥 Rune de Feu dans son épée

Un guide complet de la façon dont un joueur utilise /zsocket du début à la fin. La Rune de Feu ajoute +2.5 Dégâts d'attaque, elle va donc dans une arme.

Référence de configuration

socket_char: "◈"
empty_socket_lore: "◈ Empty Socket"
max_sockets: 4

# Utilisations par défaut pour les gemmes qui ne définissent pas les leurs. -1 = illimité.
default_max_uses: -1

gem_decay:
  enabled: true
  interval_seconds: 60   # 1 utilisation consommée par minute de temps équipé

gems:
  water_rune:
    display_name: "💧 Water Rune"
    type: PAPER
    model_data: 200377
    tier: 2
    stat: armor
    value: 1.5
    max_uses: 100          # -1 pour illimité
    lore:
      - "Tier: Awakened"
      - "+1.5 Armor when socketed."

Sets d'armures

Équipez N pièces d'armure correspondantes pour débloquer des bonus — effets de potion, commandes console et messages. Les bonus s'activent et se désactivent automatiquement quand les pièces sont équipées ou retirées.

Comment fonctionnent les sets

Chaque pièce d'armure enregistrée dans armors.yml a une clé unique (ex. dragon_helmet). Le fichier sets.yml regroupe ces clés en sets et définit ce qui se passe à chaque seuil (2 pièces équipées, 3 pièces, 4 pièces, etc.).

Chaque fois qu'un joueur équipe ou retire une armure, le plugin :

1. Compte combien de pièces de chaque set le joueur a équipé
2. Compare le nouveau compte au précédent
3. Si le compte a dépassé un seuil vers le haut → applique des effets, exécute des commandes, envoie le message d'activation
4. Si le compte a dépassé un seuil vers le bas → supprime les effets, envoie le message de désactivation

Clés de configuration

Clés de map d'effet de potion

Exemple complet

sets:
  dragon:
    pieces:
      - dragon_helmet
      - dragon_chestplate
      - dragon_leggings
      - dragon_boots

    bonuses:
      "2":                                         # Porter 2 pièces sur 4
        message: "&c&l★ 2-Piece Dragon: &fStrength I active!"
        potion_effects:
          - effect: strength
            duration: 999999                       # Permanent pendant le port
            amplifier: 0                           # Force I

      "4":                                         # Bonus de set complet
        message: "&4&l★ Full Dragon Set! &cFire Resistance + Strength II!"
        potion_effects:
          - effect: fire_resistance
            duration: 999999
            amplifier: 0
          - effect: strength
            duration: 999999
            amplifier: 1                           # Force II (surcharge Force I à 2 pièces)
        commands:
          - "broadcast &4{player} &ca assemblé le Dragon Set complet !"

Cultures personnalisées

Cultures persistantes à plusieurs stades avec des modèles générés ou personnalisés, des conditions de croissance configurables, des hitboxes dynamiques, des effets de stade, des tables de loot selon l'âge, des objets de récolte comestibles et des événements de plugin.

Ce que fait le système de cultures

1. Analyse chaque dossier dans plugins/CustomiZer/packs/ pour une disposition de culture Models/ ou Textures/.
2. Détecte les stades de chaque culture depuis les fichiers de modèle ou de texture correctement nommés.
3. Attribue des valeurs CustomModelData stables pour la graine et chaque stade. Les attributions sont sauvegardées et réutilisées après les redémarrages.
4. Crée un objet graine plantable tagué avec l'ID de culture.
5. Affiche la culture plantée avec un ItemDisplay basé sur des paquets et utilise une entité Interaction invisible comme hitbox cliquable.
6. Vérifie la croissance toutes les 30 secondes, change le modèle et la hitbox à mesure que l'âge augmente, et sauvegarde les cultures placées à travers les redémarrages.
7. Lance une table de loot selon l'âge quand la culture est cliquée droit ou cassée.

Cycle de vie de la culture en jeu

Les captures d'écran suivantes montrent le cycle de vie visible complet : planter une graine, pousser à travers les modèles configurés, atteindre le stade final, et casser une tomate mature pour recevoir son drop de tomate configuré.

1. Planter la graine (Âge 0)

Faites un clic droit sur le placement.bottom_block configuré avec la graine taguée de la culture. La graine est consommée en mode Survie et le premier modèle de culture apparaît dans le bloc vide au-dessus.

2. Pousser à travers les stades

À mesure que les vérifications de croissance réussissent, chaque culture avance d'un âge à la fois. Son modèle et sa hitbox cliquable se mettent à jour pour correspondre au nouveau stade. Ce champ d'exemple montre plusieurs cultures personnalisées à différents stades de croissance.

3. Stade final (prêt à la récolte)

Quand une culture atteint son âge le plus élevé détecté, elle utilise le modèle du stade final. Si ready_effect est configuré, des particules marquent la culture comme mature et continuent d'apparaître à chaque vérification de croissance pendant qu'elle reste prête.

Exemple de drop de tomate

Dans cet exemple, le plant de tomate mature mis en évidence correspond à une entrée de loot configurée avec item: "pack:my_farm_pack:tomato" et une condition d'âge au stade final.

Avant la casse

La culture de tomate mature est encore plantée et affiche son modèle final.

Après la casse

La culture est retirée et l'objet tomate personnalisé configuré drop naturellement à son emplacement.

Créer un pack de cultures

Créez un dossier de pack et choisissez une des deux dispositions visuelles supportées. Si un pack contient un répertoire Models/, le scanner le préfère et n'analyse pas le répertoire Textures/ de ce pack pour les cultures.

Option A : Textures PNG (Modèles automatiques)

plugins/CustomiZer/packs/my_farm_pack/
├── Textures/
│   └── tomato/
│       ├── tomato_crop_stage0.png
│       ├── tomato_crop_stage1.png
│       └── tomato_crop_stage2.png
└── configs/
    └── tomato.yml

Le modèle exact de texture est <crop-id>_crop_stage<age>.png. CustomiZer génère :

• Un modèle d'objet graine plat utilisant la texture du stade 0.
• Un modèle de culture en plans croisés pour chaque stade détecté.
• Des textures de pack de ressources sous assets/customizer/textures/crop/<crop-id>_<age>.png.

Option B : Modèles JSON pré-construits

plugins/CustomiZer/packs/my_farm_pack/
├── Models/
│   └── tomato/
│       ├── tomato_seed.json
│       ├── tomato_crop_stage_0.json
│       ├── tomato_crop_stage_1.json
│       └── tomato_crop_stage_2.json
├── configs/
│   └── tomato.yml
└── resourcepack/
    └── assets/
        └── my_farm_pack/
            ├── models/
            └── textures/

Le modèle exact de stade est <crop-id>_crop_stage_<age>.json. Le modèle de graine est <crop-id>_seed.json. Les modèles de graine ou de stade manquants utilisent des modèles générés en repli. Le JSON de modèle peut référencer des textures namespacées et des modèles parents ; placez ces assets dans la structure normale resourcepack/assets/ du pack.

Éléments de pack pour les récoltes et graines

Si le loot doit dropper un objet de pack texturé, définissez cet objet dans une configuration d'objet de pack normal. L'ID d'objet utilisé par la culture doit correspondre à l'ID sous items:.

# plugins/CustomiZer/packs/my_farm_pack/configs/farm_items.yml
info:
  namespace: my_farm_pack

items:
  tomato:
    display_name: "Tomato"
    resource:
      generate: false
      material: APPLE
      model_path: custom/items/tomato

  tomato_seed:
    display_name: "Tomato Seed"
    resource:
      generate: false
      material: WHEAT_SEEDS
      model_path: custom/items/tomato_seed

Configuration complète de culture

# plugins/CustomiZer/packs/my_farm_pack/configs/tomato.yml
seed:
  id: tomato_seed                    # ID de graine logique ; défaut : tomato_seed
  material: WHEAT_SEEDS              # Matériau de base vanilla de la graine générée plantable

growth:
  max_age: 2                         # Informatif dans le chargeur actuel ; les fichiers déterminent l'âge max
  avg_seconds_per_stage: 120         # Temps cible moyen pour chaque stade
  min_light: 7                       # La croissance se met en pause en dessous de ce niveau de lumière de bloc

placement:
  bottom_block: FARMLAND             # Matériau exact Bukkit qui doit être cliqué droit

hitbox:
  auto_height_step: 0.1              # Hauteur par défaut = max(0.2, step * (age + 1))

# Les hitboxes exactes optionnelles surchargent la taille automatique pour les âges listés
hitboxes:
  "0":
    width: 0.75
    height: 0.25
  "2":
    width: 0.9
    height: 0.8

sounds:
  place: minecraft:item.crop.plant   # Plantation réussie
  break: minecraft:block.crop.break  # Clic gauche ou casse environnementale
  interact: minecraft:block.crop.hit # Récolte au clic droit
  grow: minecraft:block.grass.place  # Optionnel ; chaque augmentation d'âge réussie

loot:
  drop_seed_if_immature: true        # Actuellement stocké mais non utilisé par le lancement de loot
  decrease_age_on_harvest: -1        # -1 supprime la culture ; 0 garde le même âge ; N soustrait N âges

multipliers:
  bonemeal: 0.3                      # Présent dans la config, mais actuellement non utilisé par le code d'interaction
  max_moisture: 0.2                  # +20% dans les biomes de marais, jungle ou forêt
  rain: 0.1                          # +10% pendant une tempête sans tonnerre
  thunderstorm: -0.3                 # -30% pendant le tonnerre
  snow: -0.5                         # -50% dans les biomes de neige, gelés ou de glace

ready_effect:
  particle: HAPPY_VILLAGER           # Nom d'enum Bukkit Particle ; omis = pas de particules de maturité
  count: 6                           # Compte ambiant ; la poussée de maturité utilise count * 3

stage_effects:
  "1":
    particle: COMPOSTER               # Nom d'enum Bukkit Particle
    particle_count: 4                 # Défaut : 5
    sound: minecraft:block.grass.place
  "2":
    particle: CRIMSON_SPORE
    particle_count: 10
    sound: minecraft:entity.experience_orb.pickup

item_drops:
  ripe_tomato:
    item: "pack:my_farm_pack:tomato"
    min_amount: 1
    max_amount: 3
    chance: 1.0
    trigger_min_age: 2
    trigger_max_age: -1
    food:
      nutrition: 3
      saturation: 0.5
      can_always_eat: true
      effects:
        - effect: HASTE
          duration: 120
          amplifier: 0
          chance: 0.3

  immature_seed_return:
    item: "crop_seed"
    min_amount: 1
    max_amount: 1
    chance: 1.0
    trigger_min_age: 0
    trigger_max_age: 1

Référence de configuration

Calcul exact de croissance

La croissance est vérifiée une fois toutes les 600 ticks (30 secondes). Une culture peut avancer d'au plus un âge par vérification. Les cultures déjà à l'âge maximum sont ignorées.

chance de base = 30 / avg_seconds_per_stage
chance finale = chance de base + (chance de base × chaque multiplicateur actif)
la chance finale est limitée entre 0.0 et 1.0

Exemple : avec avg_seconds_per_stage: 120, le lancer de base est 30 / 120 = 0.25, soit 25% toutes les 30 secondes. Pendant une pluie ordinaire avec rain: 0.1, cela devient 0.25 + 0.025 = 0.275, soit 27.5%.

• rain s'applique quand le monde a une tempête et ne tonne pas.
• thunderstorm s'applique à la place de la pluie pendant que le monde tonne.
• max_moisture vérifie actuellement si le nom du biome contient swamp, jungle, ou forest ; il n'inspecte pas l'humidité de la terre labourée.
• snow s'applique quand le nom du biome contient snow, frozen, ou ice.
• bonemeal n'est actuellement pas lu par le code de plantation ou d'interaction, donc l'os repas ne force ni n'accélère une culture.

Planter, récolter et casser

Quand l'intégration WorldGuard est disponible, la plantation est refusée là où le joueur ne peut pas construire. Les événements de cycle de vie de culture (place, croissance, récolte, casse et suppression) sont également exposés aux autres plugins ; les événements annulables peuvent arrêter l'action correspondante, et l'événement de croissance peut changer l'âge cible.

Référence de table de drops

Chaque enfant sous item_drops: est un lancer indépendant. Plusieurs entrées peuvent correspondre et dropper ensemble.

Références d'objets supportées

Drops matures et immatures recommandés

item_drops:
  mature_produce:
    item: "pack:my_farm_pack:tomato"
    min_amount: 1
    max_amount: 3
    chance: 1.0
    trigger_min_age: 2
    trigger_max_age: -1

  mature_seed:
    item: "crop_seed"
    min_amount: 1
    max_amount: 2
    chance: 0.7
    trigger_min_age: 2
    trigger_max_age: -1

  immature_seed:
    item: "crop_seed"
    min_amount: 1
    max_amount: 1
    chance: 1.0
    trigger_min_age: 0
    trigger_max_age: 1

Drops de culture comestibles

Ajoutez food: à n'importe quelle entrée de loot pour appliquer un composant alimentaire Paper à ce drop généré.

# plugins/CustomiZer/config.yml
crops:
  can_always_eat: false

Persistance et rechargement

• Le type de culture placée, l'emplacement, l'âge actuel, les horodatages et l'UUID du planteur sont persistés.
• Les visuels de culture et les hitboxes sont recréés après le redémarrage et quand leur chunk se charge.
• Les allocations CustomModelData sont stockées dans un registre afin que l'ajout de cultures ne renumérose pas les cultures existantes.
• /zcrop reload réanalyse les définitions de culture et rafraîchit les affichages. Reconstruisez ou renvoyez le pack de ressources lors de l'ajout ou du changement de textures/modèles.

Commandes de culture

Liste de vérification de création

1. Choisissez un ID de culture en minuscules comme tomato.
2. Créez soit des stades PNG continus dans Textures/tomato/ soit des stades JSON dans Models/tomato/.
3. Créez configs/tomato.yml. Si omis, CustomiZer génère une config de base après la détection des fichiers visuels.
4. Définissez des éléments de pack de récolte et de graine si vous voulez des textures d'inventaire personnalisées.
5. Utilisez des plages d'âge explicites pour chaque drop mature et immature.
6. Exécutez /zcrop reload, puis /zcrop list pour confirmer l'enregistrement.
7. Utilisez /zcrop give <player> tomato, plantez et testez les stades avec /zcrop setage <age>.
8. Reconstruisez/distribuez le pack de ressources à chaque changement d'assets visuels.

Système GUI

CustomiZer dispose de deux menus en jeu. Ils se ressemblent mais affichent des choses complètement différentes. Lisez cette page en premier — cela vous évitera des heures de confusion.

L'explication en une phrase

La chose la plus importante à comprendre

/z gui et /zitems lisent maintenant depuis deux fichiers séparés par pack :

packs/<packId>/gui.yml    ← objets visuels bruts affichés dans /z gui (type: pack_item, raw)
items/<packId>/gui.yml   ← objets fonctionnels affichés dans /zitems (type: sword, pickaxe, armor, etc.)

Le champ slot: en haut du yml de chaque pack contrôle où l'icône de catégorie apparaît dans le menu. Il n'y a plus de section pack_overrides pour les assignations d'emplacement.

Le champ type: de chaque objet détermine quel type d'objet il est :

Comparaison côte à côte

Référence des emplacements d'inventaire

Les deux GUIs utilisent la numérotation d'emplacements Minecraft standard — de gauche à droite, de haut en bas, en commençant à 0. Un inventaire à 6 rangées a 54 emplacements (0–53) :

Rangée 1:  [ 0][ 1][ 2][ 3][ 4][ 5][ 6][ 7][ 8]
Rangée 2:  [ 9][10][11][12][13][14][15][16][17]
Rangée 3:  [18][19][20][21][22][23][24][25][26]
Rangée 4:  [27][28][29][30][31][32][33][34][35]
Rangée 5:  [36][37][38][39][40][41][42][43][44]
Rangée 6:  [45][46][47][48][49][50][51][52][53]  ← rangée boutons nav

/z gui — Navigateur de packs

Le menu pour les joueurs. Affiche les objets bruts du pack de ressources (textures et modèles personnalisés) pour que les joueurs voient ce qui est disponible sur le serveur. Navigation uniquement — aucun objet n'est donné.

Comment ça fonctionne

Quand un joueur exécute /z gui, il voit une icône par pack enregistré. Cliquer sur l'icône d'un pack ouvre une deuxième page listant tous les objets de type pack_item ou raw du fichier packs/<packId>/gui.yml de ce pack. Un bouton "Parcourir tous les objets" permet aussi de voir tous les objets bruts de tous les packs sur une seule page paginée.

Config 1 — Mise en page de la coque : plugins/CustomiZer/gui/main_menu.yml

Contrôle le cadre extérieur du navigateur de catégories /z gui : titre, taille, remplissage d'arrière-plan, bordure et le bouton "Parcourir tous les objets". Les boutons de navigation Précédent/Retour/Suivant lors de la navigation dans les objets d'un pack y sont aussi configurés.

# plugins/CustomiZer/gui/main_menu.yml

categories:
  title: "<white><shift:-8><font_image:CustomiZerInternal:1>"
  size: 6
  background:
    enabled: true
    material: PAPER
    model_data: 29999
    name: " "
  border:
    enabled: true
    material: PAPER
    model_data: 29999
    name: " "

pack_gui:
  prev_button:
    slot: 47
    material: PAPER
    model_data: 29999
    name: "&c◀ Précédent"
  back_button:
    slot: 49
    material: PAPER
    model_data: 29999
    name: "&c✖ Retour"
  next_button:
    slot: 51
    material: PAPER
    model_data: 29999
    name: "&aSuivant ▶"
  page_info:
    enabled: true
    slot: 48
    material: PAPER
    model_data: 29999
    name: "&7Page &f%page% &7/ &f%total%"

Config 2 — Objets d'affichage du pack : packs/<packId>/gui.yml

C'est le fichier à créer pour qu'un pack apparaisse dans /z gui. Il contient les objets visuels bruts (type: pack_item ou type: raw) affichés dans le navigateur. Le plugin scanne automatiquement ces fichiers. Aucune autre inscription nécessaire.

Pour /zitems, créez un fichier séparé à items/<packId>/gui.yml avec des types d'objets fonctionnels (sword, pickaxe, armor, etc.).

Changer l'emplacement d'un pack dans /z gui

Modifiez le slot: en haut du fichier packs/<packId>/gui.yml du pack. Ce numéro contrôle où l'icône du pack se place dans la grille des catégories de /z gui. Si aucun fichier packs/ n'existe pour un pack, l'emplacement est lu depuis items/<packId>/gui.yml.

# packs/my_gem_pack/gui.yml  ← navigateur d'affichage pour /z gui

name: "<gradient:#ffd700:#ff9a3c><bold>Gem Pack</bold></gradient>"
slot: 11    # ← Changez ceci pour déplacer l'icône dans /z gui

icon:
  pack: my_gem_pack
  id: ruby

gui:
  size: 6

# Seuls les types pack_item / raw apparaissent dans /z gui
items:
  - type: pack_item
    pack: my_gem_pack
    id: ruby
    name: "&cRuby"
    lore:
      - "&7Une gemme rouge précieuse"

  - type: pack_item
    pack: my_gem_pack
    id: emerald_gem
    name: "&aEmerald Gem"
    lore:
      - "&7Une gemme verte brillante"

Ajouter un pack dans /z gui (résumé)

1. Créez packs/mon_pack/gui.yml avec un slot: libre et des entrées pack_item
2. Exécutez /zpack reloadpacks en jeu

C'est tout. Aucun autre fichier n'a besoin d'être modifié pour que le pack apparaisse dans /z gui.

/zitems — Navigateur d'objets fonctionnels

L'outil d'administration pour naviguer et donner des objets fonctionnels — épées à niveaux, pioches, cosmétiques, moissonneuses, et plus encore. Cliquez gauche sur n'importe quel objet pour le recevoir instantanément.

Le menu principal /zitems — chaque icône est un pack enregistré. Cliquez sur un pack pour naviguer dans ses objets fonctionnels.

Config 1 — Boutons nav : plugins/CustomiZer/gui/items_shop.yml

Ce fichier contrôle les boutons Précédent / Retour / Suivant et les infos de page affichés lors de la navigation dans les objets d'une catégorie. Il ne contrôle pas quels packs apparaissent comme catégories — cela vient du fichier items/<packId>/gui.yml de chaque pack.

# plugins/CustomiZer/gui/items_shop.yml

pack_gui:
  prev_button:
    slot: 47
    material: PAPER
    model_data: 29999
    name: "&c◀ Précédent"
  back_button:
    slot: 49
    material: PAPER
    model_data: 29999
    name: "&c✖ Retour"
  next_button:
    slot: 51
    material: PAPER
    model_data: 29999
    name: "&aSuivant ▶"
  page_info:
    enabled: true
    slot: 48
    material: PAPER
    model_data: 29999
    name: "&7Page &f%page% &7/ &f%total%"

Config 2 — Objets fonctionnels du pack : items/<packId>/gui.yml

C'est le fichier qui enregistre les objets fonctionnels dans /zitems. Il est séparé du fichier packs/<packId>/gui.yml utilisé par /z gui. Vous avez besoin des deux fichiers si vous souhaitez qu'un pack apparaisse dans les deux menus.

Changer l'emplacement d'une catégorie dans /zitems

Modifiez slot: en haut de items/<packId>/gui.yml. Cela contrôle la position de l'icône du pack dans /zitems. Le fichier packs/<packId>/gui.yml contrôle l'emplacement dans /z gui indépendamment.

Contrôler le placement des objets dans une catégorie

Chaque entrée d'objet dans items/<packId>/gui.yml supporte un champ optionnel slot: qui l'ancre à une position spécifique :

# items/my_pack/gui.yml  ← objets fonctionnels pour /zitems

name: "<gradient:#5cc8ff:#7ee787><bold>My Pack</bold></gradient>"
slot: 11
icon:
  pack: my_pack
  id: silver_sword
gui:
  size: 6

items:
  # Objets fonctionnels → apparaissent dans /zitems (cliquer donne l'objet entièrement configuré)
  - type: sword
    id: silver_sword
    slot: 11          # ← ancré à l'emplacement exact 11 dans la page de catégorie /zitems
    name: "&7⚔ Silver Sword"
    lore:
      - "&7Une épée à niveaux"
      - "&aClic gauche pour recevoir"

  - type: pickaxe
    id: silver_pickaxe
    slot: 12          # ← ancré à l'emplacement 12
    name: "&7⛏ Silver Pickaxe"

  - type: harvester
    id: silver_hoe
    # pas de slot: → placé automatiquement après les objets ancrés

Pour le navigateur d'affichage (/z gui), créez un fichier packs/my_pack/gui.yml séparé avec des entrées type: pack_item pour les mêmes objets.

Référence des types d'objets

Convertir des packs ItemsAdder automatiquement

Si vous avez des packs de contenu ItemsAdder à migrer vers CustomiZer, le convertisseur intégré s'en charge automatiquement — il crée le gui.yml, copie les assets et classe les objets.

1. Déposez le dossier de contenu ItemsAdder (doit contenir configs/ et resourcepack/) dans :
   plugins/CustomiZer/converters/itemsadder/input/<nomDuPack>/
2. Exécutez en jeu : /zpack convert itemsadder <nomDuPack>
3. Exécutez /zpack zip pour reconstruire le pack de ressources

Pack GUI — Référence gui.yml

Deux fichiers séparés par pack : un pour le navigateur d'affichage /z gui, un pour l'outil admin /zitems. Chaque fichier contrôle quel emplacement le pack occupe, quelle icône il affiche et quels objets apparaissent à l'intérieur.

Où se trouvent les fichiers

packs/<packId>/gui.yml    ← navigateur d'affichage pour /z gui (type: pack_item, raw)
items/<packId>/gui.yml   ← outil admin pour /zitems (type: sword, pickaxe, armor, etc.)

Le plugin détecte automatiquement ces fichiers. Aucune autre inscription n'est nécessaire — créez simplement le fichier et rechargez. Le champ slot: en haut de chaque fichier contrôle où l'icône de catégorie apparaît. Si un seul fichier existe pour un pack, son slot: est utilisé pour les deux menus.

packs/<packId>/gui.yml — navigateur d'affichage (/z gui)

# packs/my_pack/gui.yml  ← objets visuels bruts affichés dans /z gui

# Nom affiché comme étiquette du pack dans /z gui.
name: "<gradient:#5cc8ff:#7ee787><bold>My Pack</bold></gradient>"

# Emplacement dans la grille des catégories /z gui.
# Utilisez les emplacements 11–15, 20–24, 29–33 ou 38–42 pour de meilleurs résultats.
slot: 11

# L'icône affichée pour ce pack dans la grille /z gui.
icon:
  pack: my_pack     # namespace du pack
  id: silver_ore    # id de l'objet dans ce pack

# Le titre et la taille de la page de navigation.
gui:
  title: "<white><shift:-8><font_image:CustomiZerInternal:1>"
  size: 6   # rangées (1–6) ; dernière rangée = boutons nav si size > 1

# Seuls les types pack_item / raw appartiennent ici
items:

  # Objet visuel brut — apparaît dans /z gui (cliquer donne l'objet brut)
  - type: pack_item
    pack: my_pack
    id: silver_ore
    name: "&7Silver Ore"
    lore:
      - "&7Un minerai brut"
    # slot: 0    ← optionnel : ancrer à une position exacte

items/<packId>/gui.yml — outil admin (/zitems)

# items/my_pack/gui.yml  ← objets fonctionnels affichés dans /zitems

name: "<gradient:#5cc8ff:#7ee787><bold>My Pack</bold></gradient>"
slot: 11

icon:
  pack: my_pack
  id: silver_ore

gui:
  size: 6

# Les types d'objets fonctionnels appartiennent ici
items:

  # Épée fonctionnelle — apparaît dans /zitems
  - type: sword
    id: silver_sword
    slot: 11      # optionnel : ancrer à l'emplacement 11 dans la page de catégorie /zitems
    name: "&7⚔ Silver Sword"
    lore:
      - "&7Une épée à niveaux"
      - "&aClic gauche pour recevoir"

  # Pioche fonctionnelle — apparaît dans /zitems
  - type: pickaxe
    id: silver_pickaxe
    slot: 12
    name: "&7⛏ Silver Pickaxe"

  # Houe moissonneuse fonctionnelle — apparaît dans /zitems
  - type: harvester
    id: silver_hoe
    name: "&7🌾 Silver Hoe"

  # Cosmétique fonctionnel — apparaît dans /zitems
  - type: cosmetic
    id: silver_crown
    name: "&7👑 Silver Crown"

Erreurs fréquentes & solutions