net.risingworld.api.events.player.world

Class PlayerDestroyObjectEvent

java.lang.Object

net.risingworld.api.events.Event

net.risingworld.api.events.player.PlayerEvent

net.risingworld.api.events.player.world.PlayerObjectEvent

net.risingworld.api.events.player.world.PlayerDestroyObjectEvent

All Implemented Interfaces:

Cancellable

public class PlayerDestroyObjectEvent
extends PlayerObjectEvent
implements Cancellable

Called when the player destroys an object (furniture, doors, lamps etc). It's possible to determine if it is a special object (e.g. a chest or a furnace) by using the ObjectDefinitions.

Example: Check if object is a chest

1	@EventMethod
2	public void onPlayerDestroyObject(PlayerDestroyObjectEvent event){
3	//Get the object type id
4	short objectid = event.getObjectTypeID();
5
6	//Get the definition
7	Definitions.ObjectDefiniton definition = Definitions.getObjectDefinition(objectid);
8
9	//The object definition allows you to check if it is a chest
10	if(definition.isChest()){
11	//In case the object is a chest, the chest id is stored in the object info id
12	int chestID = evt.getObjectInfoID();
13
14	//Now you can do something with the chest id...
15	evt.getPlayer().sendTextMessage("Destroyed chest with ID " + chestID);
16	}
17	}

Constructor Summary

Constructors

Constructor and Description
PlayerDestroyObjectEvent(Player player, commons.objects.ObjectElement object)
PlayerDestroyObjectEvent(Player player, short objectid, byte variation, int cx, int cy, int cz, short px, short py, short pz, short rx, short ry, short rz, int info, byte status)

Method Summary

Modifier and Type	Method and Description
boolean	isCancelled() Determines if the event is cancelled.
void	setCancelled(boolean cancel) Cancels this event.

Methods inherited from class net.risingworld.api.events.player.world.PlayerObjectEvent

getChunkPositionX, getChunkPositionY, getChunkPositionZ, getObjectDefinition, getObjectInfoID, getObjectPosition, getObjectPositionX, getObjectPositionY, getObjectPositionZ, getObjectRotation, getObjectRotationX, getObjectRotationY, getObjectRotationZ, getObjectStatus, getObjectTypeID, getObjectVariation, getPX, getPY, getPZ, getRX, getRY, getRZ

Methods inherited from class net.risingworld.api.events.player.PlayerEvent

getPlayer

Methods inherited from class java.lang.Object

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

Constructor Detail

PlayerDestroyObjectEvent

public PlayerDestroyObjectEvent(Player player,
                                commons.objects.ObjectElement object)

PlayerDestroyObjectEvent

public PlayerDestroyObjectEvent(Player player,
                                short objectid,
                                byte variation,
                                int cx,
                                int cy,
                                int cz,
                                short px,
                                short py,
                                short pz,
                                short rx,
                                short ry,
                                short rz,
                                int info,
                                byte status)

Method Detail

isCancelled

public boolean isCancelled()

Description copied from interface: Cancellable

Determines if the event is cancelled. If an event is cancelled, it will no longer be executed, but other plugins will still receive the event.

Please note: If the event is threaded, cancellation has no effect, i.e. the event will still be executed.

Specified by:

isCancelled in interface Cancellable

Returns:

true if the event is cancelled, or false if not.

setCancelled

public void setCancelled(boolean cancel)

Description copied from interface: Cancellable

Cancels this event. This means it will no longer be executed, but other plugins will still receive the event.

Please note: If the event is threaded, cancellation has no effect, i.e. the event will still be executed.

Specified by:

setCancelled in interface Cancellable

Parameters:

cancel - set to true if you want to cancel this event.