Bukkit

FreebieSigns

Have you ever had new players on your server starving, begging for food? Do you hate when players ask for items? Well, if you answered yes to either of those questions, I have quite the plugin for you. FreebieSigns turns normal signs into machines that dispense items to players, but only every so often. Have a sign that gives players apples, but only every three minutes. In addition, it's easy to use! Just place a sign stating the item, the amount, the freebie channel, and the delay, then click the sign and you are all set! Sounds good, doesn't it?

Making a sign

Here is a template for a sign:

Explanation

• The first line specifies that it is a freebie sign.
• The second line is the name of the item, according to code (Steak would be Cooked Beef).
• The third line specifies two things: the amount of the item and the channel. A channel is how freebie signs keep track of time for players. Example: if there are two signs on channel 22, and a player claims their freebie on sign #1, they will have to wait the delay until they can claim from any sign on channel 22, including sign #2.
• The fourth and final line is the delay. A delay of 5 amounts to five minutes and 60 seconds (six minutes), so a true five minute delay would be a four.

Activation

Activate the sign by right clicking it (only OPs can activate them). If something is wrong, it will not activate and an exception will be thrown. The possible exceptions and their meanings:

• IllegalArgumentException: the item name you entered is incorrect.
• NumberFormatException: one of the lines entered has a non-numeric character.
• Exception: You either forgot to enter a channel or a line is blank.

Planned Features

• Data values on signs
• Permissions support
• Commands

Other

Make sure to PM or leave a comment if you put it on your server! I'd be glad to come check it out and see how it fares. If you have any issues, send me an email at joeelectricity@joeelectricity.com.