CommunityProgramación y desarrollogithub.com

minecraft-builder

Idea, diseña y genera cualquier estructura estática de bloques en Minecraft, desde muebles individuales hasta castillos complejos, utilizando un archivo Node.js descargable que exporta archivos .nbt de Minecraft vanilla.

¿Qué es minecraft-builder?

Este skill automatiza por completo el proceso de diseñar y generar cualquier estructura basada en bloques estáticos en Minecraft, desde pequeños muebles hasta recintos complejos, produciendo un archivo ejecutable Node.js (.mjs) independiente y sin dependencias. El flujo de trabajo abarca una fase de lluvia de ideas colaborativa (con preguntas adaptadas al nivel de complejidad), una revisión arquitectónica para niveles T2/T3, la búsqueda de bloques en un registro actualizado (registry_26_3.json) para Minecraft 26.3, la definición de una tabla de coordenadas ancla (X, Y, Z) y un proceso de capas constructivas de 5 pasos que aplica reglas técnicas como la orientación de escaleras y asientos, la conexión automática de escaleras en techos, el emparejamiento de cofres dobles y puertas dobles, y la conexión de vallas y muros. El resultado final es un archivo .nbt comprimido con gzip listo para cargar en Minecraft o previsualizar en Shulkr Viewer, todo ello sin necesidad de validaciones en tiempo de ejecución que puedan provocar fallos. El skill admite estructuras de cualquier nivel: desde muebles (T1c) y elementos decorativos (T1b) hasta refugios sencillos (T1a), edificios estándar (T2) y complejos compuestos (T3), con reglas específicas para cada nivel.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Minecraft Builder (Constructor de Minecraft)

Diseña estructuras de Minecraft funcionales y arquitectónicamente sólidas de cualquier escala estática basada en bloques, desde pequeños muebles de 1×2 hasta castillos extensos, mediante una breve lluvia de ideas colaborativa, una revisión arquitectónica por niveles, un mapeo exacto de coordenadas ancla y un capas constructivas de 5 pasos. El resultado final es un archivo ESM (.mjs) autónomo, sin dependencias y descargable (exportado mediante la herramienta de generación de archivos en lugar de volcar bloques de código sin procesar en el chat) que genera un archivo de estructura .nbt comprimido con gzip para Minecraft 26.3 (DataVersion: 5023) de forma limpia, sin fallos de validación en tiempo de ejecución.

Cuándo Usarlo

  • El usuario solicita crear, diseñar o generar cualquier estructura estática de bloques de Minecraft:
    • Muebles y Accesorios (T1c): sillas, mesas de comedor, estanterías, bancos, camas literas, tronos, mostradores, lámparas, soportes para armas.
    • Estructuras Decorativas y Cívicas (T1b): pozos, farolas, estatuas, postes indicadores, puentes, vallas, parcelas de cultivo, fuentes, monumentos, cenadores.
    • Refugios Habitables Sencillos (T1a): tiendas de campaña, refugios junto a la hoguera, cobertizos, chozas de una habitación, atalayas pequeñas.
    • Edificios Estándar (T2): casas de aldeanos, tiendas, templos pequeños, casas de campo de 2 pisos, bibliotecas, panaderías, faros, establos.
    • Recintos Complejos (T3): castillos, catedrales, ayuntamientos, mansiones, plazas de mercado, asentamientos amurallados.
  • El usuario desea un script independiente de Node.js que genere un archivo .nbt listo para ejecutar localmente y previsualizar en 3D en Shulkr Viewer.

Fuera del Alcance

Este skill no maneja:

  • Lógica de redstone (circuitos, puertas de pistones, trampas) — usa un skill dedicado de redstone.
  • Terreno (montañas, valles, ríos, terreno personalizado) — usa un skill dedicado de terreno.
  • Estado de entidades de bloque (contenido de cofres, progreso de hornos, texto de carteles) — la plantilla solo escribe paleta/bloques; edítalos en el juego después de cargar el archivo.
  • Poseo de entidades (soportes para armadura, marcos de objetos con objetos específicos) — requiere NBT de entidades mucho más allá de la plantilla base.
  • Bloques de comando / animaciones — no son estructuras .nbt estáticas.

Si el usuario solicita algo de lo anterior, indica claramente la limitación y ofrece la alternativa estática de bloques más cercana.

Estructura de Carpetas

minecraft-builder/
├── SKILL.md
├── registry_26_3.json
└── references/
    ├── architecture-principles.md   (T2 y T3)
    ├── biome-styles.md              (T2 y T3, o T1 con coincidencia de bioma)
    ├── room-templates.md            (T2 y T3)
    └── furniture-patterns.md        (T1c)

Niveles de Complejidad de Construcción

Clasifica cada solicitud en uno de los cinco niveles primero. El nivel determina qué fases, reglas técnicas y archivos de referencia se aplican.

| Nivel | Ejemplos | Fases aplicadas | Enfoque | |---|---|---|---| | T1a — Habitable Sencillo | Tienda de campaña, refugio junto a la hoguera, cobertizo pequeño, choza de una habitación, atalaya pequeña | 1, 2, 3 (condicional), 4, 5 | Entrada despejada, bloques en el suelo, mobiliario funcional presente | | T1b — Estructura No Habitable | Pozo, farola, estatua, poste indicador, puente, valla, parcela de cultivo, fuente, monumento | 1, 2, 3 (solo soporte), 4, 5 | Dimensiones, elemento funcional (agua/luz/conexión), integridad del soporte | | T1c — Mueble / Objeto de Varios Bloques | Silla, mesa de comedor, estantería, banco, cama, cama litera, trono, mostrador | 1, 2, 3 (ergonomía), 4, 5 | Ergonomía, orientación, accesibilidad, coherencia de materiales | | T2 — Edificio Estándar | Casa de aldeano, tienda, templo pequeño, casa de campo de 2 pisos, biblioteca, panadería, faro | 1, 1.5, 2, 3, 4, 5, 6 | Lista de verificación arquitectónica y técnica completa (recomendación de bioma) | | T3 — Recinto Complejo | Recinto de múltiples edificios, castillo, ayuntamiento, catedral, mansión, plaza de mercado | 1, 1.5, 2, 3 (+rutas de circulación), 4, 5, 6 | Lista de verificación completa, coherencia estricta del bioma, circulación explícita entre habitaciones |

Si el nivel es ambiguo, pregunta al usuario: "¿Es esto un mueble (silla/mesa), una estructura decorativa (pozo/farola/estatua), un refugio sencillo (tienda/cobertizo), un edificio estándar (casa/tienda) o un recinto complejo (castillo/ayuntamiento)?"

Flujo de Trabajo

Fase 1: Lluvia de Ideas Breve y Aclaración (Cuando los Detalles Son Ambiguos)

Clasifica el nivel de construcción primero. Si faltan parámetros clave de diseño o son ambiguos, haz de 2 a 4 preguntas concisas y concretas adaptadas al nivel:

Para T1a (Habitable Sencillo):

  1. ¿Cuántos ocupantes? (determina camas, asientos, almacenamiento)
  2. Bioma / paleta (campamento en el bosque, llanuras, taiga, etc.)
  3. ¿Cerrado o al aire libre? ¿Características especiales (hoguera, cofre, toldo)?

Para T1b (Estructura No Habitable):

  1. ¿Cuál es el elemento funcional? (fuente de agua, fuente de luz, punto de conexión, enfoque decorativo)
  2. Dimensiones objetivo (alto × ancho × fondo)?
  3. ¿Bioma / paleta de materiales?
  4. ¿Necesita un remate/techo/toldo o una base de soporte?

Para T1c (Mueble):

  1. ¿Cuál es la función del mueble? (asiento, comedor, almacenamiento, dormir, exhibición)
  2. ¿Cuántos "asientos" o unidades de capacidad? (1 silla, mesa de 4 asientos, estante de 6 espacios)
  3. ¿Paleta de materiales? (roble, abeto, roble oscuro, distorsionado, etc.)
  4. ¿Dónde se colocará? (contra la pared, centro de la habitación, exterior) — afecta las orientaciones predeterminadas.

Para T2 / T3:

  1. Ocupantes y función (quién lo usa, propósito principal)
  2. Bioma / paleta de bloques
  3. Escala y características especiales (huella, niveles, aire libre vs. cerrado, chimenea/balcón/toldo)
  4. Para T3: número de edificios/alas conectadas, si las hay

Omite la lluvia de ideas y continúa directamente a la siguiente fase si el usuario ya ha especificado estos detalles o solicita explícitamente generar de inmediato.

Fase 1.5: Revisión Arquitectónica (Solo T2 y T3)

Omite esta fase para T1a, T1b y T1c.

Para T2 y T3, consulta los archivos de referencia en references/ antes de fijar las coordenadas:

  • architecture-principles.md — reglas de proporción, profundidad de fachada, detalles de silueta, circulación, iluminación y coherencia de materiales.
  • biome-styles.md — paleta y estilo de techo para el bioma elegido; si el usuario no eligió un bioma, selecciona uno y declara la elección explícitamente.
  • room-templates.md — tamaños mínimos de habitaciones y bloques funcionales requeridos por habitación/zona.

Resuelve cada elemento antes de la Fase 3:

  • [ ] Cada habitación/zona cumple con las dimensiones mínimas para su función (de room-templates.md).
  • [ ] Al menos una fuente de luz por cada área interior de 4×4 (de architecture-principles.md).
  • [ ] El estilo del techo coincide con el bioma elegido e incluye un voladizo de 1 bloque (de biome-styles.md & architecture-principles.md).
  • [ ] Paleta de materiales ≤ 3 primarios + 1 de acento, con gradación vertical (base de piedra/pesada, pared principal de madera).
  • [ ] Profundidad y silueta de la fachada: pilares de marco en las esquinas (log) + ≥ 2 detalles de silueta/recorte (chimenea exterior, contraventanas de trampilla, porche/balcón, buhardilla, enredaderas).
  • [ ] Estándar de navegación de Los Sims: zonas transitables claras de 1 bloque delante y detrás de puertas y puertas de valla, en los rellanos inferiores/superiores interiores de escaleras y escaleras de mano, junto a las camas (más 2 bloques de aire sobre ellas), delante de cofres/puestos de trabajo/asientos, en las esquinas de pasillos de 90°, y ≥ 1 fila de suelo transitable dentro de cualquier barandilla de balcón/terraza (profundidad total ≥ 2 bloques).
  • [ ] Las proporciones del edificio no son 1:1:1 (variar ancho, fondo y alto).
  • [ ] Circulación: todas las habitaciones son accesibles a través de un camino de ≥ 1 bloque de ancho (≥ 2 bloques para caminos principales) desde la entrada.

Fase 2: Consulta del Registro de Bloques (registry_26_3.json)

  • Inspecciona registry_26_3.json en el directorio del skill para verificar los ID de bloque exactos (minecraft:<nombre>) y las propiedades de estado de bloque válidas para Minecraft 26.3 (DataVersion: 5023), especialmente para bloques más nuevos (variantes de cobre, roble pálido, resina, ladrillos de toba, etc.).
  • Nunca adivines los nombres de las propiedades de estado de bloque ni los valores de enumeración permitidos.
  • Si falta un bloque o propiedad solicitado en el registro, comunica la diferencia al usuario y propón la alternativa válida más cercana en lugar de inventar ID en silencio.

Fase 3: Tabla de Coordenadas Ancla y Reglas Técnicas de Construcción

NO dibujes cuadrículas de caracteres ASCII. Define una Tabla de Coordenadas Ancla (X, Y, Z) exacta antes de escribir código para que cada colocación de bloque se corresponda 1:1 con las llamadas setBlock() / fill():

  1. Caja Delimitadora y Dato de Elevación:
    • Declara SIZE = [W, H, L] (X: 0..W-1, Y: 0..H-1, Z: 0..L-1).
    • Fija niveles de elevación exactos: Y_base (cimentación/zancos), Y_floor1 (planta baja), Y_floor2 (planta superior, si la hay), Y_roof_start e Y_roof_peak.
  2. Tabla de Coordenadas Ancla: Enumera coordenadas exactas y direcciones de orientación para:
    • Cáscara Exterior y Pilares de Marco: Coordenadas de las esquinas (X, Z) y límites de las paredes.
    • Límites del Suelo Interior (X_min..X_max, Z_min..Z_max): Verifica explícitamente que cada coordenada de cama, cofre, mesa y puesto de trabajo interior esté estrictamente dentro de los límites del suelo interior (X_wall_west + 1 .. X_wall_east - 1, Z_wall_north + 1 .. Z_wall_south - 1) y nunca se superponga con una coordenada de pared exterior o tabique.
    • Puertas / Entradas: (X, Y_floor, Z) + facing + hinge + casillas delanteras y traseras despejadas.
    • Escaleras: Rellano de entrada inferior interior (X0, Y1, Z0) → Primer escalón (X1, Y1, Z1) → (si gira: Rellano de giro (Xt, Y_turn, Zt)) → Último escalón (X2, Y2-1, Z2) → Rellano de salida superior interior (X3, Y2, Z3) + facing.
    • Balcones / Porches (si los hay): Límites del suelo transitable frente a coordenadas de la barandilla exterior (asegurando ≥ 1 fila de bloques transitables dentro de la valla).
    • Chimenea / Conductos de Servicio: Columna exterior (X, Z) fuera de la pendiente principal del techo con verificación de tapa de 4 lados.
    • Elementos Interiores / Funcionales Clave: Camas, sillas/sofás de escaleras (con dirección del respaldo y shape: 'straight' explícito), puestos de trabajo, almacenamiento, núcleos de agua/luz y muebles con coordenadas (X, Y, Z).

Reglas de Detalle Técnico (Aplicadas por Diseño y Orden de Capas — Sin Validaciones de Lanzamiento en Tiempo de Ejecución)

Aplica estas reglas técnicas de construcción directamente al escribir el script de construcción:

Reglas Universales (Todos los Niveles):

  • Regla de Orientación de Asientos de Escaleras y Bloqueo de Forma Explícito: En Minecraft, minecraft:*_stairs facing apunta hacia el lado del respaldo alto (escalón ascendente), NO hacia el lado del asiento bajo.
    • Siempre que uses escaleras como sillas, sofás o escalones transitables, pasa shape: 'straight' explícitamente (o outer_*/inner_* para sofás de esquina/escaleras diagonales) para que autoConnectStairs() nunca muten accidentalmente una silla o un escalón de escalera en un bloque de techo de esquina si se coloca adyacente a otra escalera en el mismo Y.
    • Solo omite shape (undefined) en escaleras de techo que deban unirse automáticamente en limatesas/valles.
    • Para mesas de centro bajas, usa losas bottom (type: 'bottom') para que queden al ras del suelo sin flotar.
  • Escaleras de Techo, Esquina y Un Solo Bloque con Conexión Automática (autoConnectStairs()): Siempre que construyas techos inclinados, a cuatro aguas o piramidales con *_stairs, autoConnectStairs() se ejecuta al final de la Fase 5 utilizando reglas de bloqueo de verificación de Minecraft vanilla:
    • Cualquier escalera colocada con un shape explícito (outer_left, outer_right, inner_left, inner_right o straight — por ejemplo, sillas de escalera, escalones transitables, escaleras de esquina de un solo bloque o escaleras diagonales) se conserva intacta a menos que shape se haya dejado omitido (undefined).
    • Cuando se omite shape, autoConnectStairs() verifica vecinos ortogonales en la misma half: forma outer_left/outer_right a partir de una escalera perpendicular delante (+facing) SOLO si el lado lateral opuesto no está bloqueado por una escalera paralela (facing === f), y forma inner_left/inner_right a partir de una escalera perpendicular detrás (-facing) SOLO si el lado lateral correspondiente no está bloqueado por una escalera paralela (facing === f).
  • Orientación de Cofres Dobles y Emparejamiento Automático (connectDoubleChests()): En Minecraft, el type de un cofre (single, left, right) se define desde la perspectiva del propio cofre (mirando en la dirección de su facing), NO desde la perspectiva del espectador:
    • Cuando se está delante de un cofre doble mirando hacia el pestillo: el bloque a la izquierda del espectador es type: 'right' (ubicado a la derecha del cofre: rightOf[facing]), y el bloque a la derecha del espectador es type: 'left' (ubicado a la izquierda del cofre: leftOf[facing]).
    • Siempre ejecuta connectDoubleChests() al final de la Fase 5 para que los bloques adyacentes de minecraft:chest o minecraft:trapped_chest que comparten el mismo facing se emparejen automáticamente en mitades type: 'right' + type: 'left' válidas sin texturas invertidas (a menos que type: 'single' se haya especificado explícitamente). Nunca coloques 3 cofres del mismo tipo en una sola fila.
  • Puertas Dobles con Emparejamiento Automático (autoPairDoubleDoors()): Cuando dos bloques *_door coincidentes se colocan uno al lado del otro compartiendo el mismo facing e Y, autoPairDoubleDoors() se ejecuta al final de la Fase 5 para asignar bisagras simétricas (hinge: 'left' en la puerta izquierda y hinge: 'right' en la puerta derecha desde la perspectiva frontal del espectador) en ambas mitades lower y upper para que las manijas se encuentren limpiamente en el centro.
  • Conexión Automática de Vallas, Muros, Puertas de Valla y Paneles (connectFencesAndPanes() y connectWalls()):
    • connectFencesAndPanes() calcula las propiedades booleanas north/south/east/west para *_fence, *_pane y iron_bars, excluyendo bloques no sólidos y no conectables (*_glass, *_leaves, hopper, bell, beacon, glowstone, losas, escaleras, puertas, etc.) mediante isFullSolidForConnection().
    • connectWalls() calcula los estados de enumeración north/south/east/west ('none', 'low' o 'tall' cuando un bloque sólido se sitúa directamente sobre la conexión) más el pilar central up ('true'/'false') para todos los bloques *_wall, y establece automáticamente in_wall: 'true' en cualquier *_fence_gate flanqueado por bloques *_wall para que la puerta se baje al ras del muro.
  • Asistente para Camas Emparejadas (placeBed(x, y, z, color, facing)): Siempre coloca camas

Individual skills in this repo

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

Skills relacionados