mirror of
https://github.com/PaperMC/Paper.git
synced 2024-12-28 15:30:19 +01:00
e1c0033552
Upstream has released updates that appear to apply and compile correctly. This update has not been tested by PaperMC and as with ANY update, please do your own testing Bukkit Changes: 2b4b6d14 PR-1023: Convert InventoryView to interface CraftBukkit Changes: 68603b1c1 Use expanded interaction ranges for traced interact events eae9f760c PR-1414: Convert InventoryView to interface ee9eafe67 Fix Implementation for DamageSource#isIndirect for internal custom causing entity
56 lines
2.5 KiB
Diff
56 lines
2.5 KiB
Diff
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
From: Lukas Planz <lukas.planz@web.de>
|
|
Date: Tue, 5 Sep 2023 20:33:52 +0200
|
|
Subject: [PATCH] Add experience points API
|
|
|
|
|
|
diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java
|
|
index 09094f55509eaf66670c27409b4d5ec3d73412b0..4bc4a1c0c6f6759f984843823f1bbec6ffed92bc 100644
|
|
--- a/src/main/java/org/bukkit/entity/Player.java
|
|
+++ b/src/main/java/org/bukkit/entity/Player.java
|
|
@@ -1907,6 +1907,45 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
|
|
* @param exp New total experience points
|
|
*/
|
|
public void setTotalExperience(int exp);
|
|
+ // Paper start
|
|
+ /**
|
|
+ * Gets the players total amount of experience points he collected to reach the current level and level progress.
|
|
+ *
|
|
+ * <p>This method differs from {@link #getTotalExperience()} in that this method always returns an
|
|
+ * up-to-date value that reflects the players{@link #getLevel() level} and {@link #getExp() level progress}</p>
|
|
+ *
|
|
+ * @return Current total experience points
|
|
+ * @see #getLevel()
|
|
+ * @see #getExp()
|
|
+ * @see #setExperienceLevelAndProgress(int)
|
|
+ */
|
|
+ @org.jetbrains.annotations.Range(from = 0, to = Integer.MAX_VALUE) int calculateTotalExperiencePoints();
|
|
+
|
|
+ /**
|
|
+ * Updates the players level and level progress to that what would be reached when the total amount of experience
|
|
+ * had been collected.
|
|
+ *
|
|
+ * <p>This method differs from {@link #setTotalExperience(int)} in that this method actually updates the
|
|
+ * {@link #getLevel() level} and {@link #getExp() level progress} so that a subsequent call of
|
|
+ * {@link #calculateTotalExperiencePoints()} yields the same amount of points that have been set</p>
|
|
+ *
|
|
+ * @param totalExperience New total experience points
|
|
+ * @see #setLevel(int)
|
|
+ * @see #setExp(float)
|
|
+ * @see #calculateTotalExperiencePoints()
|
|
+ */
|
|
+ void setExperienceLevelAndProgress(@org.jetbrains.annotations.Range(from = 0, to = Integer.MAX_VALUE) int totalExperience);
|
|
+
|
|
+ /**
|
|
+ * Gets the total amount of experience points that are needed to reach the next level from zero progress towards it.
|
|
+ *
|
|
+ * <p>Can be used with {@link #getExp()} to calculate the current points for the current level and alike</p>
|
|
+ *
|
|
+ * @return The required experience points
|
|
+ * @see #getExp()
|
|
+ */
|
|
+ int getExperiencePointsNeededForNextLevel();
|
|
+ // Paper end
|
|
|
|
/**
|
|
* Send an experience change.
|