ETERNALCORE / GUIDE

Powertool

Bind commands to items so that using an item executes a command automatically.

Edit on GitHub

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