mirror of
https://github.com/mcMMO-Dev/mcMMO.git
synced 2025-03-30 08:16:25 +02:00
2594dc1bca
General Added Crossbows Skill, this skill is a WIP and feedback on discord is appreciated. Added Tridents Skill, this skill is a WIP and feedback on discord is appreciated. Added the "endgame" triple drop subskill 'Mother Lode' to Mining Added the "endgame" triple drop subskill 'Clean Cuts' to Woodcutting Added the "endgame" triple drop subskill 'Verdant Bounty' to Herbalism Added /mmopower command which simply shows your power level (aliases /mmopowerlevel /powerlevel) Config Added 'Send_To_Console' settings to chat.yml to toggle sending party or admin chat messages to console. Replaced 'Experience_Formula.Modifier' in experience.yml with 'Experience_Formula.Skill_Multiplier' which is easier to understand and less prone to divide by zero bugs. child.yml config is gone now, feel free to delete it. Tweaks Tree Feller now drops 90% less non-wood block rewards (leaves/etc) on average from Knock on Wood. Treasure drop rate from Shake, Fishing, Hylian, and Excavation now benefit from the Luck perk. Updated advanced.yml with entries for the new skills Permission nodes Added 'mcmmo.commands.mmopower' permission node for the new /mmopower command Added 'mcmmo.commands.crossbows' permission node Added 'mcmmo.ability.crossbows.crossbowslimitbreak' permission node Added 'mcmmo.ability.crossbows.trickshot' permission node Added 'mcmmo.ability.herbalism.verdantbounty' permission node Added 'mcmmo.ability.mining.motherlode' permission node Added 'mcmmo.ability.woodcutting.cleancuts' permission node Locale Added locale entries for motherlode, cleancuts, and verdant bounty. Codebase Major rewrite for how random chance was handled in the code. Many skills with RNG elements now send out a SubSkillEvent (which can be used to modify probability or cancel the results), some skills without RNG still send out this event when activated, this event is cancellable so it can be used to make a skill fail. A lot of new unit tests were added to help keep mcMMO stable as part of this update, of course, more could always be added. NOTES: One feature of this update is to provide an endgame benefits to some skills that you can grind for a long time, ideally for a long while. I will likely expand upon this idea in future updates. A few skills have these endgame-oriented subskills, these new subskills provide a small benefit at first that grows and scales up to level 10,000 (or 1,000 for Standard mode which no one uses) and does not have ranks (other than the initial rank to unlock it). These endgame sub skills unlock at level 1000 for users with default mcMMO settings, or 100 for those using the optional Standard scaling. You can tweak the benefits of these skills in advanced.yml, the default settings are meant to be a good starting point. Crossbows and Tridents are WIP skills, I would like feedback on discord about them. More info on the new Triple Drop skills (Mother Lode, Clean Cuts, Verdant Bounty): Currently these start at about 5% chance and can reach a maximum 50% chance if a player acquired 10,000 skill, you can adjust this in advanced.yml These skills respect double drop settings from config.yml just like the corresponding Double Drop skills do, if a double drop is disabled for an item, then it's disabled for triple drops too. I added a new Power Level Command, for now this just shows you your current power level. If I ever add features based on power level, this command will likely display output related to those features. Regarding Maces, I will likely add that as a WIP skill when the next Minecraft update drops.
1307 lines
50 KiB
Java
1307 lines
50 KiB
Java
package com.gmail.nossr50.api;
|
|
|
|
import com.gmail.nossr50.api.exceptions.*;
|
|
import com.gmail.nossr50.config.experience.ExperienceConfig;
|
|
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.util.player.UserManager;
|
|
import com.gmail.nossr50.util.skills.CombatUtils;
|
|
import com.gmail.nossr50.util.skills.SkillTools;
|
|
import org.bukkit.OfflinePlayer;
|
|
import org.bukkit.block.BlockState;
|
|
import org.bukkit.entity.LivingEntity;
|
|
import org.bukkit.entity.Player;
|
|
import org.jetbrains.annotations.NotNull;
|
|
|
|
import java.util.ArrayList;
|
|
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(@NotNull String skillType) {
|
|
return mcMMO.p.getSkillTools().matchSkill(skillType) != null;
|
|
}
|
|
|
|
/**
|
|
* Start the task that gives combat XP.
|
|
* Processes combat XP like mcMMO normally would, so mcMMO will check whether the entity should reward XP when giving out the XP
|
|
*
|
|
* @param mcMMOPlayer The attacking player
|
|
* @param target The defending entity
|
|
* @param primarySkillType The skill being used
|
|
* @param multiplier final XP result will be multiplied by this
|
|
* @deprecated Draft API
|
|
*/
|
|
@Deprecated
|
|
public static void addCombatXP(McMMOPlayer mcMMOPlayer, LivingEntity target, PrimarySkillType primarySkillType, double multiplier) {
|
|
CombatUtils.processCombatXP(mcMMOPlayer, target, primarySkillType, multiplier);
|
|
}
|
|
|
|
/**
|
|
* Start the task that gives combat XP.
|
|
* Processes combat XP like mcMMO normally would, so mcMMO will check whether the entity should reward XP when giving out the XP
|
|
*
|
|
* @param mcMMOPlayer The attacking player
|
|
* @param target The defending entity
|
|
* @param primarySkillType The skill being used
|
|
* @deprecated Draft API
|
|
*/
|
|
@Deprecated
|
|
public static void addCombatXP(McMMOPlayer mcMMOPlayer, LivingEntity target, PrimarySkillType primarySkillType) {
|
|
CombatUtils.processCombatXP(mcMMOPlayer, target, 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 = mcMMO.p.getSkillTools().matchSkill(skillType);
|
|
|
|
return skill != null && !SkillTools.isChildSkill(skill);
|
|
}
|
|
|
|
@Deprecated
|
|
public static void addRawXP(Player player, String skillType, int XP) {
|
|
addRawXP(player, skillType, (float) 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, float 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, float 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, float 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 float for our XP values now
|
|
* replaced by {@link #addRawXPOffline(String playerName, String skillType, float XP)}
|
|
*/
|
|
@Deprecated
|
|
public static void addRawXPOffline(String playerName, String skillType, int XP) {
|
|
addRawXPOffline(playerName, skillType, (float) XP);
|
|
}
|
|
|
|
/**
|
|
* Adds raw XP to an offline player.
|
|
* </br>
|
|
* This function is designed for API usage.
|
|
*
|
|
* @deprecated We're using uuids to get an offline player
|
|
* replaced by {@link #addRawXPOffline(UUID uuid, String skillType, float XP)}
|
|
*
|
|
* @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 addRawXPOffline(String playerName, String skillType, float 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, float 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 * ExperienceConfig.getInstance().getExperienceGainsGlobalMultiplier()), 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 * ExperienceConfig.getInstance().getExperienceGainsGlobalMultiplier()));
|
|
}
|
|
|
|
/**
|
|
* 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 / ExperienceConfig.getInstance().getFormulaSkillModifier(skill) * ExperienceConfig.getInstance().getExperienceGainsGlobalMultiplier()), getXPGainReason(xpGainReason), XPGainSource.CUSTOM);
|
|
return;
|
|
}
|
|
|
|
getPlayer(player).applyXpGain(skill, (int) (XP / ExperienceConfig.getInstance().getFormulaSkillModifier(skill) * ExperienceConfig.getInstance().getExperienceGainsGlobalMultiplier()), 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 / ExperienceConfig.getInstance().getFormulaSkillModifier(skill) * ExperienceConfig.getInstance().getExperienceGainsGlobalMultiplier()));
|
|
}
|
|
|
|
/**
|
|
* 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 amount of XP an offline player has in a specific skill.
|
|
* </br>
|
|
* This function is designed for API usage.
|
|
*
|
|
* @param offlinePlayer 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(@NotNull OfflinePlayer offlinePlayer, @NotNull String skillType) throws InvalidPlayerException {
|
|
return getOfflineProfile(offlinePlayer).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 float 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 float 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 float getOfflineXPRaw(UUID uuid, String skillType) {
|
|
return getOfflineProfile(uuid).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 offlinePlayer 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 float getOfflineXPRaw(@NotNull OfflinePlayer offlinePlayer, @NotNull String skillType) throws InvalidPlayerException, UnsupportedOperationException, InvalidSkillException {
|
|
return getOfflineProfile(offlinePlayer).getSkillXpLevelRaw(getNonChildSkillType(skillType));
|
|
}
|
|
|
|
public static float getOfflineXPRaw(@NotNull OfflinePlayer offlinePlayer, @NotNull PrimarySkillType skillType) throws InvalidPlayerException, UnsupportedOperationException {
|
|
if(SkillTools.isChildSkill(skillType))
|
|
throw new UnsupportedOperationException();
|
|
|
|
return getOfflineProfile(offlinePlayer).getSkillXpLevelRaw(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(@NotNull UUID uuid, @NotNull String skillType) {
|
|
return getOfflineProfile(uuid).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 offlinePlayer 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(@NotNull OfflinePlayer offlinePlayer, @NotNull String skillType) throws UnsupportedOperationException, InvalidSkillException, InvalidPlayerException {
|
|
return getOfflineProfile(offlinePlayer).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 float getOfflineXPRemaining(UUID uuid, String skillType) {
|
|
PrimarySkillType skill = getNonChildSkillType(skillType);
|
|
PlayerProfile profile = getOfflineProfile(uuid);
|
|
|
|
return profile.getXpToLevel(skill) - profile.getSkillXpLevelRaw(skill);
|
|
}
|
|
|
|
/**
|
|
* Get the amount of XP an offline player has left before leveling up.
|
|
* </br>
|
|
* This function is designed for API usage.
|
|
*
|
|
* @param offlinePlayer 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 float getOfflineXPRemaining(OfflinePlayer offlinePlayer, String skillType) throws InvalidSkillException, InvalidPlayerException, UnsupportedOperationException {
|
|
PrimarySkillType skill = getNonChildSkillType(skillType);
|
|
PlayerProfile profile = getOfflineProfile(offlinePlayer);
|
|
|
|
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 (SkillTools.isChildSkill(skill)) {
|
|
var parentSkills = mcMMO.p.getSkillTools().getChildSkillParents(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 (SkillTools.isChildSkill(skill)) {
|
|
var parentSkills = mcMMO.p.getSkillTools().getChildSkillParents(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 Use getLevel(Player player, PrimarySkillType skillType) instead
|
|
*/
|
|
@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
|
|
*/
|
|
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 : SkillTools.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 : SkillTools.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.p.getSkillTools().getLevelCap(getSkillType(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.p.getGeneralConfig().getPowerLevelCap();
|
|
}
|
|
|
|
/**
|
|
* 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
|
|
*
|
|
* @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
|
|
*
|
|
* @return the position on the leaderboard
|
|
*/
|
|
@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
|
|
*
|
|
* @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
|
|
*
|
|
* @return the position on the leaderboard
|
|
*/
|
|
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
|
|
*
|
|
* @throws InvalidPlayerException if the given player does not exist in the database
|
|
*
|
|
* @return the position on the power level leaderboard
|
|
*/
|
|
@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
|
|
*
|
|
* @throws InvalidPlayerException if the given player does not exist in the database
|
|
*
|
|
* @return the position on the power level leaderboard
|
|
*/
|
|
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, ExperienceConfig.getInstance().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
|
|
*/
|
|
public static int getXpNeededToLevel(int level, String formulaType) {
|
|
return mcMMO.getFormulaManager().getXPtoNextLevel(level, getFormulaType(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(ExperienceConfig.getInstance().getXp(skillType, bs.getType()) > 0)
|
|
{
|
|
mcMMOPlayer.applyXpGain(skillType, ExperienceConfig.getInstance().getXp(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(ExperienceConfig.getInstance().getXp(skillType, bs.getType()) > 0)
|
|
{
|
|
mcMMOPlayer.applyXpGain(skillType, ExperienceConfig.getInstance().getXp(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(ExperienceConfig.getInstance().getXp(skillType, blockState.getType()) > 0)
|
|
{
|
|
mcMMOPlayer.applyXpGain(skillType, ExperienceConfig.getInstance().getXp(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(ExperienceConfig.getInstance().getXp(skillType, blockState.getType()) > 0)
|
|
{
|
|
mcMMOPlayer.applyXpGain(skillType, ExperienceConfig.getInstance().getXp(skillType, blockState.getType()), XPGainReason.PVE, XPGainSource.SELF);
|
|
}
|
|
}
|
|
|
|
// Utility methods follow.
|
|
private static void addOfflineXP(@NotNull UUID playerUniqueId, @NotNull PrimarySkillType skill, int XP) {
|
|
PlayerProfile profile = getOfflineProfile(playerUniqueId);
|
|
|
|
profile.addXp(skill, XP);
|
|
profile.save(true);
|
|
}
|
|
|
|
private static void addOfflineXP(@NotNull String playerName, @NotNull PrimarySkillType skill, int XP) {
|
|
PlayerProfile profile = getOfflineProfile(playerName);
|
|
|
|
profile.addXp(skill, XP);
|
|
profile.scheduleAsyncSave();
|
|
}
|
|
|
|
private static @NotNull PlayerProfile getOfflineProfile(@NotNull UUID uuid) throws InvalidPlayerException {
|
|
PlayerProfile profile = mcMMO.getDatabaseManager().loadPlayerProfile(uuid);
|
|
|
|
if (!profile.isLoaded()) {
|
|
throw new InvalidPlayerException();
|
|
}
|
|
|
|
return profile;
|
|
}
|
|
|
|
private static @NotNull PlayerProfile getOfflineProfile(@NotNull OfflinePlayer offlinePlayer) throws InvalidPlayerException {
|
|
PlayerProfile profile = mcMMO.getDatabaseManager().loadPlayerProfile(offlinePlayer);
|
|
|
|
if (!profile.isLoaded()) {
|
|
throw new InvalidPlayerException();
|
|
}
|
|
|
|
return profile;
|
|
}
|
|
|
|
private static @NotNull PlayerProfile getOfflineProfile(@NotNull String playerName) throws InvalidPlayerException {
|
|
PlayerProfile profile = mcMMO.getDatabaseManager().loadPlayerProfile(playerName);
|
|
|
|
if (!profile.isLoaded()) {
|
|
throw new InvalidPlayerException();
|
|
}
|
|
|
|
return profile;
|
|
}
|
|
|
|
private static PrimarySkillType getSkillType(String skillType) throws InvalidSkillException {
|
|
PrimarySkillType skill = mcMMO.p.getSkillTools().matchSkill(skillType);
|
|
|
|
if (skill == null) {
|
|
throw new InvalidSkillException();
|
|
}
|
|
|
|
return skill;
|
|
}
|
|
|
|
private static PrimarySkillType getNonChildSkillType(String skillType) throws InvalidSkillException, UnsupportedOperationException {
|
|
PrimarySkillType skill = getSkillType(skillType);
|
|
|
|
if (SkillTools.isChildSkill(skill)) {
|
|
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;
|
|
}
|
|
|
|
private static FormulaType getFormulaType(String formula) throws InvalidFormulaTypeException {
|
|
FormulaType formulaType = FormulaType.getFormulaType(formula);
|
|
|
|
if (formulaType == null) {
|
|
throw new InvalidFormulaTypeException();
|
|
}
|
|
|
|
return formulaType;
|
|
}
|
|
|
|
/**
|
|
* @deprecated Use UserManager::getPlayer(Player player) instead
|
|
* @param player target player
|
|
* @return McMMOPlayer for that player if the profile is loaded, otherwise null
|
|
* @throws McMMOPlayerNotFoundException
|
|
*/
|
|
@Deprecated
|
|
private static McMMOPlayer getPlayer(Player player) throws McMMOPlayerNotFoundException {
|
|
if (!UserManager.hasPlayerDataKey(player)) {
|
|
throw new McMMOPlayerNotFoundException(player);
|
|
}
|
|
|
|
return UserManager.getPlayer(player);
|
|
}
|
|
}
|