minecraft-builder

Concevez, planifiez et générez n'importe quelle structure Minecraft statique en blocs — du simple meuble au château complexe — à l'aide d'une table d'ancrage de coordonnées, d'un calque constructif en 5 passes et d'un fichier Node.js téléchargeable produisant des fichiers .nbt vanilla.

Qu'est-ce que minecraft-builder ?

Cette compétence permet de créer des structures Minecraft statiques de toutes tailles, allant du mobilier (chaises, tables, lits superposés) aux bâtiments décoratifs (puits, lampadaires, statues), en passant par les abris habitables (tentes, cabanes, tours de guet) et les édifices standards (maisons de villageois, boutiques, phares), jusqu'aux complexes (châteaux, cathédrales, places de marché). Le générateur final est un fichier Node.js ESM autonome (`.mjs`) qui exporte un fichier `.nbt` compressé pour Minecraft 26.3 (DataVersion 5023). Le processus suit une méthodologie structurée : classification en 5 niveaux de complexité (T1a à T3), brainstorming ciblé, consultation de fichiers de référence architecturale, utilisation d'une table d'ancrage de coordonnées précise, et application de règles techniques strictes (orientation des escaliers, connexion automatique des doubles coffres, portes doubles, clôtures, murs, etc.). La compétence évite les validations d'exécution en appliquant directement les règles de conception pendant l'écriture du script, ce qui garantit des fichiers .nbt propres sans erreurs. Elle est idéale pour les joueurs et créateurs de contenu Minecraft qui souhaitent concevoir des structures réalistes et téléchargeables sans passer par des outils externes.

Compatible avec✓Claude Code~Codex CLI~Cursor
Part ofMobile
npx skills add https://github.com/marvaproject/minecraft-structure-builder/tree/HEAD/minecraft-builder

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 .nbt vanilla 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'.nbt statiques.

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.

NiveauExemplesPhases appliquéesAxe
T1a — Abri simple habitableTente, abri de camp de feu, petite cabane, hutte d'une pièce, petite tour de guet1, 2, 3 (conditionnel), 4, 5Entrée dégagée, blocs au sol, meubles fonctionnels présents
T1b — Structure non habitablePuits, lampadaire, statue, panneau indicateur, pont, clôture, parcelle agricole, fontaine, monument1, 2, 3 (support uniquement), 4, 5Dimensions, élément fonctionnel (eau/lumière/connexion), intégrité du support
T1c — Meuble / objet multi-blocsChaise, table à manger, bibliothèque, banc, cadre de lit, lit superposé, trône, comptoir1, 2, 3 (ergonomie), 4, 5Ergonomie, orientation, accessibilité, cohérence des matériaux
T2 — Bâtiment standardMaison de villageois, boutique, petit temple, cottage à deux étages, bibliothèque, boulangerie, phare1, 1.5, 2, 3, 4, 5, 6Liste de contrôle architecturale et technique complète (conseil de biome)
T3 — Ensemble complexeEnsemble multi-bâtiments, château, salle communale, cathédrale, manoir, place de marché1, 1.5, 2, 3 (+voies de circulation), 4, 5, 6Liste 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) :

  1. Combien d'occupants ? (détermine les lits, les sièges, le rangement)
  2. Biome / palette (campement forestier, plaine, taïga, etc.)
  3. Enfermé ou ouvert ? Caractéristiques spéciales (camp de feu, coffre, auvent) ?

Pour T1b (Structure non habitable) :

  1. Quel est l'élément fonctionnel ? (source d'eau, source de lumière, point de connexion, axe décoratif)
  2. Dimensions cibles (hauteur × largeur × profondeur) ?
  3. Biome / palette de matériaux ?
  4. A-t-elle besoin d'un chapeau/toit/auvent ou d'une base de support ?

Pour T1c (Meuble) :

  1. Quelle est la fonction du meuble ? (siège, repas, rangement, couchage, exposition)
  2. Combien de « places » ou d'unités de capacité ? (1 chaise, table à 4 places, étagère à 6 cases)
  3. Palette de matériaux ? (chêne, sapin, chêne noir, biscornu, etc.)
  4. 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 :

  1. Occupants et fonction (qui l'utilise, objectif principal)
  2. Biome / palette de blocs
  3. Échelle et caractéristiques spéciales (empreinte au sol, niveaux, ouvert vs fermé, cheminée/balcon/auvent)
  4. 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.md et architecture-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.json dans 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() :

  1. 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_start et Y_roof_peak.
  2. 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).

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:*_stairs facing pointe 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 (ou outer_*/inner_* pour les canapés d'angle/escaliers en diagonale) afin que autoConnectStairs() 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ême Y.
    • 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.
  • 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 shape explicite (outer_left, outer_right, inner_left, inner_right ou straight — par exemple, escaliers-chaises, marches d'escalier praticables, escaliers d'angle à un seul bloc ou escaliers en diagonale) est conservé intact sauf si shape a été omis (undefined).
    • Lorsque shape est omis, autoConnectStairs() vérifie les voisins orthogonaux à la même half : il forme outer_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 forme inner_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).
  • Orientation et appariement automatique des doubles coffres (connectDoubleChests()) : Dans Minecraft, le type d'un coffre (single, left, right) est défini du point de vue du coffre lui-même (regardant dans la direction de son facing), 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 est type: 'left' (situé à gauche du coffre : leftOf[facing]).
    • Exécutez toujours connectDoubleChests() à la fin de la Phase 5 afin que les blocs minecraft:chest ou minecraft:trapped_chest adjacents partageant le même facing s'apparient automatiquement en moitiés valides type: 'right' + type: 'left' sans textures inversées (sauf si type: 'single' a été explicitement spécifié). Ne placez jamais 3 coffres du même type dans une même rangée.
  • Appariement automatique des doubles portes (autoPairDoubleDoors()) : Lorsque deux blocs *_door identiques sont placés côte à côte partageant le même facing et Y, autoPairDoubleDoors() s'exécute à la fin de la Phase 5 pour attribuer des charnières symétriques (hinge: 'left' sur la porte de gauche et hinge: 'right' sur la porte de droite depuis la perspective avant de l'observateur) sur les moitiés lower et upper afin que les poignées se rejoignent proprement au centre.
  • Clôtures, murs, portails de clôture et vitres à connexion automatique (connectFencesAndPanes() et connectWalls()) :
    • connectFencesAndPanes() calcule les propriétés booléennes north/south/east/west pour *_fence, *_pane et iron_bars, à l'exclusion des blocs non solides et non connecteurs (*_glass, *_leaves, hopper, bell, beacon, glowstone, dalles, escaliers, portes, etc.) via isFullSolidForConnection().
    • connectWalls() calcule les états d'énumération north/south/east/west ('none', 'low' ou 'tall' lorsqu'un bloc solide se trouve directement au-dessus de la connexion) plus le pilier central up ('true'/'false') pour tous les blocs *_wall, et définit automatiquement in_wall: 'true' sur tout *_fence_gate flanqué de blocs *_wall afin 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]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés