Limited Powertools

Notice: Update 1.9b

I have been made aware that

• the chat-command-based editor is intimidating and hard to use
• limited customizability
• almost no control over aesthetics
• a bunch of glitches associated with stacking powertools
• and so on

In 1.9b, a new Chest interface will be introduced, allowing for greater customizability. I'm also ditching the old system of data stored in lore for a single line of JSON. Those of you who know JSON will understand how much easier this may be to use. Those of you who don't know JSON, and don't like looking at scary code, there will be an aesthetic customization function.

Limited Powertools is a plugin which allows you to create powertools. Only an admin can create them, but anyone can use them, even if they wouldn't normally have access to the commands the powertool runs. There is a customizable blacklist of commands that cannot be assigned (such as ban, op, kick, stop, and whitelist).

The powertools can be given different actions when used in different ways. Currently only supports left and right click, but coming soon are when dropped with the [Q] key, shot as a bow, and when worn as armor and damaged. And to prevent spamming, powertools are given a customizable cooldown.

If you want to make a time-delay between commands, just use the built in /delayed <ticks> <command>. (See Example powertools: Flaming Volley for an example)

Example powertools

Ghast Incantation
50/50 cast charges
Cooldown: 2.5s
L: Runs /cast fire
R: Runs /fireball
Plays entity.ghast.warn on use.

Flaming Volley Incantation
50/50 cast charges
Cooldown: 5.0s
R: Runs /delayed 25 fireball
R: Runs /delayed 30 fireball
R: Runs /delayed 35 fireball
Plays entity.blaze.breathe on use.

Ironskin Potion
3/3 cast charges
Cooldown: 40s
R: Runs /effect @p minecraft:resistance 240 1

Demolition Pickaxe
20/20 cast charges
Cooldown: 20s
L: Runs /break
R: Runs /antioch

What do my admins need to know?

Commands

/lpt create <uses> <command>

Creates a powertool.

/lpt uses <set|add> <uses>

Sets the number of uses for a powertool.

/lpt maxuses <set|add> <maxuses>

Sets the maximum number of uses for a powertool.

/lpt cooldown <ticks>

Sets the cooldown for a powertool.

/lpt command <set|add> [left|right|both] <command>

Sets/adds commands for a powertool. Use left, right, or both to specify which action to trigger on. Defaults to both.

/lpt rename <name>

Renames a powertool. Changes &0-9, &a-f, &k-o, and &r to their respective formatting codes.

/lpt sound <sound>

Sets the sound played when a powertools is used.

/lpt recharge

Recharges a powertool. Convenience method for /lpt maxuses set <n>.

/lpt remove

Converts a powertool back into a vanilla item.

/delayed <ticks> <command>

Runs a command with a time delay.

Permissions nodes

• lpt.* - All Limited PowerTools permissions
• lpt.create - Create Limited PowerTools
• lpt.modify - Modify LPTs
• lpt.remove - Turn LPTs into normal items
• lpt.use - Use LPTs
• lpt.help - View plugin help
• lpt.delayed - Use /delayed

Features

Planned Features

• Run commands on player under cursor with @cursor[player] Moved to VectorMath. Use #[player(look)]# instead.
• Different sets of commands for when held, when in the hotbar, when anywhere in a user's inventory, when worn as armor, when damaged, and when charged as a bow.
• Configurable dungeon loot
• Vault integration

Version history

1.9b (Work in progress)

• Execute commands at target location with @cursor[block] Moved to VectorMath. Use #[lookblock(distance)]# instead. VectorMath will be released with LPT 1.9b.
• Cooldown individual to powertool
• Ditched old data structure for JSON
• Customizable aesthetic
• Add GUI for simpler use with features such as command editing and lore system
• Fixed a glitch which let powertools with cooldowns of less than 1 second have no cooldown

1.8b-compat

• Updated to work with 1.8 and 1.9.
• Switched from enumeration sound system (ex. FIREWORK_BLAST, ZOMBIE_UNFECT) to minecraft's native sound system (ex. firework.blast, mob.zombie.unfect). This means more sounds, including those from custom resource packs! Updated to work with [Tab] complete.
• Powertools do NOT work in the off-hand.
• Added translation dictionary system. This means your old powertools and config.yml will be automatically updated. Note: Not backwards compatible.
• Run commands with a delay using /delayed <ticks> <command> Note: Not protected by blacklist.

1.8b

• Dual binding: Assign different commands to left/right click, and have some that activate for both
• Cooldowns: No more spamming powertools! (Based on when any powertool was last used)
• Powertools from previous versions need to be converted. Before, commands were identified by "Runs /". They are now identified by "[L:R:B]: Runs /". Use /lpt command set [left:right:both] to convert.
• Fixed a bug which caused powertools to behave as if the vanilla item was used.

1.7b

• Official help screen at /lpt
• Per-powertool sound effect
• Added a tab-complete - goes well with the per-powertool sound effect.
• Removed /lpt modify - Use /lpt <uses:maxuses> <set:add> instead of -u= / -m=, /lpt rename <name> instead of -n=, /lpt command <set:add> instead of -c= / -c+=

1.65b

• Fixed /lpt modify -n; it now works with spaces.
• Added a secondary filter to command blacklist. You can no longer bypass the blacklist by modifying the item lore.

1.6b

• Tried to make /lpt modify -n work with spaces. Broke it instead.
• Added command blacklist
• Added config file (not much here right now, but will be used in future versions)
• Added sound on use and failure (configurable - can be any string in org.bukkit.Sound)

1.5b

• Fixed a glitch where users could duplicate powertools
• Can now assign multiple commands to a powertool
• Added the HUD system

1.4b

• Fixed a couple of bugs
• /lpt modify -n now accepts color codes
• /lpt modify -c now accepts multi-word commands

1.3b

• First (official) release