CustomiZer — Guide de conversion de packs

Sommaire

1. Vue d'ensemble

CustomiZer intègre trois convertisseurs. Chacun lit le format d'export natif du plugin source et produit un pack CustomiZer standard dans plugins/CustomiZer/packs/<packName>/.

2. ItemsAdder — Conversion

Quoi mettre dans le dossier input

Déposez un dossier de contenu issu du répertoire contents/ d'ItemsAdder. Il doit contenir exactement ces deux sous-dossiers :

• configs/ — définitions YAML des items (avec info.namespace et les entrées items.*)
• resourcepack/ — assets du resource pack déjà organisés sous assets/

Structure attendue dans le dossier d'entrée :

plugins/CustomiZer/converters/itemsadder/input/<packName>/
  ├── configs/
  │   └── <namespace>/
  │       └── items.yml          ← définitions des items
  └── resourcepack/
      └── assets/
          └── <namespace>/
              ├── models/
              │   └── item/
              │       └── my_item.json
              └── textures/
                  └── item/
                      └── my_item.png

Commande

/zpack convert itemsadder <packName>

Ce que le convertisseur fait automatiquement

• Lit tous les fichiers YAML dans configs/ et extrait les définitions d'items
• Copie les modèles et textures depuis resourcepack/assets/ dans la structure CustomiZer
• Génère un gui.yml pour que les items apparaissent dans /z gui
• Auto-classe les items par nom / matériau : chapeaux, ailes, épées, staves, cosmétiques, etc.
• Crée des fichiers YML fonctionnels pour les épées, staves et cosmétiques afin qu'ils apparaissent dans /zitems

3. Nexo — Conversion

Quoi mettre dans le dossier input

Déposez le dossier de votre pack Nexo exporté dans le dossier input. Il doit contenir deux sous-dossiers :

• items/ — fichiers YAML de définition des items
• pack/ — assets du resource pack (modèles, textures…)

Structure attendue :

plugins/CustomiZer/converters/nexo/input/<packName>/
  ├── items/
  │   └── my_item.yml            ← définitions des items
  └── pack/
      └── assets/
          └── <namespace>/
              ├── models/
              │   └── item/
              │       └── my_item.json
              └── textures/
                  └── item/
                      └── my_item.png

Commande

/zpack convert nexo <packName>

4. Oraxen — Conversion

Quoi mettre dans le dossier input

Le convertisseur Oraxen utilise la même structure que Nexo — deux sous-dossiers, items/ et pack/ :

plugins/CustomiZer/converters/oraxen/input/<packName>/
  ├── items/
  │   └── my_item.yml            ← définitions des items
  └── pack/
      └── assets/
          └── <namespace>/
              ├── models/
              │   └── item/
              │       └── my_item.json
              └── textures/
                  └── item/
                      └── my_item.png

Commande

/zpack convert oraxen <packName>

5. Après la conversion

Le pack converti est automatiquement placé dans packs/<packName>/. Rechargez ensuite et reconstruisez le resource pack :

1. 1Lancez la commande de conversion (voir ci-dessus).
2. 2Rechargez les packs pour que CustomiZer détecte le nouveau pack :
   /zpack reloadpacks
3. 3Reconstruisez le ZIP du resource pack et distribuez-le aux joueurs :
   /zpack zip

6. Lister les packs disponibles avant de convertir

Lancez la commande sans nom de pack pour voir tous les dossiers prêts à convertir dans le répertoire input correspondant :

/zpack convert nexo
/zpack convert oraxen
/zpack convert itemsadder

CustomiZer listera tous les packs valides trouvés dans le dossier input pour que vous puissiez choisir le bon <packName>.

# 1. Déposez le pack dans :
#    plugins/CustomiZer/converters/nexo/input/my_pack/
#    (doit contenir items/ et pack/)

# 2. Convertissez
/zpack convert nexo my_pack

# 3. Rechargez et reconstruisez
/zpack reloadpacks
/zpack zip