CustomiZer — Module Artisanat Personnalisé

← Retour à la doc

En une phrase : les tables d'artisanat personnalisées sont des établis en interface graphique où les joueurs placent des objets dans des emplacements d'entrée et cliquent sur l'emplacement de sortie pour fabriquer — les recettes sont créées en jeu par les admins et sauvegardées de manière persistante dans SQLite ou MongoDB.

Sommaire

1. Fonctionnement 2. Configuration 3. Commandes 4. Créer une table en jeu 5. Correspondance des recettes 6. Créer une recette en jeu 7. Toutes les clés de config 8. Recettes pour l'établi vanilla 9. Conseils & pièges

1. Fonctionnement

Une table d'artisanat est définie dans custom_crafting_tables.yml et liée à un bloc de pack via assigned_block ou un meuble de pack via assigned_furniture (ou les deux).
La table spéciale vanilla est réservée au vrai établi Minecraft — les recettes qui y sont sauvegardées fonctionnent dans tous les établis vanilla du monde. Aucun bloc ni meuble déclencheur n'est nécessaire. Ajoutez des recettes avec /zcraft create vanilla <nom>.
Quand un joueur fait un clic droit sur un bloc ou meuble personnalisé configuré, une interface graphique d'inventaire s'ouvre à la place de toute interaction vanilla.
Les joueurs placent des objets dans les emplacements d'entrée désignés et cliquent sur l'emplacement de sortie pour recevoir le résultat fabriqué.
Les objets d'entrée sont consommés ; la sortie est placée dans l'inventaire du joueur (ou déposée à ses pieds si plein).
Les recettes sont créées en jeu avec /zcraft create <tableId> <nomRecette> et stockées de manière persistante pour survivre aux redémarrages.
L'identité des objets pour la correspondance est résolue dans l'ordre : clé PDC du bloc personnalisé → CustomModelData → nom d'affichage → matériau vanilla.

2. Configuration

Emplacement du fichier : plugins/CustomiZer/custom_crafting_tables.yml

custom_crafting_tables:
  enabled: true
  storage:
    type: sqlite
    sqlite:
      file: custom_crafting_recipes.db
  tables:
    basic_workbench:
      enabled: true
      display_name: "&aEtabli Basique"
      assigned_block: "mypack:workbench_block"      # bloc de pack qui ouvre cette table au clic droit
      assigned_furniture: "mypack:workbench_item"  # OU un meuble placé qui ouvre cette table au clic droit
      permission:
        required: false
        node: "customizer.craftingtable.basic_workbench"
      gui:
        title: "&8⚒ Etabli Basique"
        rows: 5
        input_slots: [10, 11, 12, 19, 20, 21, 28, 29, 30]   # grille 3×3
        output_slots: [24]
      behavior:
        return_items_on_close: true
        consume_inputs: true
        allow_partial_outputs: false

3. Commandes

Gestion des tables

Commande	Permission	Description
`/zcraft newtable`	`cxp.craft.admin`	Ouvrir l'assistant de création de table en jeu — configurer la mise en page, les déclencheurs et sauvegarder sans toucher aucun fichier.
`/zcraft deletetable <tableId>`	`cxp.craft.admin`	Supprimer une définition de table de `custom_crafting_tables.yml` et recharger à chaud. Les recettes sauvegardées pour cette table sont conservées dans la base de données.
`/zcraft tables`	`cxp.craft.admin`	Lister toutes les définitions de tables chargées avec leur nombre de rangées, d'emplacements et le bloc assigné.
`/zcraft reload`	`cxp.craft.admin`	Recharger les définitions de tables et les recettes depuis le disque/la base de données sans redémarrer.

Gestion des recettes

Commande	Permission	Description
`/zcraft open [tableId]`	`cxp.craft`	Ouvrir directement l'interface d'une table d'artisanat par nom (sans bloc physique). Ouvre la table par défaut si non précisé.
`/zcraft create <tableId> <nom>`	`cxp.craft.admin`	Ouvrir le concepteur de recettes pour une recette nouvelle ou existante sur la table donnée.
`/zcraft edit <tableId> <nom>`	`cxp.craft.admin`	Alias de `/zcraft create`.
`/zcraft delete <tableId> <nom>`	`cxp.craft.admin`	Supprimer une recette sauvegardée par identifiant de table et nom de recette.
`/zcraft list [tableId]`	`cxp.craft`	Lister toutes les recettes sauvegardées, optionnellement filtrées par table.
`/zcraft browse [tableId]`	`cxp.craft.admin`	Ouvrir le navigateur de recettes en interface graphique, optionnellement filtré sur une table.
`/zcraft debug <tableId> <nom>`	`cxp.craft.admin`	Afficher les détails d'une recette dans le chat (grille, sorties, mode, permission).

4. Créer une table en jeu

Vous n'avez jamais besoin de modifier custom_crafting_tables.yml à la main — l'assistant gère tout.

1Lancez /zcraft newtable pour ouvrir l'interface de configuration.
2ID de la table — cliquez sur la Bibliothèque, tapez un ID unique dans le chat (ex. forge_table). Lettres, chiffres et tirets bas uniquement.
3Titre de l'interface — cliquez sur le Cartouche, tapez le titre que les joueurs verront (supporte les codes couleur &6).
4Rangées — cliquez sur l'une des vitres 1–6 pour définir la hauteur de l'interface.
5Déclencheur — cliquez optionnellement sur le Bloc de notes pour définir un assigned_block (pack:id) et/ou sur le Cadre d'affichage pour définir un assigned_furniture (pack:id). Les joueurs font un clic droit sur ce bloc/meuble dans le monde pour ouvrir la table.
6Cliquez sur Concevoir la mise en page → (Tableau). Dans le peintre d'emplacements, cliquez sur chaque case pour cycler : ■ ENTRÉE → ■ SORTIE → vide. Cliquez sur ✓ Terminer quand c'est fini.
7De retour dans le menu de configuration, cliquez sur ✓ Sauvegarder (Émeraude) — la table est écrite dans custom_crafting_tables.yml et chargée immédiatement. Aucun redémarrage nécessaire.
8Ajoutez des recettes avec /zcraft create <tableId> <nomRecette>.

Tapez cancel dans le chat à n'importe quelle invite pour revenir au menu de configuration sans rien changer.

Étape 1 — /zcraft newtable ouvre ce menu de configuration

📚ID table

🏷️Titre

🎵Bloc

🖼️Meuble

1rangée

2rangées

3rangées

4rangées ✓

5rangées

6rangées

🎨Mise en page →

💎Sauvegarder ✓

Sélectionné / prêt Non sélectionné

Étape 6 — cliquer sur 🎨 Mise en page ouvre le peintre d'emplacements (exemple : 3×3 entrées + 1 sortie)

ENTRÉE

SORTIE

ENTRÉE

◀Retour

✔Terminer

Vide (1 clic) ENTRÉE — bleu (2 clics) SORTIE — rouge (3 clics)

Pour supprimer une table : /zcraft deletetable <tableId>. Cela supprime la définition mais conserve les recettes dans la base de données — utile si vous souhaitez recréer la table plus tard avec le même ID.

5. Correspondance des recettes

Recettes avec forme

Les objets doivent correspondre à la disposition enregistrée. La disposition peut être placée n'importe où dans la grille d'entrée — le plugin fait glisser le motif sur les emplacements disponibles (correspondance par décalage), donc une recette 2×2 fonctionne dans n'importe quel coin d'une grille 3×3.

Recettes sans forme

L'ordre n'a pas d'importance — seul l'ensemble d'objets compte. Utile pour combiner des ingrédients sans arrangement fixe.

Ordre de résolution de l'identité des objets

Clé PDC du pack personnalisé (customizer:item_key) — le plus spécifique
Valeur entière CustomModelData
Nom d'affichage (correspondance exacte)
Matériau Bukkit vanilla — le moins spécifique

Cet ordre de résolution signifie que deux objets personnalisés avec le même matériau vanilla mais des identifiants de pack différents sont toujours traités comme distincts dans les recettes.

6. Créer une recette en jeu

1Lancez /zcraft create <tableId> <nomRecette> pour ouvrir le concepteur de recettes pour cette table.
2Placez les ingrédients dans les emplacements d'entrée bleus dans l'arrangement souhaité.
3Placez l'objet résultat dans l'emplacement de sortie rouge.
4Optionnellement, basculez le mode Avec forme / Sans forme et définissez un nœud de permission via les boutons de contrôle dans la dernière rangée.
5Fermez l'interface — la recette est sauvegardée automatiquement et active immédiatement.

Concepteur de recettes — /zcraft create basic_workbench ma_recette (table 5 rangées)

🌾entrée

entrée

🌾entrée

entrée

⚔️sortie

entrée

🔀Avec forme

🔑Perm

💾Sauver

Emplacement d'entrée — placez vos ingrédients Emplacement de sortie — placez le résultat Verrouillé — hors de la mise en page de cette table

7. Toutes les clés de configuration

Clé	Requis	Défaut	Description
`enabled`	Non	`true`	Activer ou désactiver l'ensemble du module ou une table spécifique.
`storage.type`	Non	`sqlite`	`sqlite` ou `mongodb`.
`storage.sqlite.file`	Non	`custom_crafting_recipes.db`	Fichier de base de données SQLite (relatif au dossier du plugin).
`assigned_block`	Non*	—	Clé de bloc de pack (`pack:id`) qui ouvre cette table au clic droit. Au moins un des deux (`assigned_block` ou `assigned_furniture`) doit être défini.
`assigned_furniture`	Non*	—	Clé de meuble de pack (`pack:id`) qui ouvre cette table au clic droit sur un meuble placé. Peut être utilisé à la place ou en complément de `assigned_block`.
`display_name`	Oui	—	Nom de cette table d'artisanat (codes de couleur legacy supportés).
`permission.required`	Non	`false`	Si le nœud de permission est requis pour utiliser cette table.
`permission.node`	Non	—	Chaîne de nœud de permission vérifiée quand `required: true`.
`gui.title`	Oui	—	Titre de l'inventaire (codes de couleur legacy).
`gui.rows`	Oui	—	Nombre de rangées dans l'interface (1–6).
`gui.input_slots`	Oui	—	Liste des indices d'emplacements servant d'entrées.
`gui.output_slots`	Oui	—	Liste des indices d'emplacements servant de sorties (généralement un seul).
`behavior.return_items_on_close`	Non	`true`	Retourner les objets d'entrée dans l'inventaire du joueur quand il ferme l'interface sans fabriquer.
`behavior.consume_inputs`	Non	`true`	Si les objets d'entrée sont retirés des emplacements lors d'une fabrication réussie.
`behavior.allow_partial_outputs`	Non	`false`	Si `false`, la fabrication est bloquée si l'inventaire du joueur est complètement plein.

8. Ajouter des recettes à l'établi vanilla

La table vanilla est une table réservée spéciale qui s'accroche au vrai établi Minecraft — celui que les joueurs ouvrent en faisant un clic droit sur n'importe quel établi normal dans le monde.

Les recettes sauvegardées dans la table vanilla fonctionnent dans tous les établis vanilla du serveur. Aucun bloc personnalisé, aucun meuble, aucune configuration nécessaire pour les joueurs.

1Lancez /zcraft create vanilla <nomRecette> — ex. /zcraft create vanilla epee_magique.
2Le concepteur s'ouvre avec une grille 3×3, correspondant exactement à l'établi vanilla. Placez vos ingrédients et la sortie normalement.
3Fermez l'interface — la recette est sauvegardée immédiatement et fonctionne dans tous les établis vanilla du serveur.

Concepteur vanilla — /zcraft create vanilla epee_magique (grille 3×3 de l'établi normal)

💎entrée

⚔️sortie

🪵entrée

entrée

💾Sauver

Emplacement d'entrée — placez les ingrédients Emplacement de sortie — placez le résultat La recette fonctionne dans tous les établis vanilla du serveur

Toutes les recettes vanilla Minecraft existantes (bâtons, outils, etc.) ne sont pas touchées. CustomiZer n'intercepte l'emplacement que quand l'une de vos recettes personnalisées correspond — sinon Bukkit gère l'artisanat normalement.

9. Conseils & pièges

Les emplacements d'entrée ne doivent pas chevaucher les emplacements de sortie — le plugin avertit au chargement si c'est le cas.
Vous pouvez avoir plusieurs emplacements de sortie pour produire plusieurs piles de sortie en une seule opération de fabrication.
Les deux champs assigned_block et assigned_furniture peuvent être définis sur la même table — l'un ou l'autre déclencheur l'ouvre.
Le déclencheur de clic droit intercepte l'interaction même si le bloc ou le meuble ferait normalement quelque chose d'autre — CustomiZer s'exécute en premier.
Les recettes sont globales par table — tous les joueurs utilisent la même liste de recettes pour une table donnée.
La suppression d'une recette avec /zcraft delete prend effet immédiatement sans rechargement.
/zcraft deletetable ne supprime que la définition de la table — les recettes sauvegardées restent dans la base de données et se rattacheront si vous recréez la table avec le même ID.
Pour utiliser MongoDB, ajoutez une section mongodb: sous storage avec les clés uri, database et collection.

CustomiZer — Module Artisanat Personnalisé. Config : plugins/CustomiZer/custom_crafting_tables.yml · Base de données des recettes : plugins/CustomiZer/custom_crafting_recipes.db