Upstream/Paper
1
0
Fork 0
mirror of https://github.com/PaperMC/Paper.git synced 2024-12-31 21:37:39 +01:00
Code Issues Projects Releases Wiki Activity

#578: Add methods to modify the rate of regeneration and starvation

Browse Source 
By: Martoph <sager1018@gmail.com>
This commit is contained in:
Bukkit/Spigot 2021-03-04 08:28:02 +11:00
parent c6f6cd05e4
commit 5d55e7241c
2 changed files with 103 additions and 49 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

103
paper-api/src/main/java/org/bukkit/entity/HumanEntity.java
View File

@ -452,4 +452,107 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder
* @return True if item was dropped successfully
*/
public boolean dropItem(boolean dropAll);
/**
* Gets the players current exhaustion level.
* <p>
* Exhaustion controls how fast the food level drops. While you have a
* certain amount of exhaustion, your saturation will drop to zero, and
* then your food will drop to zero.
*
* @return Exhaustion level
*/
public float getExhaustion();
/**
* Sets the players current exhaustion level
*
* @param value Exhaustion level
*/
public void setExhaustion(float value);
/**
* Gets the players current saturation level.
* <p>
* Saturation is a buffer for food level. Your food level will not drop if
* you are saturated {@literal >} 0.
*
* @return Saturation level
*/
public float getSaturation();
/**
* Sets the players current saturation level
*
* @param value Saturation level
*/
public void setSaturation(float value);
/**
* Gets the players current food level
*
* @return Food level
*/
public int getFoodLevel();
/**
* Sets the players current food level
*
* @param value New food level
*/
public void setFoodLevel(int value);
/**
* Get the regeneration rate (1 health per x ticks) of
* the HumanEntity when they have saturation and
* their food level is >= 20. Default is 10.
*
* @return the regeneration rate
*/
public int getSaturatedRegenRate();
/**
* Set the regeneration rate (1 health per x ticks) of
* the HumanEntity when they have saturation and
* their food level is >= 20. Default is 10.
* Not affected if the world's difficulty is peaceful.
*
* @param ticks the amount of ticks to gain 1 health.
*/
public void setSaturatedRegenRate(int ticks);
/**
* Get the regeneration rate (1 health per x ticks) of
* the HumanEntity when they have no saturation and
* their food level is >= 18. Default is 80.
*
* @return the regeneration rate
*/
public int getUnsaturatedRegenRate();
/**
* Get the regeneration rate (1 health per x ticks) of
* the HumanEntity when they have no saturation and
* their food level is >= 18. Default is 80.
* Not affected if the world's difficulty is peaceful.
*
* @param ticks the amount of ticks to gain 1 health.
*/
public void setUnsaturatedRegenRate(int ticks);
/**
* Get the starvation rate (1 health per x ticks) of
* the HumanEntity. Default is 80.
*
* @return the starvation rate
*/
public int getStarvationRate();
/**
* Get the starvation rate (1 health per x ticks) of
* the HumanEntity. Default is 80.
*
* @param ticks the amount of ticks to lose 1 health
*/
public void setStarvationRate(int ticks);
}

49
paper-api/src/main/java/org/bukkit/entity/Player.java
View File

@ -666,55 +666,6 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
*/
public void sendExperienceChange(float progress, int level);
/**
* Gets the players current exhaustion level.
* <p>
* Exhaustion controls how fast the food level drops. While you have a
* certain amount of exhaustion, your saturation will drop to zero, and
* then your food will drop to zero.
*
* @return Exhaustion level
*/
public float getExhaustion();
/**
* Sets the players current exhaustion level
*
* @param value Exhaustion level
*/
public void setExhaustion(float value);
/**
* Gets the players current saturation level.
* <p>
* Saturation is a buffer for food level. Your food level will not drop if
* you are saturated {@literal >} 0.
*
* @return Saturation level
*/
public float getSaturation();
/**
* Sets the players current saturation level
*
* @param value Saturation level
*/
public void setSaturation(float value);
/**
* Gets the players current food level
*
* @return Food level
*/
public int getFoodLevel();
/**
* Sets the players current food level
*
* @param value New food level
*/
public void setFoodLevel(int value);
/**
* Determines if the Player is allowed to fly via jump key double-tap like
* in creative mode.