PowerItem

PowerItemComponent

PowerItem lets a tagged item perform a special action when you try to place it or right‑click a block. The normal place/use action is cancelled and the mechanic runs instead.

Requirements and triggers

• Item must have a hidden id tag matching an item entry in your config. Unknown ids are deleted from the player’s hand.
• Main hand only, on right‑click (air or block) and on attempted block placement.
• Permission: configurable.
• Claims: inside GriefPrevention claims, the player must have Build trust.

World filter (whitelist)

• Add worlds to the item’s worlds list to restrict where it works. If worlds is missing, it works everywhere.
• Accepts exact world names and patterns:
  • *_nether: any Nether world (by environment)
  • *_the_end: any End world (by environment)

Mechanics

BREAKER

• Works only on target blocks listed under blocks.
• Optional ominous: true/false. For VAULT and TRIAL_SPAWNER only; must match the block’s ominous state.
• Optional drops: if true, attempts to drop the block’s normal drops (or the block itself if no drops).
• Optional consumable: if true, consumes one of the tool item on success (not in Creative).
• Feedback: plays the target block’s break sound and spawns block particles.

REDSTONE

• Works only on target blocks listed under blocks.
• If the block is Lightable (e.g., redstone lamp), a RedstoneRail, or any Powerable, it becomes powered/lit if it wasn’t already.
• The block is marked to ignore physics/redstone state changes to keep it powered.
• Optional consumable: if true, consumes one of the tool item on success (not in Creative).

TROWEL

• Right‑click a block face to place into the adjacent space (must be empty, non‑liquid, and not occupied by entities; items/xp/projectiles are ignored, armor stands block placement).
• Picks a random item from your hotbar that is either:
  • A placeable vanilla block (excludes player heads), or
  • A PAPER with a Nexo id tag (places a NOTE_BLOCK with that custom BlockData).
• Plays the block’s place sound (or the Nexo block’s configured place sound).
• mcMMO:placed blocks are marked ineligible for skill gain.
• Survival: consumes one of the placed block/paper. Creative: no consumption.
• Cooldown: global per‑player delay (default 100 ms).

Examples

BREAKER

poweritem:
 type: BREAKER
 blocks: # Blocks the poweritem can work on.
  - BEDROCK
  - VAULT
  - TRIAL_SPAWNER
 ominous: true # Should the block have to be ominous? (Vault/Trial Spawner)
 drops: false # Should the broken block drop itself?
 consumable: true # Is the item consumed on use?
 worlds: # World the item works in.
 # To mark all nethers or ends, just add *_nether or *_the_end
  - world
  - "*_nether"

REDSTONE

poweritem:
 type: REDSTONE
 blocks: # Blocks the poweritem can work on.
  - REDSTONE_LAMP
  - POWERED_RAIL
 consumable: true # Is the item consumed on use?
 worlds: # World the item works in.
 # To mark all nethers or ends, just add *_nether or *_the_end
  - world
  - "*_nether"

TROWEL

poweritem:
 type: TROWEL
 blocks: # Blocks the poweritem can work on.
  - REDSTONE_LAMP
  - POWERED_RAIL
 trowel-delay: 100 # How big is the delay between placing a block, if right-click is held down? (milliseconds)
 trowel-cost: 1 # How much durability does every use cost?
 worlds: # World the item works in.
 # To mark all nethers or ends, just add *_nether or *_the_end
  - world
  - "*_nether"
 permission: rarespawns.trowel.use # Permission required to use this item.