Package com.palmergames.bukkit.towny.event.actions

Class TownyItemuseEvent

java.lang.Object

org.bukkit.event.Event

com.palmergames.bukkit.towny.event.CancellableTownyEvent

com.palmergames.bukkit.towny.event.actions.TownyActionEvent

com.palmergames.bukkit.towny.event.actions.TownyItemuseEvent

All Implemented Interfaces:

org.bukkit.event.Cancellable

public class TownyItemuseEvent
extends TownyActionEvent

Part of the API which lets Towny's war and other plugins modify Towny's plot-permission-decision outcomes. Itemuse event thrown when a player attempts to use an item that is in the Towny config's item_use_ids list. These are typically consumed items like enderpearls, chorus fruit, boats and minecarts items, etc.

Author:

LlmDl

Nested Class Summary

Nested classes/interfaces inherited from class org.bukkit.event.Event

org.bukkit.event.Event.Result

Field Summary

Fields inherited from class com.palmergames.bukkit.towny.event.actions.TownyActionEvent

loc, mat, player, townblock

Constructor Summary

Constructors

Constructor	Description
TownyItemuseEvent(org.bukkit.entity.Player player, org.bukkit.Location loc, org.bukkit.Material mat, TownBlock townblock, boolean cancelled)	Itemuse event thrown when a player attempts to use an item that is in the Towny config's item_use_ids list.

Method Summary

Modifier and Type	Method	Description
static org.bukkit.event.HandlerList	getHandlerList()
org.bukkit.event.HandlerList	getHandlers()

Methods inherited from class com.palmergames.bukkit.towny.event.actions.TownyActionEvent

getLocation, getMaterial, getPlayer, getTownBlock, hasTownBlock, isInWilderness, isMessageSuppressed, suppressMessage

Methods inherited from class com.palmergames.bukkit.towny.event.CancellableTownyEvent

getCancelMessage, isCancelled, setCancelled, setCancelMessage

Methods inherited from class org.bukkit.event.Event

getEventName, isAsynchronous

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

TownyItemuseEvent

public TownyItemuseEvent(org.bukkit.entity.Player player,
 org.bukkit.Location loc,
 org.bukkit.Material mat,
 TownBlock townblock,
 boolean cancelled)

Itemuse event thrown when a player attempts to use an item that is in the Towny config's item_use_ids list. These are typically consumed items like enderpearls, chorus fruit, boats and minecarts items, etc. This will be thrown even if Towny has already decided to cancel the event, giving other plugins (and Towny's internal war system) the chance to modify the outcome. If you do not intend to un-cancel something already cancelled by Towny, use ignorecancelled=true in order to get only events which Towny will otherwise allow.

Parameters:

player - involved in the itemuse event.

loc - location of the block which has an item being used on it.

mat - material of the item being used.

townblock - - TownBlock or null if in the wilderness.

cancelled - true if Towny has already determined this will be cancelled.

Method Details

getHandlerList

public static org.bukkit.event.HandlerList getHandlerList()

getHandlers

public org.bukkit.event.HandlerList getHandlers()

Specified by:

getHandlers in class org.bukkit.event.Event