Package net.risingworld.api.events.player

Class PlayerHitNpcEvent

java.lang.Object

net.risingworld.api.events.Event

net.risingworld.api.events.player.PlayerEvent

net.risingworld.api.events.player.PlayerNpcEvent

net.risingworld.api.events.player.PlayerHitNpcEvent

All Implemented Interfaces:

Cancellable

public final class PlayerHitNpcEvent
extends PlayerNpcEvent
implements Cancellable

Called when a player hits / attacks an npc.

Field Summary

Fields inherited from class net.risingworld.api.events.Event

cancelled, pointer

Method Summary

Modifier and Type	Method	Description
short	getDamage()	Gets the amount of damage this hit will cause.
float	getDistance()	Gets the distance between the player and the target npc (or more precisely, the damage point).
Vector3f	getHitPosition()	Gets the coordinates where the npc was hit exactly.
Npc	getNpc()	Gets the target npc, i.e the npc which was hit by the player.
boolean	isCancelled()	Determines if the event is cancelled.
void	setCancelled(boolean cancel)	Cancels this event.
void	setDamage(short damage)	Sets the amount of damage that will be caused by this hit.
void	setHitPosition(float x, float y, float z)	Sets the coordinates where the npc was hit exactly.
void	setHitPosition(Vector3f position)	Sets the coordinates where the npc was hit exactly.

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

getPlayer

Methods inherited from class net.risingworld.api.events.Event

equals, hashCode, isValid

Methods inherited from class java.lang.Object

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

Method Details

getNpc

public Npc getNpc()

Gets the target npc, i.e the npc which was hit by the player.

Overrides:

getNpc in class PlayerNpcEvent

Returns:

the npc which was hit (the "victim").

setHitPosition

public void setHitPosition(Vector3f position)

Sets the coordinates where the npc was hit exactly.

Parameters:

position - the new position.

setHitPosition

public void setHitPosition(float x,
 float y,
 float z)

Sets the coordinates where the npc was hit exactly.

Parameters:

x - the x coordinate.

y - the y coordinate.

z - the z coordinate.

getHitPosition

public Vector3f getHitPosition()

Gets the coordinates where the npc was hit exactly.

Returns:

coordinates where the npc was hit.

setDamage

public void setDamage(short damage)

Sets the amount of damage that will be caused by this hit.

Parameters:

damage - the new damage amount.

getDamage

public short getDamage()

Gets the amount of damage this hit will cause.

Returns:

the amount of damage.

getDistance

public float getDistance()

Gets the distance between the player and the target npc (or more precisely, the damage point).

Returns:

the distance.

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.

Specified by:

setCancelled in interface Cancellable

Parameters:

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

Example: Cancel "PlayerEnterAreaEvent", i.e prevent player from entering an area

1	//Listener class
2	public class PlayerListener implements Listener{
3	@EventMethod
4	public void onEnterArea(PlayerEnterAreaEvent evt){
5	//Now the player will not be able to enter the area, i.e.
6	//he will be teleported back to his old position (outside the area)
7	evt.setCancelled(true);
8	}
9	}