CustomiZer — Guide de conversion Bedrock

Sommaire

1. Fonctionnement général

Bedrock ne peut pas lire les packs de ressources Java. Geyser est le proxy qui permet aux joueurs Bedrock de rejoindre votre serveur Java ; il a besoin d'un pack de ressources Bedrock spécial et d'un fichier "mappings" qui indique quel item Java personnalisé correspond à quel item Bedrock.

Le convertisseur de CustomiZer lit vos packs (les mêmes que dans plugins/CustomiZer/packs/) et génère tout cela automatiquement : le pack Bedrock (.mcpack), la géométrie, les textures, les icônes, les animations et les mappings Geyser — écrits dans plugins/CustomiZer/import_export/geyser_output/.

2. Démarrage rapide

1. 1 Assurez-vous que Geyser (et généralement Floodgate) sont installés sur votre serveur/proxy.
2. 2 Lancez /zpack geyser en jeu (nécessite la permission cxp.admin).
3. 3 Récupérez les fichiers générés dans plugins/CustomiZer/import_export/geyser_output/. La méthode la plus simple : extrayez all_mcpacks.zip → déposez son contenu dans Geyser-Spigot/packs/, et extrayez all_mappings.zip → déposez son contenu dans Geyser-Spigot/custom-mappings/. Puis lancez /geyser reload.
4. 4 Connectez-vous en Bedrock et vérifiez votre contenu.
5. 5 Si quelque chose est légèrement décalé (une interface déplacée, un meuble trop petit), utilisez les commandes /zpack bedrock … ci-dessous, puis relancez /zpack geyser.

3. Ce qui fonctionne automatiquement

Ces fonctionnalités ne nécessitent aucune commande — le convertisseur les gère pour chaque pack :

Certaines choses — cosmétiques extrêmes (ailes dans le dos), position des interfaces, taille des meubles — nécessitent parfois un ajustement ponctuel. C'est à ça que servent les commandes ci-dessous.

4. /zpack geyser — construire le pack Bedrock

C'est la commande qui effectue la conversion. Lancez-la à chaque ajout/modification de packs ou après un réglage /zpack bedrock ….

/zpack geyser

Lorsque vous lancez la commande, chaque pack est traité individuellement et les totaux s'affichent dans le chat. Voici à quoi ressemble la sortie sur un vrai serveur :

Le journal d'export en jeu — chaque namespace indique le nombre de blocs / items / modèles 3D convertis. Les packs avec beaucoup de textures (comme elitecreatures) sont automatiquement découpés en sous-packs de 150 textures pour rester dans les limites de taille Bedrock. La ligne de résumé en bas donne le total sur tous les packs.

Les fichiers sont générés dans plugins/CustomiZer/import_export/geyser_output/. Ils sont produits par namespace pour que les grands serveurs puissent charger les packs sélectivement :

Le dossier import_export/geyser_output/ après l'exécution de /zpack geyser. all_mcpacks.zip (bordure jaune) regroupe tous les fichiers .mcpack — extrayez-le dans Geyser-Spigot/packs/. all_mappings.zip (bordure rouge) regroupe tous les JSON de mappings Geyser — extrayez-le dans Geyser-Spigot/custom-mappings/. Les fichiers par namespace sont disponibles si vous souhaitez ne charger que certains packs.

Le flux le plus simple : utilisez les deux archives .zip — extrayez chacune dans le bon dossier Geyser, puis lancez /geyser reload. Les fichiers par namespace permettent de ne charger que certains packs si besoin.

5. /zpack bedrock gui — déplacer une interface

Bedrock ignore l'« ascent » des polices Java, donc les menus personnalisés peuvent apparaître décalés (par exemple remontés). Cette commande les repositionne.

Exemple — le menu principal est trop haut sur Bedrock :

/zpack bedrock gui customizer_main down 20
/zpack geyser

6. /zpack bedrock item — régler un item 3D

Pour les items 3D dont la position/taille/rotation doit être ajustée par emplacement de main (ex. ailes dans le dos, outil légèrement décalé). La complétion Tab liste vos items 3D.

Emplacements : hand (main principale), offhand (main secondaire), head (porté/chapeau).

Exemple — pousser les ailes dans le dos & les agrandir :

/zpack bedrock item valentines_animated_weapon_and_tool_set_v1_wing offhand move z 8
/zpack bedrock item valentines_animated_weapon_and_tool_set_v1_wing offhand scale 1.5
/zpack geyser

7. /zpack bedrock furniturescale — taille des meubles

Les meubles placés peuvent apparaître un peu petits ou grands sur Bedrock. Cette commande les redimensionne — globalement ou pièce par pièce. La complétion Tab liste uniquement vos meubles.

La complétion Tab après /zpack bedrock — les trois sous-commandes de réglage (furniturescale, gui, item) sont toutes suggérées. C'est l'ensemble complet des commandes d'ajustement Bedrock par pack, chacune décrite dans sa propre section ci-dessus.

Exemples :

# Agrandir tous les meubles de 50 %
/zpack bedrock furniturescale 1.5
/zpack geyser

# Doubler uniquement la taille du moulin
/zpack bedrock furniturescale field_windmill 2
/zpack geyser

8. Textures animées supportées

Si une texture est un flipbook animé sur Java (une bande verticale avec un .png.mcmeta, ex. pales de moulin ou rune lumineuse), le convertisseur recrée ce mouvement sur Bedrock :

• Il génère une texture par image d'animation, et
• crée un render controller qui les fait défiler dans le temps, en utilisant le même frametime que le .mcmeta Java.

Résultat : l'animation tourne sur Bedrock exactement comme sur Java — aucune configuration nécessaire. Une variante non animée du même modèle (sans .mcmeta) reste statique, comme prévu.

9. Rendu des meubles sur Bedrock

Sur Java, les meubles utilisent un cadre d'item (qui affiche le modèle 3D complet). Les cadres Bedrock n'affichent qu'une icône plate — donc le convertisseur crée en plus un porte-armure invisible avec le modèle sur la tête, et affiche :

• Joueurs Java → le cadre d'item (inchangé), et
• Joueurs Bedrock → le modèle sur le porte-armure (vrai 3D),

…pour le même meuble placé, selon qui regarde. Aucun des deux ne voit de doublon. La détection utilise Floodgate (UUIDs des joueurs Bedrock). Tout est automatique ; vous n'intervenez que sur la taille via furniturescale.

10. Limites & pièges

• C'est un convertisseur CustomiZer, pas un outil "déposer n'importe quel pack Java" — le contenu doit être enregistré de la façon habituelle dans CustomiZer.
• Les configs serveur ne se mettent pas à jour automatiquement : si vous modifiez une config de pack qui existe déjà sur le serveur, modifiez-la là-bas (ou supprimez-la pour la régénérer) — mettre à jour le jar seul ne remplace pas une config existante.
• Floodgate : la détection des joueurs Bedrock (pour les meubles) suppose des UUIDs Floodgate standard.

11. Dépannage

12. Aide-mémoire des commandes

# Construire / reconstruire le pack Java puis le pack Bedrock
/zpack zip
/zpack geyser

# Obtenir un lien cliquable vers l'URL du pack Java hébergé
/zpack link

# Interfaces (menus)
/zpack bedrock gui <nom> <up|down|left|right> <valeur>
/zpack bedrock gui <nom> <valeur>           # + = vers le bas
/zpack bedrock gui <nom>                     # afficher
/zpack bedrock gui <nom> reset
/zpack bedrock gui list

# Items 3D (par emplacement main/tête)
/zpack bedrock item <nom> <hand|offhand|head> move   <x|y|z> <valeur>
/zpack bedrock item <nom> <hand|offhand|head> scale  <facteur>
/zpack bedrock item <nom> <hand|offhand|head> rotate <x|y|z> <degrés>
/zpack bedrock item <nom> <hand|offhand|head> reset
/zpack bedrock item <nom> resetall
/zpack bedrock item <nom>                     # afficher

# Taille des meubles
/zpack bedrock furniturescale <valeur>          # tous les meubles
/zpack bedrock furniturescale <nom> <valeur>   # une pièce spécifique
/zpack bedrock furniturescale                   # afficher

# Toujours relancer après chaque ajustement :
/zpack geyser