2012-03-29 20:24:41 +02:00
|
|
|
package com.gmail.nossr50.api;
|
|
|
|
|
|
|
|
import org.bukkit.entity.Player;
|
|
|
|
|
2013-02-03 12:45:19 +01:00
|
|
|
import com.gmail.nossr50.config.Config;
|
2013-01-30 17:53:51 +01:00
|
|
|
import com.gmail.nossr50.skills.utilities.SkillTools;
|
|
|
|
import com.gmail.nossr50.skills.utilities.SkillType;
|
2012-04-27 11:47:11 +02:00
|
|
|
import com.gmail.nossr50.util.Users;
|
2012-03-29 20:24:41 +02:00
|
|
|
|
2012-06-06 22:03:15 +02:00
|
|
|
public final class ExperienceAPI {
|
|
|
|
private ExperienceAPI() {}
|
2012-03-29 20:24:41 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Check the XP of a player. This should be called after giving XP to process level-ups.
|
|
|
|
*
|
|
|
|
* @param player The player to check
|
|
|
|
* @param skillType The skill to check
|
2013-02-03 12:45:19 +01:00
|
|
|
* @deprecated Calling this function is no longer needed and should be avoided
|
2012-03-29 20:24:41 +02:00
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
private static void checkXP(Player player, SkillType skillType) {
|
2012-03-29 20:24:41 +02:00
|
|
|
if (skillType.equals(SkillType.ALL)) {
|
2013-01-26 23:01:55 +01:00
|
|
|
SkillTools.xpCheckAll(player, Users.getProfile(player));
|
2012-03-29 20:24:41 +02:00
|
|
|
}
|
|
|
|
else {
|
2013-01-26 23:01:55 +01:00
|
|
|
SkillTools.xpCheckSkill(skillType, player, Users.getProfile(player));
|
2012-03-29 20:24:41 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2013-02-03 12:45:19 +01:00
|
|
|
* Adds raw XP to the player.
|
2012-03-29 20:24:41 +02:00
|
|
|
* </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
|
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
public static void addRawXP(Player player, SkillType skillType, int XP) {
|
2013-02-03 12:45:19 +01:00
|
|
|
Users.getPlayer(player).applyXpGain(skillType, XP);
|
2012-03-29 20:24:41 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2013-02-03 12:45:19 +01:00
|
|
|
* Adds XP to the player, calculates for XP Rate only.
|
2012-03-29 20:24:41 +02:00
|
|
|
* </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
|
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
public static void addMultipliedXP(Player player, SkillType skillType, int XP) {
|
2013-02-03 12:45:19 +01:00
|
|
|
Users.getPlayer(player).applyXpGain(skillType, (int) (XP * Config.getInstance().getExperienceGainsGlobalMultiplier()));
|
2012-03-29 20:24:41 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2013-02-03 12:45:19 +01:00
|
|
|
* Adds XP to the player, calculates for XP Rate, skill modifiers and perks. May be shared with the party.
|
2012-03-29 20:24:41 +02:00
|
|
|
* </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
|
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
public static void addXP(Player player, SkillType skillType, int XP) {
|
2013-02-03 12:45:19 +01:00
|
|
|
Users.getPlayer(player).beginXpGain(skillType, XP);
|
2012-03-29 20:24:41 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* 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
|
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
public static int getXP(Player player, SkillType skillType) {
|
2012-03-29 20:24:41 +02:00
|
|
|
return Users.getProfile(player).getSkillXpLevel(skillType);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the amount of XP left before leveling up.
|
|
|
|
* </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 left before leveling up a specifc skill
|
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
public static int getXPToNextLevel(Player player, SkillType skillType) {
|
2012-03-29 20:24:41 +02:00
|
|
|
return Users.getProfile(player).getXpToLevel(skillType);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Add levels to a skill.
|
|
|
|
* </br>
|
|
|
|
* This function is designed for API usage.
|
|
|
|
*
|
2012-03-29 22:13:43 +02:00
|
|
|
* @param player The player to add levels to
|
2012-03-29 20:24:41 +02:00
|
|
|
* @param skillType Type of skill to add levels to
|
|
|
|
* @param levels Number of levels to add
|
2013-02-03 12:45:19 +01:00
|
|
|
* @param notify Unused argument
|
|
|
|
* @deprecated Use addLevel(Player, SKillType, int) instead
|
2012-03-29 20:24:41 +02:00
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
public static void addLevel(Player player, SkillType skillType, int levels, boolean notify) {
|
2012-03-29 20:24:41 +02:00
|
|
|
Users.getProfile(player).addLevels(skillType, levels);
|
2012-03-30 07:01:48 +02:00
|
|
|
|
|
|
|
if (notify) {
|
|
|
|
checkXP(player, skillType);
|
|
|
|
}
|
2012-03-29 20:24:41 +02:00
|
|
|
}
|
|
|
|
|
2013-02-03 12:45:19 +01:00
|
|
|
/**
|
|
|
|
* 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
|
|
|
|
* @param notify True if this should fire a level up notification, false otherwise.
|
|
|
|
*/
|
|
|
|
public static void addLevel(Player player, SkillType skillType, int levels) {
|
|
|
|
Users.getProfile(player).addLevels(skillType, levels);
|
|
|
|
}
|
|
|
|
|
2012-03-29 20:24:41 +02:00
|
|
|
/**
|
|
|
|
* 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
|
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
public static int getLevel(Player player, SkillType skillType) {
|
2012-03-29 20:24:41 +02:00
|
|
|
return Users.getProfile(player).getSkillLevel(skillType);
|
|
|
|
}
|
2012-03-29 22:13:43 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* 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
|
|
|
|
*/
|
2012-06-06 22:03:15 +02:00
|
|
|
public static int getPowerLevel(Player player) {
|
2012-07-06 17:57:17 +02:00
|
|
|
return Users.getPlayer(player).getPowerLevel();
|
2012-03-29 22:13:43 +02:00
|
|
|
}
|
2012-06-26 14:02:31 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* 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
|
|
|
|
*/
|
|
|
|
public static void setLevel(Player player, SkillType skillType, int skillLevel) {
|
|
|
|
Users.getProfile(player).modifySkill(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
|
|
|
|
*/
|
|
|
|
public static void setXP(Player player, SkillType skillType, int newValue) {
|
2013-02-01 06:38:25 +01:00
|
|
|
Users.getProfile(player).setSkillXpLevel(skillType, newValue);
|
2012-06-26 14:02:31 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2012-06-26 14:03:19 +02:00
|
|
|
* Removes XP from a player in a specific skill type.
|
2012-06-26 14:02:31 +02:00
|
|
|
* </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
|
|
|
|
*/
|
|
|
|
public static void removeXP(Player player, SkillType skillType, int xp) {
|
2013-02-01 06:38:25 +01:00
|
|
|
Users.getProfile(player).removeXp(skillType, xp);
|
2012-06-26 14:02:31 +02:00
|
|
|
}
|
2012-03-29 20:24:41 +02:00
|
|
|
}
|