Powertool

Introduction

The Powertool feature lets you bind a command to a specific item in hand. When a player uses that item (left or right-click), the bound command is executed automatically. This is particularly useful for shortcuts, tools, or custom item behaviours without creating custom items.

Key points

• Binds a command to an item type (and optionally to item meta).
• Command is executed when the player uses the item.
• Supports placeholders (player, location, item info).

Commands

Bind a command

/powertool set <command...>

Example:

/powertool set warp home

This binds warp home to the currently held item.

Unbind a command

/powertool

Placeholders

When binding a command you can use placeholders which will be replaced when the command runs. Typical placeholders:

• {player} — player's name
• {WORLD} - player's world name
• {x}, {y}, {z}, yaw, pitch — player's coordinates
• {ITEM_TYPE} — item material (e.g., DIAMOND_SWORD)
• {ITEM_NAME} — the name of the item