mirror of
https://github.com/PaperMC/Paper.git
synced 2024-11-28 13:36:16 +01:00
52a05907c7
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: 97c59261 PR-1073: Make Biome an interface a38581aa Fix further javadoc errors 8271c490 Fix javadoc error 8a9ecf29 PR-1072: Fix bad naming for Vault State methods 6dd58108 PR-1071: Make Fluid an interface and add missing entry ed2cdfc3 PR-1070: Make Attribute an interface and align names with the new minecraft ones 63472efb PR-1069: Add missing winter drop experimental annotation to pale boats CraftBukkit Changes: 7235ad7b0 PR-1501: Make Biome an interface 602904003 PR-1500: Rename implementation for Vault State methods 75f26f79f PR-1499: Make Fluid an interface and add missing entry 4cfd87adc PR-1498: Make Attribute an interface and align names with the new minecraft ones 6bb0db5cb SPIGOT-7928: ExactChoice acts as MaterialChoice 3eaf3a13c SPIGOT-7929: Error when setting EquippableComponent abbf57bac SPIGOT-7930: Fix spawning entities with SummonEntityEffect 92d6ab6cf PR-1497: Move boat field rename entries to below key renaming, so that keys are also renamed abfe292aa PR-1496: Use correct Fluid class on Tags type check c7aab7fa7 SPIGOT-7923: Fix Dispenser logic to avoid firing empty projectiles
57 lines
2.5 KiB
Diff
57 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 4297a893799fe39b80029b97f6b5581d543afa8a..b3b6cdf5491397e0e802ac91f5805d560ed5d88a 100644
|
|
--- a/src/main/java/org/bukkit/entity/Player.java
|
|
+++ b/src/main/java/org/bukkit/entity/Player.java
|
|
@@ -1947,6 +1947,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.
|