XLII ARCHITECT — ALPHA 0.5.3 PUBLIC ALPHA
QUICK START GUIDE — ENGLISH
Oficina XLII / Oficinaxlii

============================================================
1. WHAT IT IS
============================================================
XLII Architect is a creative building tool for Minecraft Java Edition 26.2.
In this Public Alpha, the Architect Wand can build walls, erase areas and fill complete 3D volumes between two points.

IMPORTANT: Back up your world before using it.
Undo/Redo is not available in this Alpha yet.

============================================================
2. INSTALLATION — SINGLE PLAYER
============================================================
1) Close the world before copying the datapack.
2) Open:
   %appdata%\.minecraft\saves\YOUR_WORLD\datapacks\
3) Place the XLII Architect ZIP directly inside the "datapacks" folder.
   You do NOT need to extract the ZIP.
4) Enter the world.
5) Run in chat:
   /reload
6) To receive the Architect Wand, run:
   /function xlii_architect:give_wand
7) Optional check:
   /datapack list enabled

The Wand is designed for Creative Mode.

============================================================
3. MAIN COMMAND — GET THE WAND
============================================================
/function xlii_architect:give_wand

The Wand starts with:
MODE: WALL
HEIGHT: 5

============================================================
4. ARCHITECT WAND CONTROLS
============================================================
RIGHT CLICK:
- 1st click: set Point A
- 2nd click: set Point B
- 3rd click: execute the operation

SHIFT + RIGHT CLICK A BLOCK:
- Saves that block as the building material.
- You should see "Material guardado ✓".

SHIFT + RIGHT CLICK CLEAR AIR / SKY:
- Changes the Wand mode.
- Sequence: WALL -> ERASE -> FILL -> WALL...

CHANGE WALL / ERASE HEIGHT:
/trigger xlii_height set X

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

Range: 1 to 384.

============================================================
5. WALL — BUILD A WALL
============================================================
1) Shift + right click a block to choose the material.
2) Make sure the mode is WALL.
3) Set the height:
   /trigger xlii_height set X
4) Right click the first location = Point A.
5) Right click the second location = Point B.
6) Right click again = Execute.

Result:
Builds a wall from A to B using the selected HEIGHT.
Straight and diagonal walls are supported.

============================================================
6. ERASE — REMOVE AN AREA
============================================================
1) Shift + right click clear air/sky until MODE: ERASE appears.
2) Set the height:
   /trigger xlii_height set X
3) Mark Point A.
4) Mark Point B.
5) Right click again to execute.

Result:
Removes the A -> B strip vertically using the selected HEIGHT.

WARNING: ERASE removes blocks. There is no Undo in this Alpha.

============================================================
7. FILL — FILL A 3D VOLUME
============================================================
1) Shift + right click a block to choose the material.
2) Shift + right click clear air/sky until MODE: FILL appears.
3) Choose two opposite corners of the volume.
4) Right click to mark Point A.
5) Right click to mark Point B.
6) Right click again to execute.

Result:
The complete 3D volume between A and B is filled with the selected material.

Example confirmation:
FILL concluído ✓ | 9x1x8 = 72 blocos

FILL SELECTION NOTE:
The Wand selects the air cell immediately before the solid surface you are aiming at.
To select an inner corner, aim at the surface immediately behind that corner.

FILL LIMITS:
- Maximum 32,768 blocks per operation.
- Maximum 512 blocks per dimension.
- FILL replaces every block inside the selected volume.

============================================================
8. QUICK REFERENCE
============================================================
Get Wand:
/function xlii_architect:give_wand

Height:
/trigger xlii_height set X

Right click:
A -> B -> Execute

Shift + right click a block:
Material Picker

Shift + right click clear air:
WALL -> ERASE -> FILL

============================================================
9. MULTIPLAYER / SERVERS
============================================================
During this Public Alpha, we recommend only one active Architect Wand user at a time to avoid selection conflicts.

============================================================
10. SUPPORT AND FEEDBACK
============================================================
Found a bug, unexpected behavior or have a suggestion?

Official support email:
apoio@oficinaxlii.pt

Recommended subject:
[XLII Architect Alpha 0.5.3] Bug / Feedback

Please include:
- XLII Architect version
- Minecraft version
- Single Player or server
- Mode used: WALL / ERASE / FILL
- HEIGHT, when applicable
- Selected material
- Exact steps performed
- Expected result
- Actual result
- Screenshot or video, if possible

Website:
oficinaxlii.pt

============================================================
XLII ARCHITECT
Developed and published by Oficina XLII / Oficinaxlii
© 2026 Oficina XLII. All rights reserved.
============================================================
