Init

content/reference/buildertools/builder-commands.en.md

@@ -0,0 +1,394 @@
+---
+title: Builder Commands
+type: docs
+weight: 2
+---
+
+Complete reference for all builder tool commands available in creative mode.
+
+**Package:** `com.hypixel.hytale.builtin.buildertools.commands`
+
+## Selection Commands
+
+### /pos1, /pos2
+
+Set selection corners at current position or specified coordinates.
+
+```
+/pos1 [<x> <y> <z>]
+/pos2 [<x> <y> <z>]
+```
+
+**Examples:**
+- `/pos1` - Set pos1 at current position
+- `/pos1 100 64 200` - Set pos1 at coordinates
+- `/pos2 ~10 ~ ~10` - Set pos2 relative to current position
+
+### /deselect
+
+Clear the current selection.
+
+```
+/deselect
+```
+
+### /expand
+
+Expand selection in a direction.
+
+```
+/expand <amount> [direction]
+```
+
+**Directions:** `up`, `down`, `north`, `south`, `east`, `west`, `all`
+
+**Examples:**
+- `/expand 10 up` - Expand 10 blocks upward
+- `/expand 5 all` - Expand 5 blocks in all directions
+
+### /contract
+
+Contract selection from a direction.
+
+```
+/contract <amount> [direction]
+```
+
+### /shift
+
+Move selection without affecting blocks.
+
+```
+/shift <amount> [direction]
+```
+
+### /selectchunk
+
+Select the entire chunk at current position.
+
+```
+/selectchunk
+```
+
+### /selectchunksection
+
+Select a 16x16x16 chunk section.
+
+```
+/selectchunksection
+```
+
+### /selectionhistory
+
+Navigate selection history.
+
+```
+/selectionhistory undo
+/selectionhistory redo
+```
+
+### /updateselection
+
+Refresh selection display.
+
+```
+/updateselection
+```
+
+## Clipboard Commands
+
+### /copy
+
+Copy selection to clipboard.
+
+```
+/copy
+```
+
+### /cut
+
+Cut selection to clipboard (removes blocks).
+
+```
+/cut
+```
+
+### /paste
+
+Paste clipboard at current position.
+
+```
+/paste [flags]
+```
+
+**Flags:**
+- `-a` - Ignore air blocks
+- `-e` - Include entities
+- `-o` - Paste at original location
+
+### /rotate
+
+Rotate clipboard contents.
+
+```
+/rotate <angle>
+```
+
+**Angles:** `90`, `180`, `270`
+
+### /flip
+
+Flip clipboard contents.
+
+```
+/flip <axis>
+```
+
+**Axes:** `x`, `y`, `z`
+
+## Modification Commands
+
+### /set
+
+Fill selection with a block pattern.
+
+```
+/set <pattern>
+```
+
+**Examples:**
+- `/set [Stone]` - Fill with stone
+- `/set [50%Stone, 50%Dirt]` - Fill with weighted random
+- `/set [Air]` - Clear selection
+
+### /fill
+
+Fill selection (alias for set).
+
+```
+/fill <pattern>
+```
+
+### /replace
+
+Replace blocks matching a mask.
+
+```
+/replace <from> <to>
+```
+
+**Examples:**
+- `/replace [Stone] [Dirt]` - Replace stone with dirt
+- `/replace [!Air] [Glass]` - Replace all non-air with glass
+
+### /walls
+
+Create walls around selection.
+
+```
+/walls <pattern>
+```
+
+### /hollow
+
+Hollow out the selection, leaving only walls.
+
+```
+/hollow [thickness]
+```
+
+### /stack
+
+Stack selection multiple times.
+
+```
+/stack <count> [direction]
+```
+
+**Examples:**
+- `/stack 5 up` - Stack 5 times upward
+- `/stack 10 north` - Stack 10 times north
+
+### /move
+
+Move blocks in selection.
+
+```
+/move <direction> <amount>
+```
+
+## History Commands
+
+### /undo
+
+Undo previous operations.
+
+```
+/undo [count]
+```
+
+### /redo
+
+Redo undone operations.
+
+```
+/redo [count]
+```
+
+### /clearedithistory
+
+Clear all edit history.
+
+```
+/clearedithistory
+```
+
+### /settoolhistorysize
+
+Set maximum history size.
+
+```
+/settoolhistorysize <size>
+```
+
+## Utility Commands
+
+### /tint
+
+Apply color tint to blocks.
+
+```
+/tint <color>
+```
+
+### /submerge
+
+Submerge selection in fluid.
+
+```
+/submerge <depth>
+```
+
+### /clearblocks
+
+Clear all blocks in selection.
+
+```
+/clearblocks
+```
+
+### /clearentities
+
+Clear all entities in selection.
+
+```
+/clearentities
+```
+
+### /environment
+
+Set environment for area.
+
+```
+/environment <environment_id>
+```
+
+### /globalmask
+
+Set a global mask for all operations.
+
+```
+/globalmask <mask>
+/globalmask clear
+```
+
+### /editline
+
+Create a line of blocks.
+
+```
+/editline <pattern>
+```
+
+### /extendface
+
+Extend a face of selection.
+
+```
+/extendface <direction> <amount>
+```
+
+### /hotbarswitch
+
+Switch builder tool hotbar.
+
+```
+/hotbarswitch <slot>
+```
+
+### /repairfillers
+
+Repair filler blocks.
+
+```
+/repairfillers
+```
+
+## Import Commands
+
+### /imageimport
+
+Import image as blocks.
+
+```
+/imageimport <file>
+```
+
+### /objimport
+
+Import OBJ model as blocks.
+
+```
+/objimport <file>
+```
+
+## Prefab Commands
+
+### /prefab
+
+Manage prefabs.
+
+```
+/prefab save <name>
+/prefab load <name>
+/prefab list
+/prefab delete <name>
+```
+
+### /prefabedit
+
+Enter prefab editing mode.
+
+```
+/prefabedit <prefab_id>
+```
+
+## Block Patterns
+
+Pattern syntax used by many commands:
+
+| Syntax | Description | Example |
+|--------|-------------|---------|
+| `[Block]` | Single block | `[Stone]` |
+| `[Block1, Block2]` | Equal weights | `[Stone, Dirt]` |
+| `[N%Block]` | Weighted | `[70%Stone, 30%Dirt]` |
+| `[!Block]` | Exclude | `[!Air]` |
+| `[!^Tag]` | Exclude tag | `[!^Fluid]` |
+
+## Permissions
+
+Builder commands require creative mode or appropriate permissions:
+
+```
+buildertools.command.<command_name>
+```