DispenserTools

Version: v1.1
Newest tested Bukkit version: 1.5.1-R0.1
Optional dependency for cuboid selections: WorldEdit
If you update from 1.0 to 1.1 you need to regenerate the config or add the new options manually (below is a list) to use new features!

Features

• Easy filling of giant Silvester fireworks
• Fill any item in dispensers via item-name or item-id
• Clear dispensers
• dispense items of dispensers
• Fill in RANDOM FIREWORKS
• WorldEdit selections support
• Radius and WorldEdit mode
• Only one command
• permissions

Video

Commands and Permissions

The main command is: /dispensertools The main permissions which contains all other is: DispenserTools.all
The permission to get update Notifications is: DispenserTools.updateinfo (You'll also get the notification if you have the ".all" Permission )

Quote:

/dispensertools

Quote:

Alias: /dito or /p or /dispenser or /disp
Permission: DispenserTools.help
Shows the Help if you use it without Arguments

/dt reload

Quote:

Alias: /dt r
Permission: DispenserTools.reload
Reloads the config if you changed something in it and don't want to restart/reload you entire server

/dt <radius> [item] [amount]

Quote:

Permission: DispenserTools.interact
Replace <radius> with:

Quote:

selection

Quote:

Alias: s or sel
Use the WorldEdit selection

number

Quote:

Example: 10 or 20
use a number to interact with all blocks in this distance arround you

Only <radius> is required

Replace [item] with:

Quote:

Item-name or Item-id

Quote:

Examples: 'snowball' or '262'
Fills [amount] of the item in the dispensers in the selection/radius

fireworks

Quote:

Alias: fw
Fills [amount] random generated fireworks in the dispensers in the selection/radius
By default the plugin will fill every slot of the dispenser with different fireworks. E.G if you choose 27 as [amount] it will fill every slot of every dispenser in the selection/radius with 3 firework (3per slot * 9 slot equals with 27). You can disable this in the config.yml. Then it'll put 27 fireworks in the first slot.

Dispense

Quote:

Alias: d
Dispenses [amount] Items from the selected dispensers. Will shot arrows / fireworks and drop items like stone

clear

Quote:

Alias: c
Clears all items in Dispensers in the selected Area/Radius

nothing

Quote:

If you leave it blank it will use the item in your hand to fill [amount] of it into all dispensers in the selection/radius Supports item data values like spawn eggs and wool colors IMPORTANT: you can't define an amount then (it'll use the default amount)!

Replace [amount] with:

Quote:

A number

Quote:

The number will be used for filling and dispensing items from dispensers

nothing

Quote:

If you leave the argument blank the default stack size (64) will be used for filling and one for dispensing

Installation

Simply put the "WordPunishments.jar" in your "plugins" folder and reload or restart the server.

It'll generate a config file:

splitFireworks

true

This splits Fireworks, that every slot of the dispensers is filled with other fireworks. E.G you use 18 fireworks as amount every slot will contain two fireworks and every slot has other fireworks. If you set it to false the first slot of the dispenser will be filled with 18 fireworks.

dropper

true

Enable/disable support for droppers. If you enable it you can edit dispensers and droppers with the above commands.

updateinfo

true

Print's an update notification in the server log and in the chat for ops and players with DispenserTools.updateinfo or DispenserTools.all

enabledebug

false

This enables the debug mode which loggs everything the plugin does in the console. It's recommend to turn it off, becauce it causes heavy laggs!

Change main command

If you want to change the main command or an alias open the DispenserTools.jar with Winrar or 7zip and edit the commands section

Todo

•Add automatic update infos
•Add support for the new droppers in 1.5
Write a comment if you have suggestions :)

Changelog

"+" added something

"-" removed something

"" changed something

"*" fixed something
1.1 + support for Droppers + update notifications ~ cleaned up plugin.yml ~ increased the max number of effects for random fireworks 1.0 + First version