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
.nbtvanilla 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
.nbtestá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ível | Exemplos | Fases Aplicadas | Foco |
|---|---|---|---|
| T1a — Abrigo Simples Habitável | Tenda, abrigo de fogueira, galpão pequeno, cabana de um cômodo, torre de vigia pequena | 1, 2, 3 (condicional), 4, 5 | Entrada clara, blocos no chão, mobiliário funcional presente |
| T1b — Estrutura Não Habitável | Poço, poste de luz, estátua, placa de sinalização, ponte, cerca, canteiro, fonte, monumento | 1, 2, 3 (apenas suporte), 4, 5 | Dimensões, elemento funcional (água/luz/conexão), integridade do suporte |
| T1c — Móvel / Objeto de Múltiplos Blocos | Cadeira, mesa de jantar, estante, banco, cama, beliche, trono, balcão | 1, 2, 3 (ergonomia), 4, 5 | Ergonomia, orientação, acessibilidade, coerência de materiais |
| T2 — Construção Padrão | Casa de aldeão, loja, pequeno templo, chalé de 2 andares, biblioteca, padaria, farol | 1, 1.5, 2, 3, 4, 5, 6 | Lista de verificação arquitetônica e técnica completa (aconselhamento de bioma) |
| T3 — Complexo | Complexo de múltiplos edifícios, castelo, salão de aldeia, catedral, mansão, praça de mercado | 1, 1.5, 2, 3 (+rotas de circulação), 4, 5, 6 | Lista 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):
- Quantos ocupantes? (determina camas, assentos, armazenamento)
- Bioma / paleta (acampamento na floresta, planícies, taiga, etc.)
- Fechado ou ao ar livre? Características especiais (fogueira, baú, dossel)?
Para T1b (Estrutura Não Habitável):
- Qual é o elemento funcional? (fonte de água, fonte de luz, ponto de conexão, foco decorativo)
- Dimensões alvo (altura × largura × profundidade)?
- Bioma / paleta de materiais?
- Precisa de um topo/telhado/dossel ou base de suporte?
Para T1c (Móvel):
- Qual é a função do móvel? (assento, jantar, armazenamento, dormir, exibição)
- Quantos "assentos" ou unidades de capacidade? (1 cadeira, mesa de 4 lugares, estante de 6 prateleiras)
- Paleta de materiais? (carvalho, pinheiro, carvalho escuro, distorcido, etc.)
- Onde será colocado? (contra a parede, centro da sala, ao ar livre) — afeta as orientações padrão.
Para T2 / T3:
- Ocupantes e função (quem usa, propósito principal)
- Bioma / paleta de blocos
- Escala e características especiais (pegada, níveis, ao ar livre vs fechado, chaminé/varanda/dossel)
- 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.mdearchitecture-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.jsonno 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():
- 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_inicioeY_telhado_pico.
- Declare
- 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).
- Casca Externa e Pilares de Estrutura: Coordenadas
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:*_stairsfacingaponta 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 (ououter_*/inner_*para sofás de canto/escadas diagonais) para queautoConnectStairs()nunca acidentalmente transforme uma cadeira ou degrau de escada em um bloco de telhado de canto se colocado adjacente a outra escada no mesmoY. - 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.
- Ao usar escadas como cadeiras, sofás ou degraus de escada caminháveis, sempre passe
- 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
shapeexplícito (outer_left,outer_right,inner_left,inner_rightoustraight— por exemplo, cadeiras de escada, degraus de escada caminháveis, escadas de canto de bloco único ou escadas diagonais) é preservada intocada a menos queshapetenha sido omitido (undefined). - Quando
shapeé omitido,autoConnectStairs()verifica vizinhos ortogonais na mesmahalf: formaouter_left/outer_righta 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 formainner_left/inner_righta partir de uma escada perpendicular atrás (-facing) SOMENTE se o lado lateral correspondente não estiver travado por uma escada paralela (facing === f).
- Qualquer escada colocada com um
- Orientação e Pareamento Automático de Baús Duplos (
connectDoubleChests()): No Minecraft, otypede um baú (single,left,right) é definido a partir da própria perspectiva do baú (olhando na direção de seufacing), 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 blocosminecraft:chestouminecraft:trapped_chestadjacentes correspondentes compartilhando o mesmofacingautomaticamente se pareiem em metades válidastype: 'right'+type: 'left'sem texturas invertidas (a menos quetype: 'single'tenha sido especificado explicitamente). Nunca coloque 3 baús do mesmo tipo em uma única fileira.
- Ao ficar na frente de um baú duplo olhando para sua trava: o bloco à esquerda do visualizador é
- Portas Duplas com Pareamento Automático (
autoPairDoubleDoors()): Quando dois blocos*_doorcorrespondentes são colocados lado a lado compartilhando o mesmofacingeY,autoPairDoubleDoors()é executada no final do Passo 5 para atribuir dobradiças simétricas (hinge: 'left'na porta esquerda ehinge: 'right'na porta direita da perspectiva frontal do visualizador) em ambas as metadeslowereupperpara que as maçanetas se encontrem centralmente. - Cercas, Muros, Portões e Vidraças com Conexão Automática (
connectFencesAndPanes()econnectWalls()):connectFencesAndPanes()calcula propriedades booleanasnorth/south/east/westpara*_fence,*_paneeiron_bars, excluindo blocos não sólidos e não conectáveis (*_glass,*_leaves,hopper,bell,beacon,glowstone, lajes, escadas, portas, etc.) viaisFullSolidForConnection().connectWalls()calcula estados de enumeraçãonorth/south/east/west('none','low'ou'tall'quando um bloco sólido está diretamente acima da conexão) mais o pilar centralup('true'/'false') para todos os blocos*_wall, e define automaticamentein_wall: 'true'em qualquer*_fence_gateladeado por blocos*_wallpara 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)