XLII ARCHITECT — ALPHA 0.5.3 PUBLIC ALPHA
GUIA DE INÍCIO RÁPIDO — PORTUGUÊS (PT-PT)
Oficina XLII / Oficinaxlii

============================================================
1. O QUE É
============================================================
XLII Architect é uma ferramenta criativa de construção para Minecraft Java Edition 26.2.
Nesta Alpha pública, a Architect Wand permite criar paredes, apagar áreas e preencher volumes 3D entre dois pontos.

IMPORTANTE: Faz uma cópia de segurança do mundo antes de usar.
Nesta Alpha ainda não existe Undo/Redo.

============================================================
2. INSTALAÇÃO — SINGLE PLAYER
============================================================
1) Fecha o mundo antes de copiar o datapack.
2) Abre a pasta:
   %appdata%\.minecraft\saves\NOME_DO_MUNDO\datapacks\
3) Coloca o ficheiro ZIP do XLII Architect diretamente dentro de "datapacks".
   NÃO é necessário extrair o ZIP.
4) Entra no mundo.
5) Escreve no chat:
   /reload
6) Para receber a Architect Wand, escreve:
   /function xlii_architect:give_wand
7) Se quiseres confirmar que está ativo:
   /datapack list enabled

A Wand foi criada para Creative Mode.

============================================================
3. COMANDO PRINCIPAL — RECEBER A WAND
============================================================
/function xlii_architect:give_wand

Ao receber a Wand, ela inicia em:
MODE: WALL
HEIGHT: 5

============================================================
4. CONTROLOS DA ARCHITECT WAND
============================================================
CLIQUE DIREITO:
- 1.º clique: marca o Ponto A
- 2.º clique: marca o Ponto B
- 3.º clique: executa a operação

SHIFT + CLIQUE DIREITO NUM BLOCO:
- Guarda esse bloco como material de construção.
- Deve aparecer "Material guardado ✓".

SHIFT + CLIQUE DIREITO NO AR / CÉU:
- Troca o modo da Wand.
- Sequência: WALL -> ERASE -> FILL -> WALL...

ALTERAR ALTURA DO WALL / ERASE:
/trigger xlii_height set X

Exemplos:
/trigger xlii_height set 1
/trigger xlii_height set 5
/trigger xlii_height set 10
/trigger xlii_height set 50

Intervalo: 1 a 384.

============================================================
5. WALL — CRIAR UMA PAREDE
============================================================
1) Shift + clique direito num bloco para escolher o material.
2) Confirma que o modo é WALL.
3) Define a altura:
   /trigger xlii_height set X
4) Clique direito no primeiro ponto = Ponto A.
5) Clique direito no segundo ponto = Ponto B.
6) Clique direito novamente = Executar.

Resultado:
Cria uma parede de A até B com a altura escolhida.
Funciona em linha reta e diagonal.

============================================================
6. ERASE — APAGAR UMA ÁREA
============================================================
1) Shift + clique direito no ar/céu até aparecer MODE: ERASE.
2) Define a altura:
   /trigger xlii_height set X
3) Marca o Ponto A.
4) Marca o Ponto B.
5) Clique direito novamente para executar.

Resultado:
Apaga a faixa A -> B verticalmente com a HEIGHT definida.

ATENÇÃO: ERASE remove blocos. Não existe Undo nesta Alpha.

============================================================
7. FILL — PREENCHER UM VOLUME 3D
============================================================
1) Shift + clique direito num bloco para escolher o material.
2) Shift + clique direito no ar/céu até aparecer MODE: FILL.
3) Escolhe dois cantos opostos do volume que queres preencher.
4) Clique direito para marcar o Ponto A.
5) Clique direito para marcar o Ponto B.
6) Clique direito novamente para executar.

Resultado:
Todo o volume 3D entre A e B é preenchido com o material escolhido.

Exemplo de confirmação:
FILL concluído ✓ | 9x1x8 = 72 blocos

NOTA DE SELEÇÃO DO FILL:
A Wand seleciona a célula de ar imediatamente antes da superfície sólida para onde estás a apontar.
Para selecionar um canto interior, aponta para a superfície que fica imediatamente atrás desse canto.

LIMITES DO FILL:
- Máximo de 32 768 blocos por operação.
- Máximo de 512 blocos por dimensão.
- O FILL substitui todos os blocos dentro do volume selecionado.

============================================================
8. RESUMO RÁPIDO
============================================================
Receber Wand:
/function xlii_architect:give_wand

Altura:
/trigger xlii_height set X

Clique direito:
A -> B -> Executar

Shift + clique num bloco:
Material Picker

Shift + clique no ar:
WALL -> ERASE -> FILL

============================================================
9. MULTIPLAYER / SERVIDORES
============================================================
Nesta Alpha pública, para evitar conflitos, recomendamos apenas um utilizador ativo da Architect Wand de cada vez.

============================================================
10. APOIO E FEEDBACK
============================================================
Encontraste um erro, comportamento estranho ou tens uma sugestão?

Email de apoio oficial:
apoio@oficinaxlii.pt

Assunto recomendado:
[XLII Architect Alpha 0.5.3] Bug / Feedback

Inclui sempre:
- Versão do XLII Architect
- Versão do Minecraft
- Single Player ou servidor
- Modo usado: WALL / ERASE / FILL
- HEIGHT, quando aplicável
- Material escolhido
- Passos exatos que fizeste
- Resultado esperado
- Resultado obtido
- Screenshot ou vídeo, se possível

Website:
oficinaxlii.pt

============================================================
XLII ARCHITECT
Desenvolvido e publicado por Oficina XLII / Oficinaxlii
© 2026 Oficina XLII. Todos os direitos reservados.
============================================================
