mcMMO/src/main/java/com/gmail/nossr50/api/ExperienceAPI.java

//package com.gmail.nossr50.api;
//
//import com.gmail.nossr50.api.exceptions.*;
//import com.gmail.nossr50.datatypes.experience.FormulaType;
//import com.gmail.nossr50.datatypes.experience.XPGainReason;
//import com.gmail.nossr50.datatypes.experience.XPGainSource;
//import com.gmail.nossr50.datatypes.player.McMMOPlayer;
//import com.gmail.nossr50.datatypes.player.PlayerProfile;
//import com.gmail.nossr50.datatypes.skills.PrimarySkillType;
//import com.gmail.nossr50.mcMMO;
//import com.gmail.nossr50.skills.child.FamilyTree;
//import com.gmail.nossr50.util.player.UserManager;
//import org.bukkit.block.BlockState;
//import org.bukkit.entity.Player;
//
//import java.util.ArrayList;
//import java.util.Set;
//import java.util.UUID;
//
//public final class ExperienceAPI {
//    private ExperienceAPI() {
//    }
//
//    /**
//     * Returns whether given string is a valid type of skill suitable for the
//     * other API calls in this class.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param skillType A string that may or may not be a skill
//     * @return true if this is a valid mcMMO skill
//     */
//    public static boolean isValidSkillType(String skillType) {
//        return PrimarySkillType.getSkill(skillType) != null;
//    }
//
//    /**
//     * Grabs the XP multiplier for a player for this specific skill
//     * The multiplier will default to 1.0 and will be over written by any XP perks
//     *
//     * @param player           target player
//     * @param primarySkillType target skill
//     * @return this players personal XP rate for target PrimarySkillType
//     */
//    public double getPlayersPersonalXPRate(McMMOPlayer player, PrimarySkillType primarySkillType) {
//        //First check if the player has ANY of the custom perks
//        return player.getPlayerSpecificXPMult(primarySkillType);
//    }
//
//    /**
//     * Returns whether the given skill type string is both valid and not a
//     * child skill. (Child skills have no XP of their own, and their level is
//     * derived from the parent(s).)
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param skillType the skill to check
//     * @return true if this is a valid, non-child mcMMO skill
//     */
//    public static boolean isNonChildSkill(String skillType) {
//        PrimarySkillType skill = PrimarySkillType.getSkill(skillType);
//
//        return skill != null && !skill.isChildSkill();
//    }
//
//    @Deprecated
//    public static void addRawXP(Player player, String skillType, int XP) {
//        addRawXP(player, skillType, (double) XP);
//    }
//
//    /**
//     * Adds raw XP to the player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to add XP to
//     * @param skillType The skill to add XP to
//     * @param XP        The amount of XP to add
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    @Deprecated
//    public static void addRawXP(Player player, String skillType, double XP) {
//        addRawXP(player, skillType, XP, "UNKNOWN");
//    }
//
//    /**
//     * Adds raw XP to the player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player       The player to add XP to
//     * @param skillType    The skill to add XP to
//     * @param XP           The amount of XP to add
//     * @param xpGainReason The reason to gain XP
//     * @throws InvalidSkillException        if the given skill is not valid
//     * @throws InvalidXPGainReasonException if the given xpGainReason is not valid
//     */
//    public static void addRawXP(Player player, String skillType, double XP, String xpGainReason) {
//        addRawXP(player, skillType, XP, xpGainReason, false);
//    }
//
//    /**
//     * Adds raw XP to the player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player       The player to add XP to
//     * @param skillType    The skill to add XP to
//     * @param XP           The amount of XP to add
//     * @param xpGainReason The reason to gain XP
//     * @param isUnshared   true if the XP cannot be shared with party members
//     * @throws InvalidSkillException        if the given skill is not valid
//     * @throws InvalidXPGainReasonException if the given xpGainReason is not valid
//     */
//    public static void addRawXP(Player player, String skillType, double XP, String xpGainReason, boolean isUnshared) {
//        if (isUnshared) {
//            getPlayer(player).beginUnsharedXpGain(getSkillType(skillType), XP, getXPGainReason(xpGainReason), XPGainSource.CUSTOM);
//            return;
//        }
//
//        getPlayer(player).applyXpGain(getSkillType(skillType), XP, getXPGainReason(xpGainReason), XPGainSource.CUSTOM);
//    }
//
//    /**
//     * Adds raw XP to an offline player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @deprecated We're using double for our XP values now
//     * replaced by {@link #addRawXPOffline(String playerName, String skillType, double XP)}
//     */
//    @Deprecated
//    public static void addRawXPOffline(String playerName, String skillType, int XP) {
//        addRawXPOffline(playerName, skillType, (double) XP);
//    }
//
//    /**
//     * Adds raw XP to an offline player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to add XP to
//     * @param skillType  The skill to add XP to
//     * @param XP         The amount of XP to add
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     * @deprecated We're using uuids to get an offline player
//     * replaced by {@link #addRawXPOffline(UUID uuid, String skillType, double XP)}
//     */
//    @Deprecated
//    public static void addRawXPOffline(String playerName, String skillType, double XP) {
//        addOfflineXP(playerName, getSkillType(skillType), (int) Math.floor(XP));
//    }
//
//    /**
//     * Adds raw XP to an offline player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The UUID of player to add XP to
//     * @param skillType The skill to add XP to
//     * @param XP        The amount of XP to add
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    public static void addRawXPOffline(UUID uuid, String skillType, double XP) {
//        addOfflineXP(uuid, getSkillType(skillType), (int) Math.floor(XP));
//    }
//
//    /**
//     * Adds XP to the player, calculates for XP Rate only.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to add XP to
//     * @param skillType The skill to add XP to
//     * @param XP        The amount of XP to add
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    @Deprecated
//    public static void addMultipliedXP(Player player, String skillType, int XP) {
//        addMultipliedXP(player, skillType, XP, "UNKNOWN");
//    }
//
//    /**
//     * Adds XP to the player, calculates for XP Rate only.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player       The player to add XP to
//     * @param skillType    The skill to add XP to
//     * @param XP           The amount of XP to add
//     * @param xpGainReason The reason to gain XP
//     * @throws InvalidSkillException        if the given skill is not valid
//     * @throws InvalidXPGainReasonException if the given xpGainReason is not valid
//     */
//    public static void addMultipliedXP(Player player, String skillType, int XP, String xpGainReason) {
//        getPlayer(player).applyXpGain(getSkillType(skillType), (int) (XP * mcMMO.getDynamicSettingsManager().getExperienceManager().getGlobalXpMult()), getXPGainReason(xpGainReason), XPGainSource.CUSTOM);
//    }
//
//    /**
//     * Adds XP to an offline player, calculates for XP Rate only.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to add XP to
//     * @param skillType  The skill to add XP to
//     * @param XP         The amount of XP to add
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    @Deprecated
//    public static void addMultipliedXPOffline(String playerName, String skillType, int XP) {
//        addOfflineXP(playerName, getSkillType(skillType), (int) (XP * mcMMO.getDynamicSettingsManager().getExperienceManager().getGlobalXpMult()));
//    }
//
//    /**
//     * Adds XP to the player, calculates for XP Rate and skill modifier.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to add XP to
//     * @param skillType The skill to add XP to
//     * @param XP        The amount of XP to add
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    @Deprecated
//    public static void addModifiedXP(Player player, String skillType, int XP) {
//        addModifiedXP(player, skillType, XP, "UNKNOWN");
//    }
//
//    /**
//     * Adds XP to the player, calculates for XP Rate and skill modifier.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player       The player to add XP to
//     * @param skillType    The skill to add XP to
//     * @param XP           The amount of XP to add
//     * @param xpGainReason The reason to gain XP
//     * @throws InvalidSkillException        if the given skill is not valid
//     * @throws InvalidXPGainReasonException if the given xpGainReason is not valid
//     */
//    public static void addModifiedXP(Player player, String skillType, int XP, String xpGainReason) {
//        addModifiedXP(player, skillType, XP, xpGainReason, false);
//    }
//
//    /**
//     * Adds XP to the player, calculates for XP Rate and skill modifier.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player       The player to add XP to
//     * @param skillType    The skill to add XP to
//     * @param XP           The amount of XP to add
//     * @param xpGainReason The reason to gain XP
//     * @param isUnshared   true if the XP cannot be shared with party members
//     * @throws InvalidSkillException        if the given skill is not valid
//     * @throws InvalidXPGainReasonException if the given xpGainReason is not valid
//     */
//    public static void addModifiedXP(Player player, String skillType, int XP, String xpGainReason, boolean isUnshared) {
//        PrimarySkillType skill = getSkillType(skillType);
//
//        if (isUnshared) {
//            getPlayer(player).beginUnsharedXpGain(skill, (int) (XP / skill.getXpModifier() * mcMMO.getDynamicSettingsManager().getExperienceManager().getGlobalXpMult()), getXPGainReason(xpGainReason), XPGainSource.CUSTOM);
//            return;
//        }
//
//        getPlayer(player).applyXpGain(skill, (int) (XP / skill.getXpModifier() * mcMMO.getDynamicSettingsManager().getExperienceManager().getGlobalXpMult()), getXPGainReason(xpGainReason), XPGainSource.CUSTOM);
//    }
//
//    /**
//     * Adds XP to an offline player, calculates for XP Rate and skill modifier.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to add XP to
//     * @param skillType  The skill to add XP to
//     * @param XP         The amount of XP to add
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    @Deprecated
//    public static void addModifiedXPOffline(String playerName, String skillType, int XP) {
//        PrimarySkillType skill = getSkillType(skillType);
//
//        addOfflineXP(playerName, skill, (int) (XP / skill.getXpModifier() * mcMMO.getDynamicSettingsManager().getExperienceManager().getGlobalXpMult()));
//    }
//
//    /**
//     * Adds XP to the player, calculates for XP Rate, skill modifiers, perks, child skills,
//     * and party sharing.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to add XP to
//     * @param skillType The skill to add XP to
//     * @param XP        The amount of XP to add
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    @Deprecated
//    public static void addXP(Player player, String skillType, int XP) {
//        addXP(player, skillType, XP, "UNKNOWN");
//    }
//
//    /**
//     * Adds XP to the player, calculates for XP Rate, skill modifiers, perks, child skills,
//     * and party sharing.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player       The player to add XP to
//     * @param skillType    The skill to add XP to
//     * @param XP           The amount of XP to add
//     * @param xpGainReason The reason to gain XP
//     * @throws InvalidSkillException        if the given skill is not valid
//     * @throws InvalidXPGainReasonException if the given xpGainReason is not valid
//     */
//    public static void addXP(Player player, String skillType, int XP, String xpGainReason) {
//        addXP(player, skillType, XP, xpGainReason, false);
//    }
//
//    /**
//     * Adds XP to the player, calculates for XP Rate, skill modifiers, perks, child skills,
//     * and party sharing.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player       The player to add XP to
//     * @param skillType    The skill to add XP to
//     * @param XP           The amount of XP to add
//     * @param xpGainReason The reason to gain XP
//     * @param isUnshared   true if the XP cannot be shared with party members
//     * @throws InvalidSkillException        if the given skill is not valid
//     * @throws InvalidXPGainReasonException if the given xpGainReason is not valid
//     */
//    public static void addXP(Player player, String skillType, int XP, String xpGainReason, boolean isUnshared) {
//        if (isUnshared) {
//            getPlayer(player).beginUnsharedXpGain(getSkillType(skillType), XP, getXPGainReason(xpGainReason), XPGainSource.CUSTOM);
//            return;
//        }
//
//        getPlayer(player).beginXpGain(getSkillType(skillType), XP, getXPGainReason(xpGainReason), XPGainSource.CUSTOM);
//    }
//
//    /**
//     * Get the amount of XP a player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to get XP for
//     * @param skillType The skill to get XP for
//     * @return the amount of XP in a given skill
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static int getXP(Player player, String skillType) {
//        return getPlayer(player).getSkillXpLevel(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the amount of XP an offline player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to get XP for
//     * @param skillType  The skill to get XP for
//     * @return the amount of XP in a given skill
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    @Deprecated
//    public static int getOfflineXP(String playerName, String skillType) {
//        return getOfflineProfile(playerName).getSkillXpLevel(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the amount of XP an offline player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The player to get XP for
//     * @param skillType The skill to get XP for
//     * @return the amount of XP in a given skill
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static int getOfflineXP(UUID uuid, String skillType) {
//        return getOfflineProfile(uuid).getSkillXpLevel(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the raw amount of XP a player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to get XP for
//     * @param skillType The skill to get XP for
//     * @return the amount of XP in a given skill
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static double getXPRaw(Player player, String skillType) {
//        return getPlayer(player).getSkillXpLevelRaw(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the raw amount of XP an offline player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to get XP for
//     * @param skillType  The skill to get XP for
//     * @return the amount of XP in a given skill
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    @Deprecated
//    public static double getOfflineXPRaw(String playerName, String skillType) {
//        return getOfflineProfile(playerName).getSkillXpLevelRaw(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the raw amount of XP an offline player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The player to get XP for
//     * @param skillType The skill to get XP for
//     * @return the amount of XP in a given skill
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static double getOfflineXPRaw(UUID uuid, String skillType) {
//        return getOfflineProfile(uuid).getSkillXpLevelRaw(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the total amount of XP needed to reach the next level.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to get the XP amount for
//     * @param skillType The skill to get the XP amount for
//     * @return the total amount of XP needed to reach the next level
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static int getXPToNextLevel(Player player, String skillType) {
//        return getPlayer(player).getXpToLevel(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the total amount of XP an offline player needs to reach the next level.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to get XP for
//     * @param skillType  The skill to get XP for
//     * @return the total amount of XP needed to reach the next level
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    @Deprecated
//    public static int getOfflineXPToNextLevel(String playerName, String skillType) {
//        return getOfflineProfile(playerName).getXpToLevel(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the total amount of XP an offline player needs to reach the next level.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The player to get XP for
//     * @param skillType The skill to get XP for
//     * @return the total amount of XP needed to reach the next level
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static int getOfflineXPToNextLevel(UUID uuid, String skillType) {
//        return getOfflineProfile(uuid).getXpToLevel(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the amount of XP remaining until the next level.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to get the XP amount for
//     * @param skillType The skill to get the XP amount for
//     * @return the amount of XP remaining until the next level
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static int getXPRemaining(Player player, String skillType) {
//        PrimarySkillType skill = getNonChildSkillType(skillType);
//
//        PlayerProfile profile = getPlayer(player).getProfile();
//
//        return profile.getXpToLevel(skill) - profile.getSkillXpLevel(skill);
//    }
//
//    /**
//     * Get the amount of XP an offline player has left before leveling up.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to get XP for
//     * @param skillType  The skill to get XP for
//     * @return the amount of XP needed to reach the next level
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    @Deprecated
//    public static int getOfflineXPRemaining(String playerName, String skillType) {
//        PrimarySkillType skill = getNonChildSkillType(skillType);
//        PlayerProfile profile = getOfflineProfile(playerName);
//
//        return profile.getXpToLevel(skill) - profile.getSkillXpLevel(skill);
//    }
//
//    /**
//     * Get the amount of XP an offline player has left before leveling up.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The player to get XP for
//     * @param skillType The skill to get XP for
//     * @return the amount of XP needed to reach the next level
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static double getOfflineXPRemaining(UUID uuid, String skillType) {
//        PrimarySkillType skill = getNonChildSkillType(skillType);
//        PlayerProfile profile = getOfflineProfile(uuid);
//
//        return profile.getXpToLevel(skill) - profile.getSkillXpLevelRaw(skill);
//    }
//
//    /**
//     * Add levels to a skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to add levels to
//     * @param skillType Type of skill to add levels to
//     * @param levels    Number of levels to add
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    public static void addLevel(Player player, String skillType, int levels) {
//        getPlayer(player).addLevels(getSkillType(skillType), levels);
//    }
//
//    /**
//     * Add levels to a skill for an offline player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to add levels to
//     * @param skillType  Type of skill to add levels to
//     * @param levels     Number of levels to add
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    @Deprecated
//    public static void addLevelOffline(String playerName, String skillType, int levels) {
//        PlayerProfile profile = getOfflineProfile(playerName);
//        PrimarySkillType skill = getSkillType(skillType);
//
//        if (skill.isChildSkill()) {
//            Set<PrimarySkillType> parentSkills = FamilyTree.getParents(skill);
//
//            for (PrimarySkillType parentSkill : parentSkills) {
//                profile.addLevels(parentSkill, (levels / parentSkills.size()));
//            }
//
//            profile.scheduleAsyncSave();
//            return;
//        }
//
//        profile.addLevels(skill, levels);
//        profile.scheduleAsyncSave();
//    }
//
//    /**
//     * Add levels to a skill for an offline player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The player to add levels to
//     * @param skillType Type of skill to add levels to
//     * @param levels    Number of levels to add
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    public static void addLevelOffline(UUID uuid, String skillType, int levels) {
//        PlayerProfile profile = getOfflineProfile(uuid);
//        PrimarySkillType skill = getSkillType(skillType);
//
//        if (skill.isChildSkill()) {
//            Set<PrimarySkillType> parentSkills = FamilyTree.getParents(skill);
//
//            for (PrimarySkillType parentSkill : parentSkills) {
//                profile.addLevels(parentSkill, (levels / parentSkills.size()));
//            }
//
//            profile.scheduleAsyncSave();
//            return;
//        }
//
//        profile.addLevels(skill, levels);
//        profile.scheduleAsyncSave();
//    }
//
//    /**
//     * Get the level a player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to get the level for
//     * @param skillType The skill to get the level for
//     * @return the level of a given skill
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    @Deprecated
//    public static int getLevel(Player player, String skillType) {
//        return getPlayer(player).getSkillLevel(getSkillType(skillType));
//    }
//
//    /**
//     * Get the level a player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player The player to get the level for
//     * @param skillType The skill to get the level for
//     * @return the level of a given skill
//     *
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    public static int getLevel(Player player, PrimarySkillType skillType) {
//        return getPlayer(player).getSkillLevel(skillType);
//    }
//
//    /**
//     * Get the level an offline player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to get the level for
//     * @param skillType  The skill to get the level for
//     * @return the level of a given skill
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    @Deprecated
//    public static int getLevelOffline(String playerName, String skillType) {
//        return getOfflineProfile(playerName).getSkillLevel(getSkillType(skillType));
//    }
//
//    /**
//     * Get the level an offline player has in a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The player to get the level for
//     * @param skillType The skill to get the level for
//     * @return the level of a given skill
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    public static int getLevelOffline(UUID uuid, String skillType) {
//        return getOfflineProfile(uuid).getSkillLevel(getSkillType(skillType));
//    }
//
//    /**
//     * Gets the power level of a player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player The player to get the power level for
//     * @return the power level of the player
//     */
//    public static int getPowerLevel(Player player) {
//        return getPlayer(player).getPowerLevel();
//    }
//
//    /**
//     * Gets the power level of an offline player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to get the power level for
//     * @return the power level of the player
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    @Deprecated
//    public static int getPowerLevelOffline(String playerName) {
//        int powerLevel = 0;
//        PlayerProfile profile = getOfflineProfile(playerName);
//
//        for (PrimarySkillType type : pluginRef.getSkillTools().NON_CHILD_SKILLS) {
//            powerLevel += profile.getSkillLevel(type);
//        }
//
//        return powerLevel;
//    }
//
//    /**
//     * Gets the power level of an offline player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid The player to get the power level for
//     * @return the power level of the player
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    public static int getPowerLevelOffline(UUID uuid) {
//        int powerLevel = 0;
//        PlayerProfile profile = getOfflineProfile(uuid);
//
//        for (PrimarySkillType type : pluginRef.getSkillTools().NON_CHILD_SKILLS) {
//            powerLevel += profile.getSkillLevel(type);
//        }
//
//        return powerLevel;
//    }
//
//    /**
//     * Get the level cap of a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param skillType The skill to get the level cap for
//     * @return the level cap of a given skill
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    public static int getLevelCap(String skillType) {
//        return mcMMO.getPlayerLevelingSettings().getSkillLevelCap(getSkillType(skillType));
//    }
//
//    /**
//     * Get the level cap of a specific skill.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param skillType The skill to get the level cap for
//     * @return the level cap of a given skill
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    public static int getLevelCap(PrimarySkillType skillType) {
//        return mcMMO.getPlayerLevelingSettings().getSkillLevelCap(skillType);
//    }
//
//    /**
//     * Checks whether or not a specific skill is level capped
//     *
//     * @param skillType target skill
//     * @return true if the skill has a level cap
//     */
//    public static boolean isSkillLevelCapped(PrimarySkillType skillType) {
//        return mcMMO.getPlayerLevelingSettings().isSkillLevelCapEnabled(skillType);
//    }
//
//    /**
//     * Get the power level cap.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @return the overall power level cap
//     */
//    public static int getPowerLevelCap() {
//        return mcMMO.getPlayerLevelingSettings().getConfigSectionLevelCaps().getPowerLevelSettings().getLevelCap();
//    }
//
//    /**
//     * Get the position on the leaderboard of a player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The name of the player to check
//     * @param skillType  The skill to check
//     * @return the position on the leaderboard
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    @Deprecated
//    public static int getPlayerRankSkill(String playerName, String skillType) {
//        return mcMMO.getDatabaseManager().readRank(mcMMO.p.getServer().getOfflinePlayer(playerName).getName()).get(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the position on the leaderboard of a player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The name of the player to check
//     * @param skillType The skill to check
//     * @return the position on the leaderboard
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static int getPlayerRankSkill(UUID uuid, String skillType) {
//        return mcMMO.getDatabaseManager().readRank(mcMMO.p.getServer().getOfflinePlayer(uuid).getName()).get(getNonChildSkillType(skillType));
//    }
//
//    /**
//     * Get the position on the power level leaderboard of a player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The name of the player to check
//     * @return the position on the power level leaderboard
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    @Deprecated
//    public static int getPlayerRankOverall(String playerName) {
//        return mcMMO.getDatabaseManager().readRank(mcMMO.p.getServer().getOfflinePlayer(playerName).getName()).get(null);
//    }
//
//    /**
//     * Get the position on the power level leaderboard of a player.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid The name of the player to check
//     * @return the position on the power level leaderboard
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    public static int getPlayerRankOverall(UUID uuid) {
//        return mcMMO.getDatabaseManager().readRank(mcMMO.p.getServer().getOfflinePlayer(uuid).getName()).get(null);
//    }
//
//    /**
//     * Sets the level of a player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player     The player to set the level of
//     * @param skillType  The skill to set the level for
//     * @param skillLevel The value to set the level to
//     * @throws InvalidSkillException if the given skill is not valid
//     */
//    public static void setLevel(Player player, String skillType, int skillLevel) {
//        getPlayer(player).modifySkill(getSkillType(skillType), skillLevel);
//    }
//
//    /**
//     * Sets the level of an offline player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to set the level of
//     * @param skillType  The skill to set the level for
//     * @param skillLevel The value to set the level to
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    @Deprecated
//    public static void setLevelOffline(String playerName, String skillType, int skillLevel) {
//        getOfflineProfile(playerName).modifySkill(getSkillType(skillType), skillLevel);
//    }
//
//    /**
//     * Sets the level of an offline player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid       The player to set the level of
//     * @param skillType  The skill to set the level for
//     * @param skillLevel The value to set the level to
//     * @throws InvalidSkillException  if the given skill is not valid
//     * @throws InvalidPlayerException if the given player does not exist in the database
//     */
//    public static void setLevelOffline(UUID uuid, String skillType, int skillLevel) {
//        getOfflineProfile(uuid).modifySkill(getSkillType(skillType), skillLevel);
//    }
//
//    /**
//     * Sets the XP of a player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to set the XP of
//     * @param skillType The skill to set the XP for
//     * @param newValue  The value to set the XP to
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static void setXP(Player player, String skillType, int newValue) {
//        getPlayer(player).setSkillXpLevel(getNonChildSkillType(skillType), newValue);
//    }
//
//    /**
//     * Sets the XP of an offline player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to set the XP of
//     * @param skillType  The skill to set the XP for
//     * @param newValue   The value to set the XP to
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    @Deprecated
//    public static void setXPOffline(String playerName, String skillType, int newValue) {
//        getOfflineProfile(playerName).setSkillXpLevel(getNonChildSkillType(skillType), newValue);
//    }
//
//    /**
//     * Sets the XP of an offline player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The player to set the XP of
//     * @param skillType The skill to set the XP for
//     * @param newValue  The value to set the XP to
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static void setXPOffline(UUID uuid, String skillType, int newValue) {
//        getOfflineProfile(uuid).setSkillXpLevel(getNonChildSkillType(skillType), newValue);
//    }
//
//    /**
//     * Removes XP from a player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param player    The player to change the XP of
//     * @param skillType The skill to change the XP for
//     * @param xp        The amount of XP to remove
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static void removeXP(Player player, String skillType, int xp) {
//        getPlayer(player).removeXp(getNonChildSkillType(skillType), xp);
//    }
//
//    /**
//     * Removes XP from an offline player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param playerName The player to change the XP of
//     * @param skillType  The skill to change the XP for
//     * @param xp         The amount of XP to remove
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    @Deprecated
//    public static void removeXPOffline(String playerName, String skillType, int xp) {
//        getOfflineProfile(playerName).removeXp(getNonChildSkillType(skillType), xp);
//    }
//
//    /**
//     * Removes XP from an offline player in a specific skill type.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param uuid      The player to change the XP of
//     * @param skillType The skill to change the XP for
//     * @param xp        The amount of XP to remove
//     * @throws InvalidSkillException         if the given skill is not valid
//     * @throws InvalidPlayerException        if the given player does not exist in the database
//     * @throws UnsupportedOperationException if the given skill is a child skill
//     */
//    public static void removeXPOffline(UUID uuid, String skillType, int xp) {
//        getOfflineProfile(uuid).removeXp(getNonChildSkillType(skillType), xp);
//    }
//
//    /**
//     * Check how much XP is needed for a specific level with the selected level curve.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param level The level to get the amount of XP for
//     * @throws InvalidFormulaTypeException if the given formulaType is not valid
//     */
//    public static int getXpNeededToLevel(int level) {
//        return mcMMO.getFormulaManager().getXPtoNextLevel(level, mcMMO.getConfigManager().getConfigLeveling().getFormulaType());
//    }
//
//    /**
//     * Check how much XP is needed for a specific level with the provided level curve.
//     * </br>
//     * This function is designed for API usage.
//     *
//     * @param level       The level to get the amount of XP for
//     * @param formulaType The formula type to get the amount of XP for
//     * @throws InvalidFormulaTypeException if the given formulaType is not valid
//     * @deprecated Discouraged - Most the time you do not want to provide the formula type yourself, use the other method
//     */
//    public static int getXpNeededToLevel(int level, FormulaType formulaType) {
//        return mcMMO.getFormulaManager().getXPtoNextLevel(level, formulaType);
//    }
//
//    /**
//     * Will add the appropriate type of XP from the block to the player based on the material of the blocks given
//     *
//     * @param blockStates the blocks to reward XP for
//     * @param mcMMOPlayer the target player
//     */
//    public static void addXpFromBlocks(ArrayList<BlockState> blockStates, McMMOPlayer mcMMOPlayer) {
//        for (BlockState bs : blockStates) {
//            for (PrimarySkillType skillType : PrimarySkillType.values()) {
//                if (mcMMO.getDynamicSettingsManager().getExperienceManager().getBlockBreakXpValue(skillType, bs.getType()) > 0) {
//                    mcMMOPlayer.applyXpGain(skillType, mcMMO.getDynamicSettingsManager().getExperienceManager().getBlockBreakXpValue(skillType, bs.getType()), XPGainReason.PVE, XPGainSource.SELF);
//                }
//            }
//        }
//    }
//
//    /**
//     * Will add the appropriate type of XP from the block to the player based on the material of the blocks given if it matches the given skillType
//     *
//     * @param blockStates the blocks to reward XP for
//     * @param mcMMOPlayer the target player
//     * @param skillType   target primary skill
//     */
//    public static void addXpFromBlocksBySkill(ArrayList<BlockState> blockStates, McMMOPlayer mcMMOPlayer, PrimarySkillType skillType) {
//        for (BlockState bs : blockStates) {
//            if (mcMMO.getDynamicSettingsManager().getExperienceManager().getBlockBreakXpValue(skillType, bs.getType()) > 0) {
//                mcMMOPlayer.applyXpGain(skillType, mcMMO.getDynamicSettingsManager().getExperienceManager().getBlockBreakXpValue(skillType, bs.getType()), XPGainReason.PVE, XPGainSource.SELF);
//            }
//        }
//    }
//
//    /**
//     * Will add the appropriate type of XP from the block to the player based on the material of the blocks given
//     *
//     * @param blockState  The target blockstate
//     * @param mcMMOPlayer The target player
//     */
//    public static void addXpFromBlock(BlockState blockState, McMMOPlayer mcMMOPlayer) {
//        for (PrimarySkillType skillType : PrimarySkillType.values()) {
//            if (mcMMO.getDynamicSettingsManager().getExperienceManager().getBlockBreakXpValue(skillType, blockState.getType()) > 0) {
//                mcMMOPlayer.applyXpGain(skillType, mcMMO.getDynamicSettingsManager().getExperienceManager().getBlockBreakXpValue(skillType, blockState.getType()), XPGainReason.PVE, XPGainSource.SELF);
//            }
//        }
//    }
//
//    /**
//     * Will add the appropriate type of XP from the block to the player based on the material of the blocks given if it matches the given skillType
//     *
//     * @param blockState  The target blockstate
//     * @param mcMMOPlayer The target player
//     * @param skillType   target primary skill
//     */
//    public static void addXpFromBlockBySkill(BlockState blockState, McMMOPlayer mcMMOPlayer, PrimarySkillType skillType) {
//        if (mcMMO.getDynamicSettingsManager().getExperienceManager().getBlockBreakXpValue(skillType, blockState.getType()) > 0) {
//            mcMMOPlayer.applyXpGain(skillType, mcMMO.getDynamicSettingsManager().getExperienceManager().getBlockBreakXpValue(skillType, blockState.getType()), XPGainReason.PVE, XPGainSource.SELF);
//        }
//    }
//
//
//    // Utility methods follow.
//    private static void addOfflineXP(UUID playerUniqueId, PrimarySkillType skill, int XP) {
//        PlayerProfile profile = getOfflineProfile(playerUniqueId);
//
//        profile.addXp(skill, XP);
//        profile.save(true);
//    }
//
//    @Deprecated
//    private static void addOfflineXP(String playerName, PrimarySkillType skill, int XP) {
//        PlayerProfile profile = getOfflineProfile(playerName);
//
//        profile.addXp(skill, XP);
//        profile.scheduleAsyncSave();
//    }
//
//    private static PlayerProfile getOfflineProfile(UUID uuid) {
//        PlayerProfile profile = mcMMO.getDatabaseManager().loadPlayerProfile(uuid);
//
//        if (!profile.isLoaded()) {
//            throw new InvalidPlayerException();
//        }
//
//        return profile;
//    }
//
//    @Deprecated
//    private static PlayerProfile getOfflineProfile(String playerName) {
//        UUID uuid = mcMMO.p.getServer().getOfflinePlayer(playerName).getUniqueId();
//        PlayerProfile profile = mcMMO.getDatabaseManager().loadPlayerProfile(uuid);
//
//        if (!profile.isLoaded()) {
//            throw new InvalidPlayerException();
//        }
//
//        return profile;
//    }
//
//    private static PrimarySkillType getSkillType(String skillType) throws InvalidSkillException {
//        PrimarySkillType skill = PrimarySkillType.getSkill(skillType);
//
//        if (skill == null) {
//            throw new InvalidSkillException(skillType);
//        }
//
//        return skill;
//    }
//
//    private static PrimarySkillType getNonChildSkillType(String skillType) throws InvalidSkillException, UnsupportedOperationException {
//        PrimarySkillType skill = getSkillType(skillType);
//
//        if (skill.isChildSkill()) {
//            throw new UnsupportedOperationException("Child skills do not have XP");
//        }
//
//        return skill;
//    }
//
//    private static XPGainReason getXPGainReason(String reason) throws InvalidXPGainReasonException {
//        XPGainReason xpGainReason = XPGainReason.getXPGainReason(reason);
//
//        if (xpGainReason == null) {
//            throw new InvalidXPGainReasonException();
//        }
//
//        return xpGainReason;
//    }
//
//    /**
//     * @param player target player
//     * @return McMMOPlayer for that player if the profile is loaded, otherwise null
//     * @throws McMMOPlayerNotFoundException
//     * @deprecated Use UserManager::getPlayer(Player player) instead
//     */
//    @Deprecated
//    private static McMMOPlayer getPlayer(Player player) throws McMMOPlayerNotFoundException {
//        if (!pluginRef.getUserManager().hasPlayerDataKey(player)) {
//            throw new McMMOPlayerNotFoundException(player);
//        }
//
//        return pluginRef.getUserManager().getPlayer(player);
//    }
//}