Pro Tools: Difference between revisions

Revision as of 16:45, 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]]). This can also refer to the menu where these tools are accessed, which is in the top left of the [[Housing Menu]].
+'''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 the "Pro Tools" [[permission]], which is only enabled for the Owner by default. This permission only affects players if they also have permission to build.
+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 ==
-All tools work by right clicking while holding the associated item in the player's hand. 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.
+[[File:2024-09-02 18.01.09.png|A cube created from randomised blocks using the set tool.|thumb]]
+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>.
-All tools can also be accessed via commands. Tools which require a provided block will require a block name or block id in their command argument(s). Block metadata can be included after the block name or id, with a colon separating the two values. 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 here].
+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.
-[[File:2024-09-02 18.01.09.png|left|frame|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).]]
-== 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
-|-
-| Teleport to Point A || Teleports the player to region point A. || //tpposa, //tppos1
-|-
-| Teleport to Point B || Teleports the player to region point B. || //tpposb, //tppos2
-|-
-| Pro Tools || Replaces the player's hotbar with, in order: Region Selection Tool, Set Tool, Fill Tool, Cut Tool, Copy Tool, Paste Tool, and Undo Tool. || //protools, //pt
-|-
-| 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. Additionally, the deselect functionality does not work on the "Teleport to Point" commands, and these commands will remain functional after deselecting the current 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 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.