1 files changed, 56 insertions, 0 deletions
diff --git a/patches/api/0431-Add-experience-points-API.patch b/patches/api/0431-Add-experience-points-API.patch
new file mode 100644
index 0000000000..9b489a9ded
--- /dev/null
+++ b/patches/api/0431-Add-experience-points-API.patch
@@ -0,0 +1,56 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Lukas Planz <[email protected]>
+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.