Pro Tools: Difference between revisions

Latest revision as of 21:54, 3 September 2024

Pro Tools are a mechanic that allow players to quickly make massive changes to their house by manipulating a selected area. You can access these tools through their command aliases or through the upper left of the Housing Menu. The mechanic is inspired by WorldEdit, a well known tool used by many advanced builders.

Pro Tools can only be used if the right permissions are given by the house owner. To use them, the player must have permissions to build and use Pro Tools.

Usage

Pro Tools can be used through either their item or command. Tools that require a block will open a menu if none is specified through the command, and will always open a menu if the item tool is used. Once valid arguments are provided, the change will take effect immediately. Should one wish to undo their command, they can simply use the undo tool or the command /undo.

An advantage you may get by using commands with Pro Tools is that you can use the block variants used on Minecraft 1.8.9, like how planks:1 creates Spruce Planks. A list of these block IDs can be found on an external website such as this one. Another advantage to using commands is that you can specify multiple blocks seperated by a comma to randomly select between them.

List of tools

Tool	Description	Usable as
Region Selection	Selects a region with left and right clicks, which can then be modified with other tools. Can be obtained quickly using `//`.	Tool `/pos1` `/pos2`
Clear Selection	Clears your current selection, may cause slight issues with your clipboard.	`/clearselection` or `/desel`
Set	Lets you specify options to set your selected region with a block type.	Tool `/set <blocks>`
Fill	Lets you specify options to fill air blocks in your selected region with a block type.	Tool `/fill <blocks>`
Replace	Lets you specify options to fill air blocks in your selected region with a block type.	`/replace <targets> <replacements>`
Cut	Removes all content in the selected region and copies it to your clipboard.	Tool `/cut`
Copy	Copies all content in the selected region to your clipboard.	Tool `/copy`
Paste	Pastes content from your clipboard. Unlike WorldEdit, the paste location is always from the Bottom North East corner.	Tool `/paste`
Wireframe	Creates the outline of a cube in your selected region.	Tool `/wireframe <blocks>`
Walls	Creates vertical walls around a cube in your selected region.	Tool `/walls <blocks>`
Undo	Reverts the previous operation.	Tool `/undo`

Trivia

Clearing your selection will naturally make tools unusable as you have no selected region, this includes the Paste Tool despite it not actually needing a region to paste into.
The Pro Tools menu found in the Housing Menu refers to Pro Mode, a feature in Build Battle that Housing does not have. This is because Housing's Pro Tools are a fork of the ones used in Build Battle.

@@ Line 1: / Line 1: @@
-'''Pro Tools''' are a selection of block-manipulation tools that work by manipulating selection regions (not be be confused with [[regions]], which are a part of Housing's Systems). You can access these tools through their command aliases or through their menu, which is located in the upper left of the Housing Menu. The mechanic is inspired by WorldEdit, a well known tool used by many advanced builders.
+'''Pro Tools''' are a mechanic that allow players to quickly make massive changes to their house by manipulating a selected area. You can access these tools through their command aliases or through the upper left of the Housing Menu. The mechanic is inspired by WorldEdit, a well known tool used by many advanced builders.
-Pro Tools can only be accessed by [[groups]] with both the "Build" and "Pro Tools" permission, which are only enabled for the owner by default.
+Pro Tools can only be used if the right [[Permissions and Groups|permissions]] are given by the house owner. To use them, the player must have permissions to build and use Pro Tools.
 == Usage ==
-[[File:2024-09-02 18.01.09.png|thumb|alt=A rectangular cube made up of air, brick blocks, and magenta wool.|This cube was made with the command //set 0,45,35:2 (air, bricks, and magenta wool).]]
+[[File:2024-09-02 18.01.09.png|A cube created from randomised blocks using the set tool.|thumb]]
-Most tools have an associated item within the Pro Tools menu, but all Pro Tools can be accessed through commands. Tools which require a provided block will open a menu that allows an item from the player's inventory to be selected. If a valid block is provided, then the Pro Tool's functionality will modify the currently selected region.
+Pro Tools can be used through either their item or command. Tools that require a block will open a menu if none is specified through the command, and will always open a menu if the item tool is used. Once valid arguments are provided, the change will take effect immediately. Should one wish to undo their command, they can simply use the undo tool or the command <code>/undo</code>.
-When using the paste tool, the player's clipboard will be pasted with the paste position being the bottom-north-east corner.
+An advantage you may get by using commands with Pro Tools is that you can use the block variants used on Minecraft 1.8.9, like how <code>planks:1</code> creates Spruce Planks. A list of these block IDs can be found on an external website such as [https://www.digminecraft.com/lists/item_id_list_pc_1_8.php this one]. Another advantage to using commands is that you can specify multiple blocks seperated by a comma to randomly select between them.
-Tools which require a provided block will require a block name or block ID in their commands, and metadata can be appended to a block id with a separating colon. Using the command version of a tool also allows for multiple blocks to be selected in a spaceless, comma-separated array, which results in each block in the selection being randomly selected from the supplied block palette. All block ids and metadatas use 1.8.9 values, which can be found can be found on an external website such as [https://www.digminecraft.com/lists/item_id_list_pc_1_8.php this one]. Another advantage to using commands is that you can specify multiple blocks seperated by a comma to randomly select between them.
+== List of tools ==
-== Tools ==
 {| class="wikitable"
-! Name !! Ingame Description !! Command Alias
+! Tool !! Description !! Usable as
 |-
-| Region Selection Tool || Selects a region with left and right clicks, which can then be modified with other tools. || //wand, //
+| Region Selection
+|| Selects a region with left and right clicks, which can then be modified with other tools. Can be obtained quickly using <code>//</code>.
+|| <ul> <li>Tool</li> <li><code>/pos1</code> <code>/pos2</code></li> </ul>
 |-
-| Set Tool || Opens a menu with options to fill your selected region with a block type. || //set
+| Clear Selection
+|| Clears your current selection, may cause slight issues with your clipboard.
+|| <ul> <li><code>/clearselection</code> or <code>/desel</code></li> </ul>
 |-
-| Fill Tool || Opens a menu with options to fill your selected region with a block type. || //fill
+| Set
+|| Lets you specify options to set your selected region with a block type.
+|| <ul> <li>Tool</li> <li><code>/set <blocks></code> </ul>
 |-
-| Walls Tool || Opens a menu with options to Wall your selected region with a block type. || //walls
+| Fill
+|| Lets you specify options to fill air blocks in your selected region with a block type.
+|| <ul> <li>Tool</li> <li><code>/fill <blocks></code></li> </ul>
 |-
-| Wireframe Tool || Opens a menu with options to Wireframe your selected region with a block type. || //wireframe
+| Replace
+|| Lets you specify options to fill air blocks in your selected region with a block type.
+|| <ul> <li><code>/replace <targets> <replacements></code></li> </ul>
 |-
-| Cut Tool || Deletes the selected region and copies it to your clipboard. || //cut
+| Cut
+|| Removes all content in the selected region and copies it to your clipboard.
+|| <ul> <li>Tool</li> <li><code>/cut</code></li> </ul>
 |-
-| Copy Tool || Copies the selected region to your clipboard. || //copy
+| Copy
+|| Copies all content in the selected region to your clipboard.
+|| <ul> <li>Tool</li> <li><code>/copy</code></li> </ul>
 |-
-| Paste Tool || Pastes the contents of your clipboard to your plot at your location. || //paste
+| Paste
+|| Pastes content from your clipboard. Unlike WorldEdit, the paste location is always from the Bottom North East corner.
+|| <ul> <li>Tool</li> <li><code>/paste</code></li> </ul>
 |-
-| Undo Tool || Undoes your previous fill or paste operations. || //undo
+| Wireframe
-|}
+|| Creates the outline of a cube in your selected region.
+|| <ul> <li>Tool</li> <li><code>/wireframe <blocks></code></li> </ul>
-== Hidden Tools/Commands ==
-Some functionalities for "hidden" Pro Tools are only accessible through commands, and do not have an associated item nor do they show up in the Pro Tools menu.
-{| class="wikitable"
-! Name !! Custom Description !! Command Alias(es)
 |-
-| Replace Tool || Replaces a block or selection of blocks with a block or selection of blocks. || //replace
+| Walls
+|| Creates vertical walls around a cube in your selected region.
+|| <ul> <li>Tool</li> <li><code>/walls <blocks></code></li> </ul>
 |-
-| Point A || Manually sets the region point associated with the Region Selection Tool's left click to the player's position. || //posa, //pos1
+| Undo
+|| Reverts the previous operation.
+|| <ul> <li>Tool</li> <li><code>/undo</code></li> </ul>
 |-
-| Point B || Manually sets the region point associated with the Region Selection Tool's right click to the player's position. || //posb, //pos2
-|-
-| Deselect || Deselects the player's current selection region. || //desel, //clearselection
 |}
 == Trivia ==
-* Using the hidden deselect tool, most tools will become unusable. This includes the paste tool, despite the paste tool's functionality not requiring a selection region.
+* Clearing your selection will naturally make tools unusable as you have no selected region, this includes the Paste Tool despite it not actually needing a region to paste into.
-* The Pro Tools button in the [[Housing Menu]] has the following description: "Utilize more advanced building tools specific to Pro Mode such as copying and pasting regions." This is from Hypixel [https://hypixel.net/build-battle/ Build Battle] Pro Mode, which is where Pro Tools originate from. This description is not accurate, as there is no "Pro Mode" in Housing.
+* The Pro Tools menu found in the [[Housing Menu]] refers to ''Pro Mode'', a feature in Build Battle that Housing does not have. This is because Housing's Pro Tools are a fork of the ones used in Build Battle.