From ea9e27bfea7f1da0a9c27c2cb3adf9394618d72a Mon Sep 17 00:00:00 2001
From: Bukkit/Spigot <noreply+git-bukkit@papermc.io>
Date: Mon, 22 May 2017 18:51:55 +1000
Subject: [PATCH] SPIGOT-3259: Clarify JavaDoc regarding totalExperience

By: md_5 <git@md-5.net>
---
 .../src/main/java/org/bukkit/entity/Player.java      | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/paper-api/src/main/java/org/bukkit/entity/Player.java b/paper-api/src/main/java/org/bukkit/entity/Player.java
index a2ebcae180..92604ab306 100644
--- a/paper-api/src/main/java/org/bukkit/entity/Player.java
+++ b/paper-api/src/main/java/org/bukkit/entity/Player.java
@@ -798,16 +798,22 @@ public interface Player extends HumanEntity, Conversable, CommandSender, Offline
     public void setLevel(int level);
 
     /**
-     * Gets the players total experience points
+     * Gets the players total experience points.
+     * <br>
+     * This refers to the total amount of experience the player has collected
+     * over time and is only displayed as the player's "score" upon dying.
      *
      * @return Current total experience points
      */
     public int getTotalExperience();
 
     /**
-     * Sets the players current experience level
+     * Sets the players current experience points.
+     * <br>
+     * This refers to the total amount of experience the player has collected
+     * over time and is only displayed as the player's "score" upon dying.
      *
-     * @param exp New experience level
+     * @param exp New total experience points
      */
     public void setTotalExperience(int exp);