Minecraft Builder
Concevez des structures Minecraft fonctionnelles et architecturalement solides, de n'importe quelle échelle statique en blocs — d'un minuscule meuble 1×2 à un château tentaculaire — grâce à un brainstorming collaboratif ciblé, une revue architecturale par niveaux, un mapping précis des coordonnées d'ancrage et un calque constructif en 5 passes. Le résultat final est un fichier ESM (.mjs) autonome, sans dépendances et téléchargeable (exporté via l'outil de génération de fichiers plutôt que de déverser des blocs de code bruts dans le chat) qui génère un fichier de structure .nbt compressé pour Minecraft 26.3 (DataVersion: 5023) proprement, sans erreurs de validation d'exécution.
Quand utiliser
- L'utilisateur demande de créer, concevoir ou générer n'importe quelle structure Minecraft statique en blocs :
- Meubles et accessoires (T1c) : chaises, tables à manger, bibliothèques, bancs, lits superposés, trônes, comptoirs, lampes, râteliers d'armes.
- Structures décoratives et civiques (T1b) : puits, lampadaires, statues, panneaux indicateurs, ponts, clôtures, parcelles agricoles, fontaines, monuments, tonnelles.
- Abris simples habitables (T1a) : tentes, abris de camp de feu, cabanes, huttes d'une pièce, petites tours de guet.
- Bâtiments standards (T2) : maisons de villageois, boutiques, petits temples, cottages à deux étages, bibliothèques, boulangeries, phares, étables.
- Ensembles complexes (T3) : châteaux, cathédrales, salles communales, manoirs, places de marché, établissements fortifiés.
- L'utilisateur souhaite un script Node.js autonome produisant un fichier
.nbtvanilla prêt à être exécuté localement et visualisé en 3D sur Shulkr Viewer.
Hors champ
Cette compétence ne gère pas :
- La logique redstone (circuits, portes à pistons, pièges) — utilisez une compétence dédiée à la redstone.
- Le terrassement (montagnes, vallées, rivières, terrain personnalisé) — utilisez une compétence dédiée au terrain.
- Les états d'entité de blocs (contenu des coffres, progression des fours, texte des panneaux) — le template écrit uniquement la palette/les blocs ; modifiez ces éléments en jeu après le chargement.
- La pose d'entités (supports d'armure, cadres d'objets avec objets spécifiques) — nécessite un NBT d'entité bien au-delà du template de base.
- Les blocs de commande / animations — pas d'
.nbtstatiques.
Si l'utilisateur demande l'un des éléments ci-dessus, indiquez clairement la limitation et proposez l'alternative statique la plus proche.
Structure des dossiers
minecraft-builder/
├── SKILL.md
├── registry_26_3.json
└── references/
├── architecture-principles.md (T2 et T3)
├── biome-styles.md (T2 et T3, ou T1 assorti au biome)
├── room-templates.md (T2 et T3)
└── furniture-patterns.md (T1c)
Niveaux de complexité des constructions
Classez d'abord chaque demande dans l'un des cinq niveaux. Le niveau détermine les phases, règles techniques et fichiers de référence applicables.
| Niveau | Exemples | Phases appliquées | Axe |
|---|---|---|---|
| T1a — Abri simple habitable | Tente, abri de camp de feu, petite cabane, hutte d'une pièce, petite tour de guet | 1, 2, 3 (conditionnel), 4, 5 | Entrée dégagée, blocs au sol, meubles fonctionnels présents |
| T1b — Structure non habitable | Puits, lampadaire, statue, panneau indicateur, pont, clôture, parcelle agricole, fontaine, monument | 1, 2, 3 (support uniquement), 4, 5 | Dimensions, élément fonctionnel (eau/lumière/connexion), intégrité du support |
| T1c — Meuble / objet multi-blocs | Chaise, table à manger, bibliothèque, banc, cadre de lit, lit superposé, trône, comptoir | 1, 2, 3 (ergonomie), 4, 5 | Ergonomie, orientation, accessibilité, cohérence des matériaux |
| T2 — Bâtiment standard | Maison de villageois, boutique, petit temple, cottage à deux étages, bibliothèque, boulangerie, phare | 1, 1.5, 2, 3, 4, 5, 6 | Liste de contrôle architecturale et technique complète (conseil de biome) |
| T3 — Ensemble complexe | Ensemble multi-bâtiments, château, salle communale, cathédrale, manoir, place de marché | 1, 1.5, 2, 3 (+voies de circulation), 4, 5, 6 | Liste de contrôle complète, cohérence stricte du biome, circulation explicite entre les pièces |
Si le niveau est ambigu, demandez à l'utilisateur : « Est-ce un meuble (chaise/table), une structure décorative (puits/lampadaire/statue), un abri simple (tente/cabane), un bâtiment standard (maison/boutique) ou un ensemble complexe (château/salle communale) ? »
Flux de travail
Phase 1 : Brainstorming et clarification brefs (lorsque les détails sont ambigus)
Classez d'abord le niveau de construction. Si les paramètres de conception clés manquent ou sont ambigus, posez 2 à 4 questions concrètes et ciblées adaptées au niveau :
Pour T1a (Abri simple habitable) :
- Combien d'occupants ? (détermine les lits, les sièges, le rangement)
- Biome / palette (campement forestier, plaine, taïga, etc.)
- Enfermé ou ouvert ? Caractéristiques spéciales (camp de feu, coffre, auvent) ?
Pour T1b (Structure non habitable) :
- Quel est l'élément fonctionnel ? (source d'eau, source de lumière, point de connexion, axe décoratif)
- Dimensions cibles (hauteur × largeur × profondeur) ?
- Biome / palette de matériaux ?
- A-t-elle besoin d'un chapeau/toit/auvent ou d'une base de support ?
Pour T1c (Meuble) :
- Quelle est la fonction du meuble ? (siège, repas, rangement, couchage, exposition)
- Combien de « places » ou d'unités de capacité ? (1 chaise, table à 4 places, étagère à 6 cases)
- Palette de matériaux ? (chêne, sapin, chêne noir, biscornu, etc.)
- Où sera-t-il placé ? (contre un mur, au centre d'une pièce, à l'extérieur) — affecte l'orientation par défaut.
Pour T2 / T3 :
- Occupants et fonction (qui l'utilise, objectif principal)
- Biome / palette de blocs
- Échelle et caractéristiques spéciales (empreinte au sol, niveaux, ouvert vs fermé, cheminée/balcon/auvent)
- Pour T3 : nombre de bâtiments/ailes connectés, le cas échéant
Passez le brainstorming et passez directement à la phase suivante si l'utilisateur a déjà spécifié ces détails ou demande explicitement de générer immédiatement.
Phase 1.5 : Revue architecturale (T2 et T3 uniquement)
Passez cette phase pour T1a, T1b et T1c.
Pour T2 et T3, consultez les fichiers de référence dans references/ avant de verrouiller les coordonnées :
architecture-principles.md— proportions, profondeur de façade, détails de silhouette, circulation, éclairage et règles de cohérence des matériaux.biome-styles.md— palette et style de toit pour le biome choisi ; si l'utilisateur n'a pas choisi de biome, sélectionnez-en un et énoncez le choix explicitement.room-templates.md— tailles minimales des pièces et blocs fonctionnels requis par pièce/zone.
Résolvez chaque point avant la Phase 3 :
- Chaque pièce/zone respecte les dimensions minimales pour sa fonction (d'après
room-templates.md). - Au moins une source de lumière par zone intérieure de 4×4 (d'après
architecture-principles.md). - Le style de toit correspond au biome choisi et inclut un débord d'un bloc (d'après
biome-styles.mdetarchitecture-principles.md). - Palette de matériaux ≤ 3 primaires + 1 accent, avec gradation verticale (base en pierre/lourd, mur principal en bois).
- Profondeur de façade et silhouette : piliers d'encadrement d'angle (
log) + ≥ 2 détails de silhouette/trim (cheminée extérieure, volets en trapdoor, porche/balcon, lucarne, vignes). - Norme de navigation Sims : Zones dégagées d'un bloc devant/derrière les portes et portails de clôture, aux paliers intérieurs bas/hauts des escaliers et échelles, à côté des lits (plus 2 blocs d'air au-dessus), devant les coffres/établis/sièges, aux coins de couloir à 90°, et ≥ 1 rangée de sol praticable à l'intérieur de toute rampe de balcon/pont (profondeur totale ≥ 2 blocs).
- Les proportions du bâtiment ne sont pas 1:1:1 (variez la largeur, la profondeur et la hauteur).
- Circulation : chaque pièce accessible via un chemin d'au moins 1 bloc de large (≥ 2 blocs pour les chemins principaux) depuis l'entrée.
Phase 2 : Consultation du registre des blocs (registry_26_3.json)
- Inspectez
registry_26_3.jsondans le répertoire de la compétence pour vérifier les identifiants exacts des blocs (minecraft:<name>) et les propriétés d'état de blocs valides pour Minecraft 26.3 (DataVersion: 5023), en particulier pour les blocs plus récents (variantes du cuivre, pale oak, résine, briques de tuf, etc.). - Ne devinez jamais les noms de propriétés d'état de blocs ou les valeurs d'énumération autorisées.
- Si un bloc ou une propriété demandé manque dans le registre, signalez l'écart à l'utilisateur et proposez l'alternative valide la plus proche plutôt que d'inventer silencieusement des identifiants.
Phase 3 : Table d'ancrage des coordonnées et règles de construction techniques
Ne dessinez PAS de grilles de caractères ASCII. Définissez une table d'ancrage des coordonnées (X, Y, Z) exacte avant d'écrire du code, de sorte que chaque placement de bloc corresponde 1:1 aux appels setBlock() / fill() :
- Boîte englobante et niveau d'élévation :
- Déclarez
SIZE = [W, H, L](X: 0..W-1,Y: 0..H-1,Z: 0..L-1). - Fixez les niveaux d'élévation exacts :
Y_base(fondations/échasses),Y_floor1(rez-de-chaussée),Y_floor2(étage supérieur, le cas échéant),Y_roof_startetY_roof_peak.
- Déclarez
- Table des coordonnées d'ancrage : Listez les coordonnées exactes et les directions de face pour :
- Coque extérieure et piliers d'encadrement : Coordonnées des poteaux d'angle
(X, Z)et limites des murs. - Limites du sol intérieur (
X_min..X_max,Z_min..Z_max) : Vérifiez explicitement que chaque lit, coffre, table et établi intérieur se trouve strictement à l'intérieur des limites du sol intérieur (X_wall_west + 1 .. X_wall_east - 1,Z_wall_north + 1 .. Z_wall_south - 1) et ne chevauche jamais une coordonnée de mur extérieur ou de cloison. - Portes / Entrées :
(X, Y_floor, Z)+facing+hinge+ tuiles avant/arrière dégagées. - Escaliers : Palier d'entrée intérieur bas
(X0, Y1, Z0)→ Première marche(X1, Y1, Z1)→ (si tournant : palier de tournant(Xt, Y_turn, Zt)) → Dernière marche(X2, Y2-1, Z2)→ Palier de sortie intérieur haut(X3, Y2, Z3)+facing. - Balcons / Porches (le cas échéant) : Limites du sol praticable par rapport aux coordonnées de la rampe extérieure (en assurant ≥ 1 rangée de blocs praticables à l'intérieur de la clôture).
- Cheminée / Puits techniques : Colonne extérieure
(X, Z)en dehors de la pente principale du toit avec vérification du chapeau à 4 côtés. - Éléments intérieurs / fonctionnels clés : Lits, escaliers-chaises/canapés (avec direction de dossier et
shape: 'straight'explicite), établis, rangement, cœurs d'eau/lumière et meubles avec coordonnées(X, Y, Z).
- Coque extérieure et piliers d'encadrement : Coordonnées des poteaux d'angle
Règles de détails techniques (Appliquées par conception et ordre des calques — pas de validateurs d'exécution)
Appliquez ces règles de construction techniques directement lors de l'écriture du script de construction :
Règles universelles (tous niveaux) :
- Règle d'orientation et de verrouillage de forme explicite des escaliers-sièges Minecraft : Dans Minecraft,
minecraft:*_stairsfacingpointe vers le côté dossier haut (marche montante), PAS le côté bas du siège.- Lorsque vous utilisez des escaliers comme chaises, canapés ou marches d'escalier praticables, passez toujours
shape: 'straight'explicitement (ououter_*/inner_*pour les canapés d'angle/escaliers en diagonale) afin queautoConnectStairs()ne transforme jamais accidentellement une chaise ou une marche d'escalier en bloc de toit d'angle si elle est placée adjacente à un autre escalier au mêmeY. - N'omettez
shape(undefined) que sur les escaliers de toit qui doivent se joindre automatiquement en croupes/arêtiers. - Pour les tables basses, utilisez des dalles
bottom(type: 'bottom') afin qu'elles reposent à fleur du sol sans flotter.
- Lorsque vous utilisez des escaliers comme chaises, canapés ou marches d'escalier praticables, passez toujours
- Escaliers de toit à connexion automatique, escaliers d'angle et escaliers à un seul bloc (
autoConnectStairs()) : Lors de la construction de toits en pente, en croupe ou pyramidaux avec*_stairs,autoConnectStairs()s'exécute à la fin de la Phase 5 en utilisant les règles de verrouillage vanilla de Minecraft :- Tout escalier placé avec un
shapeexplicite (outer_left,outer_right,inner_left,inner_rightoustraight— par exemple, escaliers-chaises, marches d'escalier praticables, escaliers d'angle à un seul bloc ou escaliers en diagonale) est conservé intact sauf sishapea été omis (undefined). - Lorsque
shapeest omis,autoConnectStairs()vérifie les voisins orthogonaux à la mêmehalf: il formeouter_left/outer_rightà partir d'un escalier perpendiculaire devant (+facing) UNIQUEMENT si le côté latéral opposé n'est pas verrouillé par un escalier parallèle (facing === f), et formeinner_left/inner_rightà partir d'un escalier perpendiculaire derrière (-facing) UNIQUEMENT si le côté latéral correspondant n'est pas verrouillé par un escalier parallèle (facing === f).
- Tout escalier placé avec un
- Orientation et appariement automatique des doubles coffres (
connectDoubleChests()) : Dans Minecraft, letyped'un coffre (single,left,right) est défini du point de vue du coffre lui-même (regardant dans la direction de sonfacing), PAS du point de vue de l'observateur :- Lorsque vous vous tenez devant un double coffre en regardant sa serrure : le bloc à gauche de l'observateur est
type: 'right'(situé à droite du coffre :rightOf[facing]), et le bloc à droite de l'observateur esttype: 'left'(situé à gauche du coffre :leftOf[facing]). - Exécutez toujours
connectDoubleChests()à la fin de la Phase 5 afin que les blocsminecraft:chestouminecraft:trapped_chestadjacents partageant le mêmefacings'apparient automatiquement en moitiés validestype: 'right'+type: 'left'sans textures inversées (sauf sitype: 'single'a été explicitement spécifié). Ne placez jamais 3 coffres du même type dans une même rangée.
- Lorsque vous vous tenez devant un double coffre en regardant sa serrure : le bloc à gauche de l'observateur est
- Appariement automatique des doubles portes (
autoPairDoubleDoors()) : Lorsque deux blocs*_dooridentiques sont placés côte à côte partageant le mêmefacingetY,autoPairDoubleDoors()s'exécute à la fin de la Phase 5 pour attribuer des charnières symétriques (hinge: 'left'sur la porte de gauche ethinge: 'right'sur la porte de droite depuis la perspective avant de l'observateur) sur les moitiésloweretupperafin que les poignées se rejoignent proprement au centre. - Clôtures, murs, portails de clôture et vitres à connexion automatique (
connectFencesAndPanes()etconnectWalls()) :connectFencesAndPanes()calcule les propriétés booléennesnorth/south/east/westpour*_fence,*_paneetiron_bars, à l'exclusion des blocs non solides et non connecteurs (*_glass,*_leaves,hopper,bell,beacon,glowstone, dalles, escaliers, portes, etc.) viaisFullSolidForConnection().connectWalls()calcule les états d'énumérationnorth/south/east/west('none','low'ou'tall'lorsqu'un bloc solide se trouve directement au-dessus de la connexion) plus le pilier centralup('true'/'false') pour tous les blocs*_wall, et définit automatiquementin_wall: 'true'sur tout*_fence_gateflanqué de blocs*_wallafin que le portail s'abaisse à fleur du mur.
- Fonction d'aide aux lits jumelés (
placeBed(x, y, z, color, facing)) : Placez toujours les lits
…
[suite tronquée pour la traduction]