🧩 CustomiZer — Documentation Complète du Plugin

🌐 Serveur HTTP intégré

Au démarrage, le plugin lance un serveur HTTP léger sur un port configurable (par défaut 7270). Le pack de ressources est servi à http://<your-ip>:<port>/<hash>.zip. Les joueurs le reçoivent automatiquement à la connexion via l'API setResourcePack.

🔄 Rechargement à chaud sans redémarrage

Exécuter /zpack zip ou /z reload reconstruit le pack en mémoire et met à jour le gestionnaire HTTP en direct — le serveur n'a jamais besoin de redémarrer. Le nouveau hash du pack déclenche un téléchargement à jour lors de la prochaine connexion d'un joueur.

📐 Sortie en double format

Le pack est écrit simultanément dans les deux formats :

• Ancien format — assets/minecraft/models/item/<material>.json avec overrides[] — fonctionne sur toutes les versions incluant 1.21.8.
• Nouveau format — assets/minecraft/items/<material>.json avec range_dispatch — requis pour le rendu prioritaire 1.21.4+.

🗂️ Dossier Includes

Placez n'importe quel pack de ressources supplémentaire dans plugins/CustomiZer/includes/ et il sera fusionné dans le pack généré automatiquement à chaque construction. Parfait pour ajouter des sons, textures ou polices personnalisées depuis d'autres outils.

📂 Structure complète d'un dossier de pack

Voici la structure exacte attendue par le plugin. Déposez votre dossier de pack dans plugins/CustomiZer/packs/ et exécutez /zpack reloadpacks puis /zpack zip.

packs/
└── my_pack/
    ├── configs/
    │   ├── my_items.yml          ← définitions d'objets / blocs / font_images
    │   ├── category.yml          ← optionnel : catégorie GUI pour ce pack
    │   └── subfolder/            ← les configs peuvent être imbriquées dans des sous-dossiers
    │       └── more_items.yml
    │
    └── resourcepack/
        ├── pack.mcmeta           ← métadonnées Minecraft du pack (requis)
        └── assets/
            └── <namespace>/     ← doit correspondre à info.namespace dans vos YAML
                ├── models/
                │   ├── item/     ← fichiers de modèle .json pour les objets
                │   └── block/    ← fichiers de modèle .json pour les blocs
                └── textures/
                    ├── item/     ← textures .png pour les objets
                    ├── block/    ← textures .png pour les blocs
                    └── custom/   ← textures pour les images de police (tout sous-chemin)

📄 pack.mcmeta (requis)

Placez ce fichier à resourcepack/pack.mcmeta. Utilisez pack_format: 34 pour Minecraft 1.21+.

{
  "pack": {
    "pack_format": 34,
    "description": "My Pack"
  }
}

🔑 Registre — Identifiants attribués automatiquement

Le plugin attribue automatiquement des entiers Custom Model Data (à partir de 30100) à chaque objet et bloc, et des points de code Unicode PUA (à partir de U+EC00) à chaque image de police. Ces attributions sont persistées dans packs/.registry.yml — elles ne changent jamais entre les redémarrages, donc les objets existants dans les inventaires des joueurs restent valides.

📂 Étape 1 — Où placer la texture

Les textures de police sont des fichiers .png placés à l'intérieur du resourcepack du pack à :

resourcepack/assets/<namespace>/textures/<your-path>.png

La valeur <your-path> est ce que vous écrivez dans le champ path: de la configuration (l'extension .png est ajoutée automatiquement). Exemples :

📄 Étape 2 — La déclarer dans configs/

Créez un fichier YAML n'importe où dans configs/ (ex. configs/my_fonts.yml). Vous pouvez mélanger des images de police avec des objets dans le même fichier, ou les garder séparés.

info:
  namespace: gem_ranks          # doit correspondre au dossier assets/<namespace>/

font_images:
  ba_i:                         # ID unique pour cette image de police
    path: "bronze_amethyst_i"   # chemin sous textures/ (sans .png)
    scale_ratio: 12             # hauteur rendue en pixels
    y_position: 9.5             # ascent — distance depuis la ligne de base du texte
    permission: bronze_amethyst_i   # optionnel : permission pour afficher dans le GUI
    show_in_gui: true               # optionnel : afficher dans le GUI de navigation de polices

Référence complète des champs :

🔤 Étape 3 — Appliquer le pack

Après avoir sauvegardé les fichiers, exécutez ces deux commandes en tant qu'administrateur :

1. /zpack reloadpacks — scanne le pack et attribue un point de code Unicode à chaque image de police
2. /zpack zip — reconstruit le pack de ressources et l'envoie aux joueurs en ligne

Vous pouvez vérifier l'enregistrement avec /zpack fonts (liste tous les IDs de polices + leurs points de code Unicode) et prévisualiser n'importe quelle image avec /zpack font <pack> <id> (l'affiche dans votre barre d'action).

✏️ Remplacements globaux — customfonts.yml

Remplacez l'échelle, la position et le décalage horizontal de n'importe quelle image de police depuis plugins/CustomiZer/customfonts.yml sans toucher au pack lui-même. Utile pour affiner des packs tiers.

fonts:
  gem_ranks:          # nom du dossier de pack
    ba_i:             # ID de l'image de police
      scale_ratio: 14
      y_position: 10
      x_position: -4  # décalage horizontal en pixels (non disponible dans la config du pack)

📁 Étape 1 — Placez votre PNG dans le bon dossier

Créez ce dossier s'il n'existe pas, puis déposez votre PNG à l'intérieur :

plugins/CustomiZer/gui_input/<packName>/
  └── my_gui.png       ← votre image de fond

• Remplacez <packName> par le nom que vous souhaitez, ex. my_casino_gui.
• Vous pouvez mettre plusieurs PNG dans le dossier — chacun devient sa propre image GUI.
• Le PNG doit avoir la même largeur qu'un inventaire Minecraft (176px de large à l'échelle 1×, ou tout multiple de cela).

⌨️ Étape 2 — Exécuter la commande

/zpack gui <packName>
/zpack gui <packName> <namespace>   ← optionnel : espace de noms personnalisé, par défaut le packName

Le plugin lit les dimensions de votre PNG, calcule automatiquement le scale_ratio pour que l'image remplisse exactement la largeur d'inventaire de 176px, et génère :

• plugins/CustomiZer/packs/<packName>/ — dossier de pack prêt à l'emploi (prêt pour reloadpacks)
• plugins/CustomiZer/gui_output/<packName>.zip — ZIP portable à partager ou archiver

✅ Étape 3 — Appliquer et utiliser

/zpack reloadpacks
/zpack zip

Pour utiliser l'image comme fond de titre GUI dans gui.yml :

title: "<shift:-8><font_image:my_casino_gui:my_gui>"

Prévisualisez-la instantanément en jeu : /zpack font <packName> <id>

📁 Étape 1 — Placez vos PNG dans le bon dossier

plugins/CustomiZer/rank_input/<packName>/
  ├── gold_rank.png
  ├── silver_rank.png
  └── bronze_rank.png

• Chaque PNG = un badge de rang. Le nom du fichier (sans .png) devient l'ID du badge.
• Gardez vos images petites — 12–20px de haut fonctionne le mieux pour l'alignement dans le chat.

⌨️ Étape 2 — Exécuter la commande

/zpack rank <packName>
/zpack rank <packName> <namespace>   ← espace de noms optionnel

Le générateur utilise la hauteur naturelle de l'image comme scale_ratio (donc un PNG de 12px de haut est rendu à 12px), définit y_position: 9.5 pour s'aligner sur la ligne de base du chat, et ajoute un champ permission par badge.

✅ Étape 3 — Appliquer et utiliser

/zpack reloadpacks
/zpack zip

Insérez un badge partout où les balises MiniMessage sont acceptées (préfixe de chat, description, titre) :

<font_image:my_ranks:gold_rank> PlayerName

Chaque badge reçoit également un nœud de permission égal à son nom de fichier (ex. gold_rank). Gérez l'affichage dans votre plugin de chat en utilisant ce nœud.

📁 Étape 1 — Placez vos PNG dans le bon dossier

plugins/CustomiZer/item_input/<packName>/
  ├── blood_ingot.png
  ├── raw_blood.png
  └── solar_ingot.png

• Le nom du fichier (sans .png) = ID de l'objet. Les tirets bas deviennent des espaces dans le nom d'affichage (blood_ingot → Blood Ingot).
• Utilisez les tailles de textures d'objets Minecraft standard : 16×16 ou 32×32.

⌨️ Étape 2 — Exécuter la commande

/zpack item <packName>
/zpack item <packName> <namespace> <material>
  ↑ material vaut par défaut PAPER — changez en ex. DIAMOND pour un éclat de base différent

✅ Étape 3 — Appliquer et utiliser

/zpack reloadpacks
/zpack zip

Donnez des objets aux joueurs ou à vous-même :

/z give <player> item blood_ingot
/z get item solar_ingot

Ouvrez la configuration générée à packs/<packName>/configs/<packName>.yml pour ajouter des descriptions, des actions, des recettes de craft, etc.

📁 Étape 1 — Nommez correctement vos PNG

Le générateur détecte automatiquement les divisions de textures en fonction des suffixes de nom de fichier. Vous avez deux options par bloc :

plugins/CustomiZer/block_input/<packName>/
  ├── oak_beam.png          ← côtés (ou toutes les faces si aucun _top n'existe)
  ├── oak_beam_top.png      ← haut & bas
  ├── stone_tile.png        ← 6 faces identiques (pas de _top fourni)
  └── spruce_beam_top.png   ← haut/bas pour spruce_beam (les côtés utilisent spruce_beam.png ou spruce_beam_side.png)

⌨️ Étape 2 — Exécuter la commande

/zpack block <packName>
/zpack block <packName> <namespace> <material> <sound>

✅ Étape 3 — Appliquer et utiliser

/zpack reloadpacks
/zpack zip

/z give <player> block oak_beam     ← donne l'objet ; clic droit pour placer

Ouvrez packs/<packName>/configs/<packName>.yml pour ajuster la hardness, les sons et les drops. Pour définir ce qui tombe lors de l'extraction, ajoutez une entrée dans blocks.yml :

blocks:
  oak_beam:
    pack_id: "<packName>:oak_beam"
    display_name: "Oak Beam"
    drops:
      - item: OAK_LOG
        amount: 1
        chance: 100

📁 Étape 1 — Créez un sous-dossier par set d'armure

plugins/CustomiZer/armor_input/<packName>/
  └── my_armor_set/           ← un dossier par set ; le nom du dossier = ID du set
      ├── layer_1.png         ← REQUIS — superposition portée : corps, bras, pieds
      ├── layer_2.png         ← REQUIS — superposition portée : jambières uniquement
      ├── helmet.png          ← icône d'inventaire optionnelle
      ├── chestplate.png      ← icône d'inventaire optionnelle
      ├── leggings.png        ← icône d'inventaire optionnelle
      └── boots.png           ← icône d'inventaire optionnelle

• layer_1.png et layer_2.png sont les textures portées que les joueurs voient lorsque l'armure est équipée. Créez-les dans Blockbench ou n'importe quel éditeur de textures d'armure.
• Les PNG d'icônes sont ce qui s'affiche dans l'emplacement d'inventaire. Standard 16×16 ou 32×32.
• Vous pouvez avoir plusieurs sous-dossiers de set sous un seul <packName> — tous les sets sont fusionnés dans un seul fichier de pack.

⌨️ Étape 2 — Exécuter la commande

/zpack armor <packName>
/zpack armor <packName> <namespace>   ← espace de noms optionnel, par défaut le packName

Le générateur produit une configuration avec :

• Un bloc armors_rendering liant layer_1 et layer_2 à l'ID du set
• Une entrée d'objet par pièce fournie (casque/plastron/jambières/bottes) avec specific_properties.armor.slot correctement défini

✅ Étape 3 — Appliquer et utiliser

/zpack reloadpacks
/zpack zip

/z give <player> armor my_armor_set_chestplate

Ouvrez packs/<packName>/configs/<packName>.yml pour activer optionnellement la teinte de couleur cuir :

armors_rendering:
  my_armor_set:
    color: '#8c196c'    ← couleur hexadécimale affichée sur la couche de base en cuir
    use_color: true     ← définir à true pour activer la teinte

📦 Config d'objet de pack (configs/*.yml)

Voici le format pour définir des objets dans un dossier de pack. Le plugin lit tous les fichiers .yml récursivement depuis configs/. Chaque fichier qui a une section items: est traité.

info:
  namespace: my_pack            # doit correspondre au dossier assets/<namespace>/

items:
  my_item:                      # ID d'objet unique dans cet espace de noms
    display_name: "My Item"     # affiché en jeu (codes de couleur supportés)
    resource:
      material: PAPER           # matériau Minecraft de base
      generate: false           # false = utiliser un JSON de modèle existant
      model_path: item/my_item  # chemin relatif à assets/<namespace>/models/
                                # (extension .json non nécessaire)

Pour auto-générer un modèle d'objet plat simple à partir d'une texture (aucun JSON de modèle nécessaire) :

items:
  bronze_coin:
    display_name: "Bronze Coin"
    resource:
      material: PAPER
      generate: true            # le plugin génère le modèle automatiquement
      model_path: item/bronze_coin   # résout vers textures/item/bronze_coin.png

Référence complète des champs resource: :

📂 Où placer la texture / le modèle

Avec namespace: my_pack et model_path: item/my_item :

📄 Fichier items.yml principal (objets d'action)

Les objets d'action au clic droit sont configurés dans plugins/CustomiZer/items.yml. Champs :

• NAME — Nom d'affichage (codes de couleur supportés)
• MATERIAL — Matériau Minecraft vanilla (ex. PAPER, DIAMOND)
• LORE — Liste de lignes de description
• CMD — Entier de données de modèle personnalisées (lié à la texture du pack de ressources)
• COOLDOWN — Secondes avant que l'objet puisse être réutilisé
• DURATION — Durée de l'effet en secondes (pour les actions à effets)
• AMOUNT / MAX_AMOUNT — Pour les actions d'argent/argent aléatoire
• COMMAND — Commande console à exécuter (placeholder %player%)
• ACTION — Ce que l'objet fait (voir tableau ci-dessous)

📄 Structure de la configuration d'épée

• type — Matériau Minecraft (ex. IRON_SWORD)
• lifesteal — Fraction 0.0–1.0 des dégâts restituée en PV
• elemental_damage — Chaîne de nom d'élément
• effects-enemy — Carte d'effet → chance + durée appliqués à la cible touchée
• effects-self — Carte d'effet → chance + durée appliqués à l'attaquant
• rarity.common / rare / epic / legendary / mythical — custom_model_data, name et lore par niveau

📄 Structure de la configuration d'armure

• color — Entier RVB pour la couleur de teinture du cuir (ex. 16711680 = rouge)
• custom_model_data — CMD pour chaque pièce d'armure
• display_name — Nom d'affichage par pièce
• lore — Lignes de description par pièce
• attributes — Modificateurs d'attributs vanilla (armor, armor_toughness, attack_damage…)

📦 Config de bloc de pack (configs/*.yml)

Les blocs sont des objets avec une section specific_properties.block. L'ID de l'objet, la texture et le modèle sont enregistrés comme un objet ordinaire, mais le comportement de placement de bloc est ajouté ci-dessous :

info:
  namespace: my_pack

items:
  custom_ore:
    display_name: "Custom Ore"
    resource:
      material: PAPER             # matériau de l'objet sous-jacent
      generate: true              # auto-générer un modèle de cube depuis 6 textures
      textures:                   # [haut, bas, nord, sud, est, ouest]
        - block/custom_ore_top
        - block/custom_ore_bottom
        - block/custom_ore_side
        - block/custom_ore_side
        - block/custom_ore_side
        - block/custom_ore_side

    specific_properties:
      block:
        placed_model:
          type: REAL_NOTE         # utilise le système de placement de bloc de notes
          break_particles: BLOCK  # type de particule à la casse
          directional_mode: NONE  # NONE / LOG (4 rotations) / AXIS (2 rotations)
        cancel_drop: false        # true = ne pas faire tomber l'objet lorsque cassé
        hardness: 3.0             # résistance à l'extraction
        sound:
          break:
            name: "BLOCK_STONE_BREAK"
            volume: 1.0
            pitch: 1.0
          place:
            name: "BLOCK_STONE_PLACE"
            volume: 1.0
            pitch: 1.0

Référence des champs specific_properties.block :

📂 Où placer les textures de blocs

Avec namespace: my_pack et generate: true avec les textures listées comme block/custom_ore_top :

resourcepack/assets/my_pack/textures/block/custom_ore_top.png
resourcepack/assets/my_pack/textures/block/custom_ore_bottom.png
resourcepack/assets/my_pack/textures/block/custom_ore_side.png

Si vous utilisez generate: false, fournissez un JSON de modèle à resourcepack/assets/my_pack/models/<model_path>.json qui référence vos textures.

📋 Formats d'ID de bloc

📄 generators.yml — Référence complète de configuration

worlds_populators:

  my_custom_ore:
    block: blossom_studios:oak_beam   # ID du bloc — voir formats ci-dessus
    worlds:
      - world                          # nom exact du dossier du monde
    replaceable_blocks:
      - STONE                          # noms de matériaux Bukkit (majuscules)
      - DEEPSLATE
    biomes: []                         # vide = n'importe quel biome
                                       # ou listez des biomes spécifiques : [PLAINS, DESERT, FOREST]
    chance: 70.0                       # 0–100 — % de probabilité que chaque tentative de veine place un bloc
    amount: 8                          # tentatives de placement de veine par chunk nouvellement généré
    max_height: 45                     # Y le plus élevé où ce minerai peut se générer
    min_height: -60                    # Y le plus bas (utilisez des valeurs négatives pour la couche de deepslate)

⚡ Exemples rapides

Minerai dense en profondeur, n'importe quel biome :

my_deep_ore:
  block: minecraft:ancient_debris
  worlds: [world]
  replaceable_blocks: [NETHERRACK]
  biomes: []
  chance: 40.0
  amount: 3
  min_height: -58
  max_height: 16

Bloc de pack CustomiZer, plaines uniquement :

blood_ore:
  block: ultimate_armors:blood_ore
  worlds: [world]
  replaceable_blocks: [STONE, ANDESITE, GRANITE]
  biomes: [PLAINS]
  chance: 60.0
  amount: 5
  min_height: 10
  max_height: 50

📋 Placeholders de description

Les lignes de description des pioches supportent des placeholders dynamiques qui se mettent à jour au fur et à mesure que la pioche monte en niveau :

• {level} — Numéro du niveau actuel
• {blocks_mined} — Total de blocs minés avec cette pioche
• {blocks_required} — Blocs nécessaires pour atteindre le niveau suivant
• {progress} — Barre de progression visuelle

📄 Structure de la houe

• type — Matériau de houe vanilla
• display_name, lore — Cosmétiques
• custom_model_data — Texture du pack de ressources
• levels — Carte de clés de niveau, chacune avec rayon, argent par culture, XP par culture, et remplacements de drop spécifiques par type de culture (WHEAT, CARROT, POTATO, etc.)
• abilities — Capacités par niveau (ex. replantation automatique, multiplicateur de fortune)

🎲 Comment fonctionne le reforgement

1. Ouvrez la station de reforgement via /zreforge ou le GUI.
2. Placez l'objet que vous souhaitez reforger dans l'emplacement de la station.
3. Payez le coût de reforgement (économie Vault).
4. Un modificateur aléatoire est appliqué — les modificateurs peuvent changer les dégâts d'attaque, la vitesse, la défense ou appliquer des effets spéciaux.
5. Relancez autant de fois que souhaité pour obtenir le modificateur voulu.

📂 Menu de catégories

Le GUI principal des catégories affiche des boutons pour chaque type de contenu : Objets, Épées, Armures, Blocs, Pioches, Houes et Cosmétiques. Cliquer sur une catégorie ouvre un menu de sous-catégorie.

📑 Onglets de sous-catégories

Chaque catégorie a deux onglets :

• Objets configurés — objets définis dans les fichiers de configuration principaux du plugin (items.yml, swords.yml, etc.)
• Objets de pack — objets provenant des packs installés dans le dossier packs/

Les deux onglets sont paginés indépendamment. Chaque catégorie a sa propre configuration de sous-catégorie (titre, matériaux, emplacements) dans gui.yml.

🎨 Décoration & Bordures

Chaque section GUI supporte un objet de fond configurable (remplit les emplacements vides) et un objet de bordure (remplit le cadre du GUI). Les deux peuvent être n'importe quel matériau avec un CMD personnalisé.

📄 Pagination

Lorsque le nombre d'objets dépasse les emplacements disponibles, la pagination s'active automatiquement. Les boutons page précédente, page suivante et fermer sont tous individuellement configurables par catégorie avec des matériaux personnalisés, CMD, nom et position d'emplacement.