Package net.risingworld.api.events.player

Class PlayerDropItemFromStorageEvent

java.lang.Object
net.risingworld.api.events.Event
net.risingworld.api.events.player.PlayerEvent
net.risingworld.api.events.player.PlayerDropItemFromStorageEvent
All Implemented Interfaces:
Cancellable
public final class PlayerDropItemFromStorageEvent extends PlayerEvent implements Cancellable
Called when a player drops an item from a storage (e.g a chest).

  • Method Details

    • getItem

      public Item getItem()
      Gets the item.
      Returns:
      the item.

    • getAmount

      public int getAmount()
      Gets the amount (stack size) the player wants to drop from the inventory.
      Returns:
      the amount of items (from the stack) that will be dropped.

    • getWorldItem

      public WorldItem getWorldItem()
      Gets the newly created world item representation of the item that is about to be dropped. May be null.
      Returns:
      the new world item, or null if this item has no world item representation.

    • getStorageID

      public long getStorageID()
      Gets the ID of the storage.
      Returns:
      the storage ID.

    • getStorageSlot

      public int getStorageSlot()
      Gets the item slot in the storage (where the player got the item from).
      Returns:
      the item slot in the storage.

    • getPosition

      public Vector3f getPosition()
      Gets the item drop position.
      Returns:
      the global item drop position.

    • getRotation

      public Quaternion getRotation()
      Gets the item drop rotation (rotation of the item).
      Returns:
      the item drop rotation.

    • 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
      2public 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}