Construtor Minecraft

Idealize, projete e gere QUALQUER estrutura Minecraft estática baseada em blocos — de peças de mobiliário únicas a castelos complexos — usando uma Tabela de Âncoras de Coordenadas, Camadas Construtivas de 5 Passos e um gerador Node.js (.mjs) independente que exporta arquivos .nbt para Minecraft 26.3.

O que é Construtor Minecraft?

Este skill permite que você projete e gere qualquer estrutura estática baseada em blocos no Minecraft, desde pequenos móveis como cadeiras e mesas até construções complexas como castelos e catedrais. O processo começa com uma classificação do pedido em cinco níveis de complexidade (T1a a T3), seguido por um brainstorming colaborativo para definir parâmetros chave como bioma, escala e funcionalidades. Para construções de níveis T2 e T3, o skill consulta arquivos de referência com princípios arquitetônicos, estilos de bioma e modelos de cômodos. A saída final é um arquivo JavaScript (.mjs) autossuficiente e sem dependências que gera um arquivo .nbt compactado (gzip) para Minecraft 26.3 (DataVersion 5023), pronto para ser visualizado em ferramentas como o Shulkr Viewer ou carregado diretamente no jogo. O skill usa uma Tabela de Âncoras de Coordenadas para mapear cada bloco e aplica regras técnicas detalhadas para garantir a integridade estrutural, como orientação de escadas, conexão automática de baús duplos e portas duplas.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Construtor Minecraft faz?

Projete estruturas Minecraft funcionais e arquitetonicamente sólidas de qualquer escala baseada em blocos estáticos — desde pequenos móveis 1×2 até castelos extensos — através de um breve brainstorming colaborativo, revisão arquitetônica por níveis, Mapeamento de Âncoras de Coordenadas e Camadas Construtivas de 5 Passos. O resultado final é um arquivo ESM (.mjs) autossuficiente e sem dependências (exportado via ferramenta de geração de arquivos, em vez de despejar blocos de código brutos no chat) que gera um arquivo de estrutura .nbt vanilla compactado (gzip) para Minecraft 26.3 (DataVersion: 5023) sem falhas de validação em tempo de execução.

Quando Usar

  • O usuário pede para criar, projetar ou gerar qualquer estrutura estática baseada em blocos do Minecraft:
    • Móveis e Adereços (T1c): cadeiras, mesas de jantar, estantes, bancos, beliches, tronos, balcões, luminárias, suportes de armas.
    • Estruturas Decorativas e Cívicas (T1b): poços, postes de luz, estátuas, placas de sinalização, pontes, cercas, canteiros, fontes, monumentos, gazebos.
    • Abrigos Simples Habitáveis (T1a): tendas, abrigos de fogueira, galpões, cabanas de um cômodo, pequenas torres de vigia.
    • Construções Padrão (T2): casas de aldeões, lojas, pequenos templos, chalés de 2 andares, bibliotecas, padarias, faróis, estábulos.
    • Complexos (T3): castelos, catedrais, salões de aldeia, mansões, praças de mercado, assentamentos murados.
  • O usuário deseja um script Node.js autônomo que produza um arquivo .nbt vanilla pronto para execução local e visualização 3D no Shulkr Viewer.

Fora do Escopo

Este skill não lida com:

  • Lógica de Redstone (circuitos, portas de pistão, armadilhas) — use um skill de redstone dedicado.
  • Terraformação (montanhas, vales, rios, terreno personalizado) — use um skill de terreno dedicado.
  • Estado de entidades de bloco (conteúdo de baús, progresso de fornalhas, texto de placas) — o modelo escreve apenas paleta/blocos; edite no jogo após carregar.
  • Pose de entidades (suportes de armadura, molduras com itens específicos) — requer NBT de entidade muito além do modelo base.
  • Blocos de comando / animações — não são estruturas .nbt estáticas.

Se o usuário solicitar qualquer um dos itens acima, explique a limitação claramente e ofereça a alternativa estática baseada em blocos mais próxima.

Estrutura de Pastas

minecraft-builder/
├── SKILL.md
├── registry_26_3.json
└── references/
    ├── architecture-principles.md   (T2 e T3)
    ├── biome-styles.md              (T2 e T3, ou T1 correspondente ao bioma)
    ├── room-templates.md            (T2 e T3)
    └── furniture-patterns.md        (T1c)

Níveis de Complexidade de Construção

Classifique cada solicitação em um dos cinco níveis primeiro. O nível determina quais fases, regras técnicas e arquivos de referência se aplicam.

NívelExemplosFases AplicadasFoco
T1a — Abrigo Simples HabitávelTenda, abrigo de fogueira, galpão pequeno, cabana de um cômodo, torre de vigia pequena1, 2, 3 (condicional), 4, 5Entrada clara, blocos no chão, mobiliário funcional presente
T1b — Estrutura Não HabitávelPoço, poste de luz, estátua, placa de sinalização, ponte, cerca, canteiro, fonte, monumento1, 2, 3 (apenas suporte), 4, 5Dimensões, elemento funcional (água/luz/conexão), integridade do suporte
T1c — Móvel / Objeto de Múltiplos BlocosCadeira, mesa de jantar, estante, banco, cama, beliche, trono, balcão1, 2, 3 (ergonomia), 4, 5Ergonomia, orientação, acessibilidade, coerência de materiais
T2 — Construção PadrãoCasa de aldeão, loja, pequeno templo, chalé de 2 andares, biblioteca, padaria, farol1, 1.5, 2, 3, 4, 5, 6Lista de verificação arquitetônica e técnica completa (aconselhamento de bioma)
T3 — ComplexoComplexo de múltiplos edifícios, castelo, salão de aldeia, catedral, mansão, praça de mercado1, 1.5, 2, 3 (+rotas de circulação), 4, 5, 6Lista de verificação completa, coerência estrita de bioma, circulação explícita entre cômodos

Se o nível for ambíguo, pergunte ao usuário: "Isso é um móvel (cadeira/mesa), uma estrutura decorativa (poço/lampião/estátua), um abrigo simples (tenda/galpão), uma construção padrão (casa/loja) ou um complexo (castelo/salão)?"

Fluxo de Trabalho

Fase 1: Breve Brainstorming e Esclarecimento (Quando os Detalhes São Ambíguos)

Classifique o nível da construção primeiro. Se os principais parâmetros de design estiverem ausentes ou ambíguos, faça 2 a 4 perguntas concisas e concretas adaptadas ao nível:

Para T1a (Habitável Simples):

  1. Quantos ocupantes? (determina camas, assentos, armazenamento)
  2. Bioma / paleta (acampamento na floresta, planícies, taiga, etc.)
  3. Fechado ou ao ar livre? Características especiais (fogueira, baú, dossel)?

Para T1b (Estrutura Não Habitável):

  1. Qual é o elemento funcional? (fonte de água, fonte de luz, ponto de conexão, foco decorativo)
  2. Dimensões alvo (altura × largura × profundidade)?
  3. Bioma / paleta de materiais?
  4. Precisa de um topo/telhado/dossel ou base de suporte?

Para T1c (Móvel):

  1. Qual é a função do móvel? (assento, jantar, armazenamento, dormir, exibição)
  2. Quantos "assentos" ou unidades de capacidade? (1 cadeira, mesa de 4 lugares, estante de 6 prateleiras)
  3. Paleta de materiais? (carvalho, pinheiro, carvalho escuro, distorcido, etc.)
  4. Onde será colocado? (contra a parede, centro da sala, ao ar livre) — afeta as orientações padrão.

Para T2 / T3:

  1. Ocupantes e função (quem usa, propósito principal)
  2. Bioma / paleta de blocos
  3. Escala e características especiais (pegada, níveis, ao ar livre vs fechado, chaminé/varanda/dossel)
  4. Para T3: número de edifícios/alas conectados, se houver

Pule o brainstorming e vá diretamente para a próxima fase se o usuário já tiver especificado esses detalhes ou solicitar explicitamente a geração imediata.

Fase 1.5: Revisão Arquitetônica (Apenas T2 e T3)

Pule esta fase para T1a, T1b e T1c.

Para T2 e T3, consulte os arquivos de referência em references/ antes de travar as coordenadas:

  • architecture-principles.md — regras de proporção, profundidade de fachada, detalhes de silhueta, circulação, iluminação e coerência de materiais.
  • biome-styles.md — paleta e estilo de telhado para o bioma escolhido; se o usuário não escolheu um bioma, selecione um e declare a escolha explicitamente.
  • room-templates.md — tamanhos mínimos de cômodos e blocos funcionais necessários por cômodo/área.

Resolva cada item antes da Fase 3:

  • Cada cômodo/área atende às dimensões mínimas para sua função (de room-templates.md).
  • Pelo menos uma fonte de luz por área interna de 4×4 (de architecture-principles.md).
  • O estilo do telhado corresponde ao bioma escolhido e inclui um beiral de 1 bloco (de biome-styles.md e architecture-principles.md).
  • Paleta de materiais ≤ 3 primários + 1 de destaque, com gradação vertical (base de pedra/pesada, parede principal de madeira).
  • Profundidade e silhueta da fachada: pilares de moldura de canto (tronco) + ≥ 2 detalhes de silhueta/acabamento (chaminé externa, venezianas de alçapão, varanda/sacada, mansarda, trepadeiras).
  • Padrão de Navegação Sims: Zonas caminháveis claras de 1 bloco na frente/atrás de portas e portões de cerca, nos patamares internos inferior/superior de escadas e escadas de mão, ao lado de camas (mais 2 blocos de ar acima), na frente de baús/estações de trabalho/assentos, em cantos de corredor de 90° e ≥ 1 fileira de piso caminhável dentro de qualquer corrimão de varanda/sacada (profundidade total ≥ 2 blocos).
  • As proporções da construção não são 1:1:1 (varie largura, profundidade e altura).
  • Circulação: cada cômodo acessível por um caminho de ≥ 1 bloco de largura (≥ 2 blocos para caminhos principais) a partir da entrada.

Fase 2: Consulta ao Registro de Blocos (registry_26_3.json)

  • Inspecione registry_26_3.json no diretório do skill para verificar IDs de blocos exatos (minecraft:<nome>) e propriedades de estado de bloco válidas para Minecraft 26.3 (DataVersion: 5023), especialmente para blocos mais novos (variantes de cobre, carvalho pálido, resina, tijolos de tufo, etc.).
  • Nunca adivinhe nomes de propriedades de estado de bloco ou valores de enumeração permitidos.
  • Se um bloco ou propriedade solicitada estiver faltando no registro, informe a lacuna ao usuário e proponha a alternativa válida mais próxima, em vez de inventar IDs silenciosamente.

Fase 3: Tabela de Âncoras de Coordenadas e Regras Técnicas de Construção

NÃO desenhe grades de caracteres ASCII. Defina uma Tabela de Âncoras de Coordenadas exata (X, Y, Z) antes de escrever o código para que cada colocação de bloco mapeie 1:1 para chamadas setBlock() / fill():

  1. Caixa Delimitadora e Datum de Elevação:
    • Declare TAMANHO = [L, A, P] (X: 0..L-1, Y: 0..A-1, Z: 0..P-1).
    • Fixe níveis de elevação exatos: Y_base (fundação/pilares), Y_piso1 (térreo), Y_piso2 (andar superior, se houver), Y_telhado_inicio e Y_telhado_pico.
  2. Tabela de Coordenadas de Âncora: Liste coordenadas exatas e direções de face para:
    • Casca Externa e Pilares de Estrutura: Coordenadas (X, Z) dos postes de canto e limites da parede.
    • Limites do Piso Interno (X_min..X_max, Z_min..Z_max): Verifique explicitamente que cada coordenada de cama, baú, mesa e estação de trabalho interna esteja estritamente dentro dos limites do piso interno (X_parede_oeste + 1 .. X_parede_leste - 1, Z_parede_norte + 1 .. Z_parede_sul - 1) e nunca sobreponha uma coordenada de parede externa ou de divisória.
    • Portas / Entradas: (X, Y_piso, Z) + facing + hinge + blocos de passagem claros na frente/atrás.
    • Escadas: Patamar de entrada inferior interno (X0, Y1, Z0) → Primeiro degrau (X1, Y1, Z1) → (se houver curva: Patamar de curva (Xt, Y_curva, Zt)) → Último degrau (X2, Y2-1, Z2) → Patamar de saída superior interno (X3, Y2, Z3) + facing.
    • Varandas / Sacadas (se houver): Limites do piso caminhável vs coordenadas do corrimão externo (garantindo ≥ 1 fileira de blocos caminháveis dentro da cerca).
    • Chaminé / Poços de Serviço: Coluna externa (X, Z) fora da inclinação principal do telhado com verificação de tampa de 4 lados.
    • Elementos Internos / Funcionais Chave: Camas, cadeiras-sofás de escada (com direção de face do encosto e shape: 'straight' explícito), estações de trabalho, armazenamento, núcleos de água/luz e móveis com coordenadas (X, Y, Z).

Regras de Detalhes Técnicos (Aplicadas por Design e Ordem de Camadas — Sem Validadores de Exceção em Tempo de Execução)

Aplique estas regras técnicas de construção diretamente ao escrever o script de construção:

Regras Universais (Todos os Níveis):

  • Orientação e Regra de Travamento de Forma Explícita para Escadas no Minecraft: No Minecraft, minecraft:*_stairs facing aponta para o lado alto do encosto (degrau ascendente), NÃO para o lado baixo do assento.
    • Ao usar escadas como cadeiras, sofás ou degraus de escada caminháveis, sempre passe shape: 'straight' explicitamente (ou outer_*/inner_* para sofás de canto/escadas diagonais) para que autoConnectStairs() nunca acidentalmente transforme uma cadeira ou degrau de escada em um bloco de telhado de canto se colocado adjacente a outra escada no mesmo Y.
    • Apenas omita shape (undefined) em escadas de telhado que devem se unir automaticamente em quadris/vales.
    • Para mesas de centro baixas, use lajes bottom (type: 'bottom') para que fiquem rentes ao chão sem flutuar.
  • Escadas de Telhado, Canto e Degrau Único com Conexão Automática (autoConnectStairs()): Ao construir telhados inclinados, de quadril ou piramidais com *_stairs, autoConnectStairs() é executada no final da Passo 5 usando regras de verificação de travamento vanilla do Minecraft:
    • Qualquer escada colocada com um shape explícito (outer_left, outer_right, inner_left, inner_right ou straight — por exemplo, cadeiras de escada, degraus de escada caminháveis, escadas de canto de bloco único ou escadas diagonais) é preservada intocada a menos que shape tenha sido omitido (undefined).
    • Quando shape é omitido, autoConnectStairs() verifica vizinhos ortogonais na mesma half: forma outer_left/outer_right a partir de uma escada perpendicular na frente (+facing) SOMENTE se o lado lateral oposto não estiver travado por uma escada paralela (facing === f), e forma inner_left/inner_right a partir de uma escada perpendicular atrás (-facing) SOMENTE se o lado lateral correspondente não estiver travado por uma escada paralela (facing === f).
  • Orientação e Pareamento Automático de Baús Duplos (connectDoubleChests()): No Minecraft, o type de um baú (single, left, right) é definido a partir da própria perspectiva do baú (olhando na direção de seu facing), NÃO da perspectiva do visualizador:
    • Ao ficar na frente de um baú duplo olhando para sua trava: o bloco à esquerda do visualizador é type: 'right' (localizado à direita do baú: rightOf[facing]), e o bloco à direita do visualizador é type: 'left' (localizado à esquerda do baú: leftOf[facing]).
    • Sempre execute connectDoubleChests() no final do Passo 5 para que blocos minecraft:chest ou minecraft:trapped_chest adjacentes correspondentes compartilhando o mesmo facing automaticamente se pareiem em metades válidas type: 'right' + type: 'left' sem texturas invertidas (a menos que type: 'single' tenha sido especificado explicitamente). Nunca coloque 3 baús do mesmo tipo em uma única fileira.
  • Portas Duplas com Pareamento Automático (autoPairDoubleDoors()): Quando dois blocos *_door correspondentes são colocados lado a lado compartilhando o mesmo facing e Y, autoPairDoubleDoors() é executada no final do Passo 5 para atribuir dobradiças simétricas (hinge: 'left' na porta esquerda e hinge: 'right' na porta direita da perspectiva frontal do visualizador) em ambas as metades lower e upper para que as maçanetas se encontrem centralmente.
  • Cercas, Muros, Portões e Vidraças com Conexão Automática (connectFencesAndPanes() e connectWalls()):
    • connectFencesAndPanes() calcula propriedades booleanas north/south/east/west para *_fence, *_pane e iron_bars, excluindo blocos não sólidos e não conectáveis (*_glass, *_leaves, hopper, bell, beacon, glowstone, lajes, escadas, portas, etc.) via isFullSolidForConnection().
    • connectWalls() calcula estados de enumeração north/south/east/west ('none', 'low' ou 'tall' quando um bloco sólido está diretamente acima da conexão) mais o pilar central up ('true'/'false') para todos os blocos *_wall, e define automaticamente in_wall: 'true' em qualquer *_fence_gate ladeado por blocos *_wall para que o portão se abaixe rente ao muro.
  • Auxiliar de Colocação de Camas Emparelhadas (placeBed(x, y, z, color, facing)): Sempre coloque camas

…

(truncado para tradução)

Individual skills in this repo

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

Habilidades Relacionadas