Pro Tools: Difference between revisions

Revision as of 17:02, 3 September 2024

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 can only be accessed by groups with both the "Build" and "Pro Tools" permission, which are only enabled for the owner by default.

Usage

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.

When using the paste tool, the player's clipboard will be pasted with the paste position being the bottom-north-east corner.

Using the command version of a tool also allows for multiple blocks to be selected in a comma-separated array with no spaces, 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 this one. Another advantage to using commands is that you can specify multiple blocks seperated by a comma to randomly select between them.

Tools

Name	Ingame Description	Command Alias
Region Selection Tool	Selects a region with left and right clicks, which can then be modified with other tools.	//wand, //
Set Tool	Opens a menu with options to fill your selected region with a block type.	//set
Fill Tool	Opens a menu with options to fill your selected region with a block type.	//fill
Walls Tool	Opens a menu with options to Wall your selected region with a block type.	//walls
Wireframe Tool	Opens a menu with options to Wireframe your selected region with a block type.	//wireframe
Cut Tool	Deletes the selected region and copies it to your clipboard.	//cut
Copy Tool	Copies the selected region to your clipboard.	//copy
Paste Tool	Pastes the contents of your clipboard to your plot at your location.	//paste
Undo Tool	Undoes your previous fill or paste operations.	//undo

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.

Name	Custom Description	Command Alias(es)
Replace Tool	Replaces a block or selection of blocks with a block or selection of blocks.	//replace
Point A	Manually sets the region point associated with the Region Selection Tool's left click to the player's position.	//posa, //pos1
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.
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 Build Battle Pro Mode, which is where Pro Tools originate from. This description is not accurate, as there is no "Pro Mode" in Housing.

@@ Line 1: / Line 1: @@
-'''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''' 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 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.
+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.
 == Usage ==
-[[File:2024-09-02 18.01.09.png|A cube created from randomised blocks using the set tool.|thumb]]
+[[File:2024-09-02 18.01.09.png|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).]]
-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>.
+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.
-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.
+When using the paste tool, the player's clipboard will be pasted with the paste position being the bottom-north-east corner.
-== List of tools ==
+Using the command version of a tool also allows for multiple blocks to be selected in a comma-separated array with no spaces, 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  [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 ==
 {| class="wikitable"
-! Tool !! Description !! Usable as
+! Name !! Ingame Description !! Command Alias
 |-
-| Region Selection
+| Region Selection Tool || Selects a region with left and right clicks, which can then be modified with other tools. || //wand, //
-|| 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>
 |-
-| Clear Selection
+| Set Tool || Opens a menu with options to fill your selected region with a block type. || //set
-|| Clears your current selection, may cause slight issues with your clipboard.
-|| <ul> <li><code>/clearselection</code> or <code>/desel</code></li> </ul>
 |-
-| Set
+| Fill Tool || Opens a menu with options to fill your selected region with a block type. || //fill
-|| Lets you specify options to set your selected region with a block type.
-|| <ul> <li>Tool</li> <li><code>/set <blocks></code> </ul>
 |-
-| Fill
+| Walls Tool || Opens a menu with options to Wall your selected region with a block type. || //walls
-|| 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>
 |-
-| Replace
+| Wireframe Tool || Opens a menu with options to Wireframe your selected region with a block type. || //wireframe
-|| 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
+| Cut Tool || Deletes the selected region and copies it to your clipboard. || //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
+| Copy Tool || Copies the selected region to your clipboard. || //copy
-|| Copies all content in the selected region to your clipboard.
-|| <ul> <li>Tool</li> <li><code>/copy</code></li> </ul>
 |-
-| Paste
+| Paste Tool || Pastes the contents of your clipboard to your plot at your location. || //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>
 |-
-| Wireframe
+| Undo Tool || Undoes your previous fill or paste operations. || //undo
-|| 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)
 |-
-| Walls
+| Replace Tool || Replaces a block or selection of blocks with a block or selection of blocks. || //replace
-|| Creates vertical walls around a cube in your selected region.
-|| <ul> <li>Tool</li> <li><code>/walls <blocks></code></li> </ul>
 |-
-| Undo
+| Point A || Manually sets the region point associated with the Region Selection Tool's left click to the player's position. || //posa, //pos1
-|| 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 ==
-* 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.
+* 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.
-* 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.
+* 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.