ToolBelt
ToolBelt
About
This plugin provides a way to replace specific tools with special functionality. The idea originated from the VoxelDoop2 plugin, but has been re-written entirely for better code quality and to include permissions and yml configuration. The framework has been rewritten a second time now so that additional tools can be added more easily.
Setup
The process for setting up this mod is to drop it in your CraftBukkit plugins/ folder. Run (or /reload) bukkit, and it will create a ToolBelt/ folder with the config.yml file inside. Modify the file as wished (it is documented inside the file) and then run /tb reload to tell ToolBelt to reconfigure itself from modified config file.
Tools
- Block Duplicator (defaults to Stone Axe) Right click with this tool in your hand to get a stack of 64 of the selected block.
- Data Scrolling (defaults to Bone) Right or Left click with this tool to change the data value for the selected block. This lets you change a half-step from wood to stone to brick and so on.
- Paint Brush (defaults to Slime Ball) Left click to load a block type and data into the paintbrush, and Right click to paint the loaded data onto the selected block
- Leap (defaults to Feather) Right click to make large leaps through the air. This is similar to VoxelAir, only instead of hovering, left click can enter creative mode flight.
- Pickhax (defaults to Diamond Pickaxe) Left click to insta-delete a block. Right click to insta-delete without applying minecraft physics. Crouch to remove blocks at range (if have phax.range)
- Ruler (defaults to Paper) Left click in one spot, Right click in another, and get the width in x,y,z, total distance between points, and the enclosed volume.
- Watch (defaults to Watch) Left click to set personal time to day, right click for night. Crouch and click to re-sync with server time. If synced with server and have watch.server permission, left/right crouch click to set server time to day/night.
- Sledge (defaults to Gold Pickaxe) Left click to push a block forward into air, right click to pull it towards you. Crouch to push/pull into non-air blocks.
- Pliers (defaults to Glowstone Dust) Same as Sledge, except you copy the block instead of move it.
- Shovel (defaults to Gold Spade) Left click to remove (by default) a 3x3x3 cube of earth. Right click to remove a disk (by default) of radius 2.5, and crouch right click to remove a sphere (by default) of radius 2.5. By default, the shovel removes stone, dirt, grass, sand and gravel.
- Chainsaw (defaults to Gold Axe) Left click to remove (by default) a 3x3x3 cube of trees. Right click to remove a sphere (by default) of radius 2.5. By default, the chainsaw removes logs, leaves and vines.
- Tree (defaults to Gold Hoe) Right click to place a full tree where you click, Left click to change the type of tree to place. This uses the built-in tree generation code, and so will only place in locations where there is room for the full tree, and the appropriate ground below. The tool is disabled by default in config.yml .
Permissions
This help is now available in help/Permissions.txt. That file will be updated with every new release and will always list what is available.
- toolbelt.reload Give permission to reload the settings from the configuration file on the fly
- toolbelt.tool.* Give permission for all tool related settings
- toolbelt.tool.dupe Give permission to use the duplication tool
- toolbelt.tool.scroll Give permission to use the data scrolling tool
- toolbelt.tool.paint Give permission to use the paint tool.
- toolbelt.tool.paint.range Give permission to use the paint tool at a distance.
- toolbelt.tool.leap Give permission to make huge leaps with the leap tool.
- toolbelt.tool.leap.fly Give permission to enter creative mode flying by left clicking.
- toolbelt.tool.leap.tel Give permission to teleport by crouching while leaping.
- toolbelt.tool.phax Give permission to use the PickHax tool.
- toolbelt.tool.phax.range Give permission to use the PickHax tool at a distance.
- toolbelt.tool.ruler Give permission to measure distances easily with the ruler.
- toolbelt.tool.watch Give permission to set the time to day or night for themselves with the watch tool.
- toolbelt.tool.watch.server Give permission to set the server time.
- toolbelt.tool.sledge Give permission to push or pull blocks.
- toolbelt.tool.pliers Give permission to copy and push or pull blocks.
- toolbelt.tool.shovel Give permission to clear large amounts of (by default) stone, dirt, grass, sand and gravel.
- toolbelt.tool.saw Give permission to clear large amounts of (by default) logs, leaves and vines.
- toolbelt.tool.tree Give permission to rapidly place fully grown trees.
The warning/help messages can be configured per-user by the following permissions. Please only give any user one of these permissions at a time.
- toolbelt.print.debug Print all messages including ones that give debugging information.
- toolbelt.print.hint Print all quieter messages + hints for using tools.
- toolbelt.print.info Print all quieter messages + informational notices for tools.
- toolbelt.print.warning Print all quieter messages + warnings on wrong tool use.
- toolbelt.print.important Print important messages, such as loaded paint material and such.
There is an always up-to-date list of permissions in help/Permissions.txt inside the ToolBelt folder.
Commands
This help is now available in help/Commands.txt. That file will be updated with every new release and will always list what is available.
- /toolbelt or /tb
- /tb reload Reload the settings from the configuration file. (if you have the permission above)
- /tb tools See a list of all the tools you can use. (takes into account what tools are enabled and what you have permission to use)
- /tb off Allows a player to use the ToolBelt tools as they normally are, with ToolBelt not active. This is just for the person who ran the command.
- /tb on Allows a player to re-enable the use of ToolBelt tools.
Configuration
- config.yml The configuration file is heavily documented in the top comment. Please let me know if I'm not clear enough on any option and if I'm missing any configuration options that you wish for.
- help/<tool>.txt These files will give further information on the configuration settings for a given tool.
Additional links
The code for the plugin is available at github.
@VoidRipper717
Minecraft 1.3.2 has no new blocks, and as such the plugin doesn't need to be updated to support it. As things stand, the new ToolBelt 0.5 version supports 1.3.1 and 1.3.2. Please report any issues you find on github by clicking the "Ticket" link above.
1.3.2?
@Hangar
I would strongly suggest posting new ideas on github, as that's my todo list / discussion board for the plugin. Ideas brought up other places won't always get remembered when I'm looking for a new feature to implement :-) . https://github.com/Peter200lx/ToolBelt/issues
I working on updating the plugin with the new materials / data scroll values from Minecraft 1.3, including the log rotation data values. So far I've just considered the functional break down between scrolling data values, and possibly scrolling between related material types. However, I can see an argument made for a usage break down. Please open an issue on github so we can discuss further.
New tool idea: The Rotater
Basically it's like the scroller, but lets you rotate logs/stairs etc. through all of their various positions without changing the material. Placing logs can be a bit annoying now, and I'm wondering if this could help people in survival worlds.
Just a thought :)
@Hangar
I've not yet tested that, but I do wish make sure it is compatible before 1.3 Release is out. Feel free to pester me if it is not done on time :-).
EDIT: Just tested all the tools with Bukkit 1.3.1-R0.1 and everything seemed to work. I've not done a thorough test of every possible logical path in the code, but all of the tools seemed to work as specified. Please let me know if any problems are found.
Anyone tested this on the 1.3.1. dev builds? Just trying to get my ducks in a line here :)
@damnnicholas
Thanks for the video! I made a comment with a couple of notes on youtube, feel free to PM me if you have any questions about the use of any of the tools.
Hey, i made a video showcase on this plugin :) Hope you'll like it!
Link to video: http://www.youtube.com/watch?v=sx0pXjX2s5s&feature=youtu.be
Great plugin, a must have for every creative player and works flawless on my server - in opposite to VoxelDoop.
Thank you very much!
@Peter200lx
I've submitted a ticket. Thank you for looking into this.
@BraveThunder
This is definitely an issue I'll look into. If you could open an issue on github (click the ticket link above) it will help me track and give you information as I investigate it. If you don't mind taking the time I would appreciate a list of tools which do and don't obey the region restrictions in the issue, as it would help me track down the source of the problem.
Not sure if this is the correct place to address this, but I am having an issue with getting the Pickhax, Shovel and Chainsaw to obey the WorldGuard region protections. I have set the useEvent as true in the config.yml for ToolBelt and have set the WorldGuard region up so only players who are 'owners' of the region can break or place blocks. What is causing the greatest confusion for me is that the use of the Paint Brush and Data Scrolling tools are both prevented in the region however the Pickhax, Shovel and Chainsaw are not. In addition the region does successfully prevent 'normal' block breaking and placing. I am not using permissions for ToolBelt, or any other plugins, I don't know if this would have any impact. If you could shine any light on this issue, that would be great. I believe it is more likely to be a problem at the WorldGuard side of things, perhaps you could recommend which region flags to set to prevent the tools being used in that area? Can I just say thank you for a great plugin, and thanks for any time you may spend looking into this. :)
Great thing. I love it. Meybe its good for newbies to watch an short video about this plugin. Just to get a better first look.
This is an amazing plugin for admins or those who use creative mode a lot! :)