Package net.risingworld.api.events.player

Class PlayerUpdateStatusEvent

java.lang.Object
net.risingworld.api.events.Event
net.risingworld.api.events.player.PlayerEvent
net.risingworld.api.events.player.PlayerUpdateStatusEvent
All Implemented Interfaces:
Cancellable
public final class PlayerUpdateStatusEvent extends PlayerEvent implements Cancellable
Called when the player status updates (e.g hunger, thirst, temperature etc).
Example: Prevent hunger and thirst from going under 50 percent
1@EventMethod
2public void onPlayerUpdateStatus(PlayerUpdateStatusEvent event){
3 //Get the type
4 PlayerUpdateStatusEvent.Type type = event.getType();
5
6 //Check if hunger was updated
7 if(type == PlayerUpdateStatusEvent.Type.Hunger){
8 int newHunger = event.getHunger();
9 if(newHunger < 50){
10 //Cancel event
11 event.setCancelled(true);
12 }
13 }
14 //Check if thirst was updated
15 else if(type == PlayerUpdateStatusEvent.Type.Thirst){
16 int newThirst = event.getThirst();
17 if(newThirst < 50){
18 //Cancel event
19 event.setCancelled(true);
20 }
21 }
22}

  • Method Details

    • getType

      public PlayerUpdateStatusEvent.Type getType()
      Gets the update type. Use this to check if hunger was updated, or thirst, or the player temperature etc.
      Returns:
      the update type.

    • getHealth

      public int getHealth()
      Gets the new health value.
      Returns:
      the new health value.

    • setHealth

      public void setHealth(int health)
      Sets a new health value that should be applied to the player.
      Parameters:
      health - the new health value.

    • getStamina

      public int getStamina()
      Gets the new stamina value.
      Returns:
      the new stamina value (0-100).

    • setStamina

      public void setStamina(int stamina)
      Sets a new stamina value that should be applied to the player.
      Parameters:
      stamina - the new stamina value (0-100).

    • getBreath

      public int getBreath()
      Gets the new breath value.
      Returns:
      the new breath value (0-100).

    • setBreath

      public void setBreath(int breath)
      Sets a new breath value that should be applied to the player.
      Parameters:
      breath - the new breath value (0-100).

    • getHunger

      public int getHunger()
      Gets the new hunger value.
      Returns:
      the new hunger value (0-100).

    • setHunger

      public void setHunger(int hunger)
      Sets a new hunger value that should be applied to the player.
      Parameters:
      hunger - the new hunger value (0-100).

    • getThirst

      public int getThirst()
      Gets the new thirst value.
      Returns:
      the new thirst value (0-100).

    • setThirst

      public void setThirst(int thirst)
      Sets a new thirst value that should be applied to the player.
      Parameters:
      thirst - the new thirst value (0-100).

    • getTemperature

      public int getTemperature()
      Gets the new temperature value.
      Returns:
      the new temperature value.

    • setTemperature

      public void setTemperature(int temperature)
      Sets a new temperature value that should be applied to the player.
      Parameters:
      temperature - the new temperature value.

    • getWetness

      public int getWetness()
      Gets the new wetness value.
      Returns:
      the new wetness value (0-100)

    • setWetness

      public void setWetness(int wetness)
      Sets a new wetness value that should be applied to the player.
      Parameters:
      wetness - the new wetness value (0-100).

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