753 lines
19 KiB
Java
753 lines
19 KiB
Java
package org.bukkit.event;
|
|
|
|
import java.io.Serializable;
|
|
|
|
/**
|
|
* Represents an event
|
|
*/
|
|
public abstract class Event implements Serializable {
|
|
private final Type type;
|
|
private final String name;
|
|
|
|
protected Event(final Type type) {
|
|
exAssert(type != null, "type is null");
|
|
exAssert(type != Type.CUSTOM_EVENT, "use Event(String) to make custom events");
|
|
this.type = type;
|
|
this.name = null;
|
|
}
|
|
|
|
protected Event(final String name) {
|
|
exAssert(name != null, "name is null");
|
|
this.type = Type.CUSTOM_EVENT;
|
|
this.name = name;
|
|
}
|
|
|
|
/**
|
|
* Gets the Type of this event
|
|
* @return Event type that this object represents
|
|
*/
|
|
public final Type getType() {
|
|
return type;
|
|
}
|
|
|
|
private void exAssert(boolean b, String s) {
|
|
if(!b) throw new IllegalArgumentException(s);
|
|
}
|
|
|
|
/**
|
|
* Gets the event's name. Should only be used if getType() == Type.CUSTOM
|
|
*
|
|
* @return Name of this event
|
|
*/
|
|
public final String getEventName() {
|
|
return ( type != Type.CUSTOM_EVENT) ? type.toString() : name;
|
|
}
|
|
|
|
/**
|
|
* Represents an events priority in execution
|
|
*/
|
|
public enum Priority {
|
|
/**
|
|
* Event call is of very low importance and should be ran first, to allow
|
|
* other plugins to further customise the outcome
|
|
*/
|
|
Lowest,
|
|
|
|
/**
|
|
* Event call is of low importance
|
|
*/
|
|
Low,
|
|
|
|
/**
|
|
* Event call is neither important or unimportant, and may be ran normally
|
|
*/
|
|
Normal,
|
|
|
|
/**
|
|
* Event call is of high importance
|
|
*/
|
|
High,
|
|
|
|
/**
|
|
* Event call is critical and must have the final say in what happens
|
|
* to the event
|
|
*/
|
|
Highest,
|
|
|
|
/**
|
|
* Event is listened to purely for monitoring the outcome of an event.
|
|
*
|
|
* No modifications to the event should be made under this priority
|
|
*/
|
|
Monitor
|
|
}
|
|
|
|
/**
|
|
* Represents a category used by Type
|
|
*/
|
|
public enum Category {
|
|
/**
|
|
* Represents Player-based events
|
|
* @see Category.LIVING_ENTITY
|
|
*/
|
|
PLAYER,
|
|
|
|
/**
|
|
* Represents Entity-based events
|
|
*/
|
|
ENTITY,
|
|
|
|
/**
|
|
* Represents Block-based events
|
|
*/
|
|
BLOCK,
|
|
|
|
/**
|
|
* Represents LivingEntity-based events
|
|
*/
|
|
LIVING_ENTITY,
|
|
|
|
/**
|
|
* Represents Weather-based events
|
|
*/
|
|
WEATHER,
|
|
|
|
/**
|
|
* Vehicle-based events
|
|
*/
|
|
VEHICLE,
|
|
|
|
/**
|
|
* Represents World-based events
|
|
*/
|
|
WORLD,
|
|
|
|
/**
|
|
* Represents Server and Plugin based events
|
|
*/
|
|
SERVER,
|
|
|
|
/**
|
|
* Represents Inventory-based events
|
|
*/
|
|
INVENTORY,
|
|
|
|
/**
|
|
* Any miscellaneous events
|
|
*/
|
|
MISCELLANEOUS;
|
|
}
|
|
|
|
/**
|
|
* Provides a lookup for all core events
|
|
*
|
|
* @see org.bukkit.event.
|
|
*/
|
|
public enum Type {
|
|
/**
|
|
* PLAYER EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a player enters the world on a server
|
|
*
|
|
* @see org.bukkit.event.player.PlayerEvent
|
|
*/
|
|
PLAYER_JOIN (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player is attempting to connect to the server
|
|
*
|
|
* @see org.bukkit.event.player.PlayerLoginEvent
|
|
*/
|
|
PLAYER_LOGIN (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player has just been authenticated
|
|
*
|
|
* @see org.bukkit.event.player.PlayerPreLoginEvent
|
|
*/
|
|
PLAYER_PRELOGIN (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player respawns
|
|
*
|
|
* @see org.bukkit.event.player.PlayerEvent
|
|
*/
|
|
PLAYER_RESPAWN (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player gets kicked a server
|
|
*
|
|
* @see org.bukkit.event.player.PlayerEvent
|
|
*/
|
|
PLAYER_KICK (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player sends a chat message
|
|
*
|
|
* @see org.bukkit.event.player.PlayerChatEvent
|
|
*/
|
|
PLAYER_CHAT (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player early in the command handling process
|
|
*
|
|
* @see org.bukkit.event.player.PlayerChatEvent
|
|
*/
|
|
PLAYER_COMMAND_PREPROCESS (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player leaves a server
|
|
*
|
|
* @see org.bukkit.event.player.PlayerEvent
|
|
*/
|
|
PLAYER_QUIT (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player moves position in the world
|
|
*
|
|
* @see org.bukkit.event.player.PlayerMoveEvent
|
|
*/
|
|
PLAYER_MOVE (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player undergoes an animation, such as arm swinging
|
|
*
|
|
* @see org.bukkit.event.player.PlayerAnimationEvent
|
|
*/
|
|
PLAYER_ANIMATION (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player toggles sneak mode
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
PLAYER_TOGGLE_SNEAK (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player uses an item
|
|
*
|
|
* @see org.bukkit.event.player.PlayerItemEvent
|
|
*/
|
|
PLAYER_INTERACT (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player throws an egg and it might hatch
|
|
*
|
|
* @see org.bukkit.event.player.PlayerEggThrowEvent
|
|
*/
|
|
PLAYER_EGG_THROW (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player teleports from one position to another
|
|
*
|
|
* @see org.bukkit.event.player.PlayerMoveEvent
|
|
*/
|
|
PLAYER_TELEPORT (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player changes their held item
|
|
*
|
|
* @see org.bukkit.event.player.PlayerItemHeldEvent
|
|
*/
|
|
PLAYER_ITEM_HELD (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player drops an item
|
|
*
|
|
* @see org.bukkit.event.player.PlayerDropItemEvent
|
|
*/
|
|
PLAYER_DROP_ITEM (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player picks an item up off the ground
|
|
*
|
|
* @see org.bukkit.event.player.PlayerPickupItemEvent
|
|
*/
|
|
PLAYER_PICKUP_ITEM (Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player empties a bucket
|
|
*
|
|
* @see org.bukkit.event.player.PlayerBucketEmptyEvent
|
|
*/
|
|
PLAYER_BUCKET_EMPTY(Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player fills a bucket
|
|
*
|
|
* @see org.bukkit.event.player.PlayerBucketFillEvent
|
|
*/
|
|
PLAYER_BUCKET_FILL(Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player interacts with the inventory
|
|
*
|
|
* @see org.bukkit.event.player.PlayerInventoryEvent
|
|
*/
|
|
PLAYER_INVENTORY(Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player enter a bed
|
|
*
|
|
* @see org.bukkit.event.player.PlayerBedEnterEvent
|
|
*/
|
|
PLAYER_BED_ENTER(Category.PLAYER),
|
|
|
|
/**
|
|
* Called when a player leaves a bed
|
|
*
|
|
* @see org.bukkit.event.player.PlayerBedEnterEvent
|
|
*/
|
|
PLAYER_BED_LEAVE(Category.PLAYER),
|
|
|
|
/**
|
|
* BLOCK EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a block is damaged (hit by a player)
|
|
*
|
|
* @see org.bukkit.event.block.BlockDamageEvent
|
|
*/
|
|
BLOCK_DAMAGE (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a block is undergoing a universe physics
|
|
* check on whether it can be built
|
|
*
|
|
* For example, cacti cannot be built on grass unless overridden here
|
|
*
|
|
* @see org.bukkit.event.block.BlockCanBuildEvent
|
|
*/
|
|
BLOCK_CANBUILD (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a block of water or lava attempts to flow into another
|
|
* block
|
|
*
|
|
* @see org.bukkit.event.block.BlockFromToEvent
|
|
*/
|
|
BLOCK_FROMTO (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a block is being set on fire from another block, such as
|
|
* an adjacent block of fire attempting to set fire to wood
|
|
*
|
|
* @see org.bukkit.event.block.BlockIgniteEvent
|
|
*/
|
|
BLOCK_IGNITE (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a block undergoes a physics check
|
|
*
|
|
* A physics check is commonly called when an adjacent block changes
|
|
* type
|
|
*
|
|
* @see org.bukkit.event.block.BlockPhysicsEvent
|
|
*/
|
|
BLOCK_PHYSICS (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a player is attempting to place a block
|
|
*
|
|
* @see org.bukkit.event.block.BlockPlaceEvent
|
|
*/
|
|
BLOCK_PLACE (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a block is destroyed from being burnt by fire
|
|
*
|
|
* @see org.bukkit.event.block.BlockBurnEvent
|
|
*/
|
|
BLOCK_BURN (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when leaves are decaying naturally
|
|
*
|
|
* @see org.bukkit.event.block.LeavesDecayEvent
|
|
*/
|
|
LEAVES_DECAY (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a sign is changed
|
|
*
|
|
* @see org.bukkit.event.block.SignChangeEvent
|
|
*/
|
|
SIGN_CHANGE (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a block changes redstone current. Only triggered on blocks
|
|
* that are actually capable of transmitting or carrying a redstone
|
|
* current
|
|
*
|
|
* @see org.bukkit.event.block.BlockFromToEvent
|
|
*/
|
|
REDSTONE_CHANGE (Category.BLOCK),
|
|
|
|
/**
|
|
* Called when a block is destroyed by a player.
|
|
*
|
|
* @see org.bukkit.event.block.BlockBreakEvent
|
|
*/
|
|
BLOCK_BREAK (Category.BLOCK),
|
|
|
|
/**
|
|
* INVENTORY EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a player opens an inventory
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
INVENTORY_OPEN (Category.INVENTORY),
|
|
|
|
/**
|
|
* Called when a player closes an inventory
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
INVENTORY_CLOSE (Category.INVENTORY),
|
|
|
|
/**
|
|
* Called when a player clicks on an inventory slot
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
INVENTORY_CLICK (Category.INVENTORY),
|
|
|
|
/**
|
|
* Called when an inventory slot changes values or type
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
INVENTORY_CHANGE (Category.INVENTORY),
|
|
|
|
/**
|
|
* Called when a player is attempting to perform an inventory transaction
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
INVENTORY_TRANSACTION (Category.INVENTORY),
|
|
|
|
/**
|
|
* SERVER EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a plugin is enabled
|
|
*
|
|
* @see org.bukkit.event.server.PluginEvent
|
|
*/
|
|
PLUGIN_ENABLE (Category.SERVER),
|
|
|
|
/**
|
|
* Called when a plugin is disabled
|
|
*
|
|
* @see org.bukkit.event.server.PluginEvent
|
|
*/
|
|
PLUGIN_DISABLE (Category.SERVER),
|
|
|
|
/**
|
|
* Called when a server command is called
|
|
*
|
|
* @see org.bukkit.event.server.PluginEvent
|
|
*/
|
|
SERVER_COMMAND (Category.SERVER),
|
|
|
|
/**
|
|
* WORLD EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a chunk is loaded
|
|
*
|
|
* If a new chunk is being generated for loading, it will call
|
|
* Type.CHUNK_GENERATION and then Type.CHUNK_LOADED upon completion
|
|
*
|
|
* @see org.bukkit.event.world.ChunkLoadEvent
|
|
*/
|
|
CHUNK_LOAD (Category.WORLD),
|
|
|
|
/**
|
|
* Called when a chunk is unloaded
|
|
*
|
|
* @see org.bukkit.event.world.ChunkUnloadEvent
|
|
*/
|
|
CHUNK_UNLOAD (Category.WORLD),
|
|
|
|
/**
|
|
* Called when a chunk needs to be generated
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
CHUNK_GENERATION (Category.WORLD),
|
|
|
|
/**
|
|
* Called when an ItemEntity spawns in the world
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
ITEM_SPAWN (Category.WORLD),
|
|
|
|
/**
|
|
* Called when a World's spawn is changed
|
|
*
|
|
* @see org.bukkit.event.world.SpawnChangeEvent
|
|
*/
|
|
SPAWN_CHANGE (Category.WORLD),
|
|
|
|
/**
|
|
* Called when a world is saved
|
|
*
|
|
*/
|
|
WORLD_SAVE (Category.WORLD),
|
|
|
|
/**
|
|
* Called when a World is loaded
|
|
*/
|
|
WORLD_LOAD (Category.WORLD),
|
|
|
|
/**
|
|
* ENTITY EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a painting is placed by player
|
|
*
|
|
* @see org.bukkit.event.painting.PaintingCreateEvent
|
|
*/
|
|
PAINTING_PLACE (Category.ENTITY),
|
|
|
|
/**
|
|
* Called when a painting is removed
|
|
*
|
|
* @see org.bukkit.event.painting.PaintingRemoveEvent
|
|
*/
|
|
PAINTING_BREAK (Category.ENTITY),
|
|
|
|
/**
|
|
* LIVING_ENTITY EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a creature, either hostile or neutral, attempts to spawn
|
|
* in the world "naturally"
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
CREATURE_SPAWN (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when a LivingEntity is damaged with no source.
|
|
*
|
|
* @see org.bukkit.event.entity.EntityDamageEvent
|
|
*/
|
|
ENTITY_DAMAGE (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when a LivingEntity dies
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
ENTITY_DEATH (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when a Skeleton or Zombie catch fire due to the sun
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
ENTITY_COMBUST (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when an entity explodes, either TNT, Creeper, or Ghast Fireball
|
|
*
|
|
* @todo: add javadoc see comment
|
|
*/
|
|
ENTITY_EXPLODE (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when an entity has made a decision to explode.
|
|
*
|
|
* Provides an opportunity to act on the entity, change the explosion radius,
|
|
* or to change the fire-spread flag.
|
|
*
|
|
* Canceling the event negates the entity's decision to explode.
|
|
* For EntityCreeper, this resets the fuse but does not kill the Entity.
|
|
* For EntityFireball and EntityTNTPrimed....?
|
|
*
|
|
* @see org.bukkit.event.entity.EntityExplodeTriggerEvent
|
|
*/
|
|
EXPLOSION_PRIME (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when an entity targets another entity
|
|
*
|
|
* @see org.bukkit.event.entity.EntityTargetEvent
|
|
*/
|
|
ENTITY_TARGET (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when an entity interacts with a block
|
|
* This event specifically excludes player entities
|
|
*
|
|
* @see org.bukkit.event.entity.EntityInteractEvent
|
|
*/
|
|
ENTITY_INTERACT (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when a creeper gains or loses a power shell
|
|
*
|
|
* @see org.bukkit.event.entity.CreeperPowerEvent
|
|
*/
|
|
CREEPER_POWER (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* Called when a pig is zapped, zombifying it
|
|
*
|
|
* @see org.bukkit.event.entity.PigZapEvent
|
|
*/
|
|
PIG_ZAP (Category.LIVING_ENTITY),
|
|
|
|
/**
|
|
* WEATHER EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a lightning entity strikes somewhere
|
|
*
|
|
* @see org.bukkit.event.weather.LightningStrikeEvent
|
|
*/
|
|
LIGHTNING_STRIKE (Category.WEATHER),
|
|
|
|
/**
|
|
* Called when the weather in a world changes
|
|
*
|
|
* @see org.bukkit.event.weather.WeatherChangeEvent
|
|
*/
|
|
WEATHER_CHANGE (Category.WEATHER),
|
|
|
|
/**
|
|
* Called when the thunder state in a world changes
|
|
*
|
|
* @see org.bukkit.event.weather.ThunderChangeEvent
|
|
*/
|
|
THUNDER_CHANGE (Category.WEATHER),
|
|
|
|
/**
|
|
* VEHICLE EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Called when a vehicle is placed by a player
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleCreateEvent
|
|
*/
|
|
VEHICLE_CREATE (Category.VEHICLE),
|
|
|
|
/**
|
|
* Called when a vehicle is destroyed
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleDestroyEvent
|
|
*/
|
|
VEHICLE_DESTROY (Category.VEHICLE),
|
|
|
|
/**
|
|
* Called when a vehicle is damaged by a LivingEntity
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleDamageEvent
|
|
*/
|
|
VEHICLE_DAMAGE (Category.VEHICLE),
|
|
|
|
/**
|
|
* Called when a vehicle collides with an Entity
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleCollisionEvent
|
|
*/
|
|
VEHICLE_COLLISION_ENTITY (Category.VEHICLE),
|
|
|
|
/**
|
|
* Called when a vehicle collides with a Block
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleBlockCollisionEvent
|
|
*/
|
|
VEHICLE_COLLISION_BLOCK (Category.VEHICLE),
|
|
|
|
/**
|
|
* Called when a vehicle is entered by a LivingEntity
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleEnterEvent
|
|
*/
|
|
VEHICLE_ENTER (Category.VEHICLE),
|
|
|
|
/**
|
|
* Called when a vehicle is exited by a LivingEntity
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleExitEvent
|
|
*/
|
|
VEHICLE_EXIT (Category.VEHICLE),
|
|
|
|
/**
|
|
* Called when a vehicle moves position in the world
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleMoveEvent
|
|
*/
|
|
VEHICLE_MOVE (Category.VEHICLE),
|
|
|
|
/**
|
|
* Called when a vehicle is going through an update cycle, rechecking itself
|
|
*
|
|
* @see org.bukkit.event.vehicle.VehicleUpdateEvent
|
|
*/
|
|
VEHICLE_UPDATE (Category.VEHICLE),
|
|
|
|
/**
|
|
* MISCELLANEOUS EVENTS
|
|
*/
|
|
|
|
/**
|
|
* Represents a custom event, isn't actually used
|
|
*/
|
|
CUSTOM_EVENT (Category.MISCELLANEOUS);
|
|
|
|
private final Category category;
|
|
|
|
private Type(Category category) {
|
|
this.category = category;
|
|
}
|
|
|
|
/**
|
|
* Gets the Category assigned to this event
|
|
*
|
|
* @return Category of this Event.Type
|
|
*/
|
|
public Category getCategory() {
|
|
return category;
|
|
}
|
|
}
|
|
|
|
public enum Result {
|
|
/**
|
|
* Deny the event.
|
|
* Depending on the event, the action indicated by the event will either not take place or will be reverted.
|
|
* Some actions may not be denied.
|
|
*/
|
|
DENY,
|
|
|
|
/**
|
|
* Neither deny nor allow the event.
|
|
* The server will proceed with its normal handling.
|
|
*/
|
|
DEFAULT,
|
|
|
|
/**
|
|
* Allow / Force the event.
|
|
* The action indicated by the event will take place if possible, even if the server would not normally allow the action.
|
|
* Some actions may not be allowed.
|
|
*/
|
|
ALLOW;
|
|
}
|
|
}
|