eu.wauz.wauzcore.skills

Class SkillUtils

java.lang.Object

eu.wauz.wauzcore.skills.SkillUtils

public class SkillUtils
extends java.lang.Object

An util class for working with skill and weapon meachanics.

Author:

Wauzmons

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SkillUtils.TotemRunnable A runnable that needs a totem entity to be executed.

Constructor Summary

Constructors

Constructor and Description
SkillUtils()

Method Summary

Modifier and Type	Method and Description
static void	addPotionEffect(org.bukkit.entity.Entity entity, org.bukkit.potion.PotionEffectType potionEffectType, int duration, int amplifier) Adds the given potion effect to an entity.
static void	addPotionEffect(java.util.List<org.bukkit.entity.Entity> entities, org.bukkit.potion.PotionEffectType potionEffectType, int duration, int amplifier) Adds the given potion effect to multiple entities.
static void	callPlayerDamageOverTimeEvent(org.bukkit.entity.Player player, org.bukkit.entity.Entity entity, org.bukkit.Color color, int damage, int ticks, int interval) Calls a damage event, that deals damage based on a specified interval.
static void	callPlayerFixedDamageEvent(org.bukkit.entity.Player player, org.bukkit.entity.Entity entity, double damage) Calls a damage event, that will not receive attack bonuses, hittting a single enemy.
static void	callPlayerFixedDamageEvent(org.bukkit.entity.Player player, java.util.List<org.bukkit.entity.Entity> entities, double damage) Calls a damage event, that will not receive attack bonuses, hittting multiple enemies.
static void	callPlayerMagicDamageEvent(org.bukkit.entity.Player player, org.bukkit.entity.Entity entity, double damageMultiplier) Calls a damage event with a damage multiplier, for magic attacks, hitting a single enemy.
static void	callPlayerMagicDamageEvent(org.bukkit.entity.Player player, java.util.List<org.bukkit.entity.Entity> entities, double damageMultiplier) Calls a damage event with a damage multiplier, for magic attacks, hitting multiple enemies.
private static void	callTotemEvent(org.bukkit.entity.Entity totem, SkillUtils.TotemRunnable runnable, int ticks, int interval) Calls a the totem runnable for an existing totem.
static void	createExplosion(org.bukkit.Location location, float power) Creates an audiovisual explosion, that can not destroy blocks.
static java.util.List<org.bukkit.entity.Player>	getPlayersInRadius(org.bukkit.Location location, int radius) Determines all players in the radius of the given location.
static org.bukkit.entity.Entity	getTargetInLine(org.bukkit.entity.Player player, int range) Determines the first target in the line of sight of the player.
static java.util.List<org.bukkit.entity.Entity>	getTargetsInLine(org.bukkit.entity.Player player, int range) Determines all targets in the line of sight of the player.
static java.util.List<org.bukkit.entity.Entity>	getTargetsInRadius(org.bukkit.Location location, double radius) Determines all targets in the radius of the given location.
static java.util.List<org.bukkit.entity.Entity>	getTargetsInRadius(org.bukkit.Location location, double radius, java.util.List<org.bukkit.entity.Entity> excludes) Determines all targets in the radius of the given location.
static org.bukkit.util.Vector	getThrowbackVector(org.bukkit.Location originLocation, org.bukkit.Location throwbackLocation, double force) Generates a vector from one location away from another.
static org.bukkit.util.Vector	getVectorForPoints(org.bukkit.Location originLocation, org.bukkit.Location targetLocation) Generates a vector from one location to another.
static boolean	isValidAttackTarget(org.bukkit.entity.Entity entity) Determines if given entity should be targetable.
static void	rotateEntity(org.bukkit.entity.Entity entity) Lets the entity rotate 360 degrees over the course of 0.5 seconds.
static void	spawnTotem(org.bukkit.entity.Player owner, org.bukkit.Material material, SkillUtils.TotemRunnable runnable, int ticks, int interval) Spawns a totem to execute a runnable based on a specified interval.
static void	spawnTower(org.bukkit.entity.Player owner, org.bukkit.inventory.ItemStack headItemStack, org.bukkit.inventory.ItemStack bodyItemStack, SkillUtils.TotemRunnable runnable, int ticks, int interval) Spawns a tower (big totem) to execute a runnable based on a specified interval.
static void	throwBackEntity(org.bukkit.entity.Entity entity, org.bukkit.Location fromLocation, double force) Throws an entity back from a location.
static void	throwEntitiesIntoAir(java.util.List<org.bukkit.entity.Entity> entities, double force) Throws multiple entities into the air.
static void	throwEntity(org.bukkit.entity.Entity entity, double x, double y, double z) Throws an entity to given coordinates.
static void	throwEntity(org.bukkit.entity.Entity entity, org.bukkit.entity.Entity target) Throws an entity to another entity.
static void	throwEntity(org.bukkit.entity.Entity entity, org.bukkit.Location location) Throws an entity to a location.
static void	throwEntityIntoAir(org.bukkit.entity.Entity entity, double force) Throws an entity into the air.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SkillUtils

public SkillUtils()

Method Detail

isValidAttackTarget

public static boolean isValidAttackTarget(org.bukkit.entity.Entity entity)

Determines if given entity should be targetable. This is defined by the aqua color for the levels in their name. Armor stands are never classified as attack targets.

Parameters:

entity - The entity to target.

Returns:

If the entity is targetable.

getTargetInLine

public static org.bukkit.entity.Entity getTargetInLine(org.bukkit.entity.Player player,
                                                       int range)

Determines the first target in the line of sight of the player.

Parameters:

player - The player that is targeting.

range - The range of the line in blocks.

Returns:

The target, or null if no valid target was found.

getTargetsInLine

public static java.util.List<org.bukkit.entity.Entity> getTargetsInLine(org.bukkit.entity.Player player,
                                                                        int range)

Determines all targets in the line of sight of the player.

Parameters:

player - The player that is targeting.

range - The range of the line in blocks.

Returns:

The list of targets. Can be empty.

getTargetsInRadius

public static java.util.List<org.bukkit.entity.Entity> getTargetsInRadius(org.bukkit.Location location,
                                                                          double radius)

Determines all targets in the radius of the given location.

Parameters:

location - The center to check around for targets.

radius - The radius from the center in blocks.

Returns:

The list of targets. Can be empty.

getTargetsInRadius

public static java.util.List<org.bukkit.entity.Entity> getTargetsInRadius(org.bukkit.Location location,
                                                                          double radius,
                                                                          java.util.List<org.bukkit.entity.Entity> excludes)

Determines all targets in the radius of the given location.

Parameters:

location - The center to check around for targets.

radius - The radius from the center in blocks.

excludes - Entities that should be ignored.

Returns:

The list of targets. Can be empty.

getPlayersInRadius

public static java.util.List<org.bukkit.entity.Player> getPlayersInRadius(org.bukkit.Location location,
                                                                          int radius)

Determines all players in the radius of the given location.

Parameters:

location - The center to check around for players.

radius - The radius from the center in blocks.

Returns:

The list of players. Can be empty.

addPotionEffect

public static void addPotionEffect(java.util.List<org.bukkit.entity.Entity> entities,
                                   org.bukkit.potion.PotionEffectType potionEffectType,
                                   int duration,
                                   int amplifier)

Adds the given potion effect to multiple entities.

Parameters:

entities - The entities to receive the potion effect.

potionEffectType - The type of the effect.

duration - The duration of the effect in seconds.

amplifier - The strength of the effect. (Starts at 0)

addPotionEffect

public static void addPotionEffect(org.bukkit.entity.Entity entity,
                                   org.bukkit.potion.PotionEffectType potionEffectType,
                                   int duration,
                                   int amplifier)

Adds the given potion effect to an entity.

Parameters:

entity - The entity to receive the potion effect.

potionEffectType - The type of the effect.

duration - The duration of the effect in seconds.

amplifier - The strength of the effect. (Starts at 0)

callPlayerMagicDamageEvent

public static void callPlayerMagicDamageEvent(org.bukkit.entity.Player player,
                                              java.util.List<org.bukkit.entity.Entity> entities,
                                              double damageMultiplier)

Calls a damage event with a damage multiplier, for magic attacks, hitting multiple enemies.

Parameters:

player - The player who casted the attack.

entities - The entities that got hit by the attack.

damageMultiplier - The magic multiplier of the damage.

See Also:

callPlayerMagicDamageEvent(Player, Entity, double)

callPlayerMagicDamageEvent

public static void callPlayerMagicDamageEvent(org.bukkit.entity.Player player,
                                              org.bukkit.entity.Entity entity,
                                              double damageMultiplier)

Calls a damage event with a damage multiplier, for magic attacks, hitting a single enemy.

Parameters:

player - The player who casted the attack.

entity - The entity that got hit by the attack.

damageMultiplier - The magic multiplier of the damage.

See Also:

MobMetadataUtils.setMagicDamageMultiplier(Entity, double)

callPlayerFixedDamageEvent

public static void callPlayerFixedDamageEvent(org.bukkit.entity.Player player,
                                              java.util.List<org.bukkit.entity.Entity> entities,
                                              double damage)

Calls a damage event, that will not receive attack bonuses, hittting multiple enemies.

Parameters:

player - The player who casted the attack.

entities - The entities that got hit by the attack.

damage - The fixed damage value.

See Also:

callPlayerFixedDamageEvent(Player, Entity, double)

callPlayerFixedDamageEvent

public static void callPlayerFixedDamageEvent(org.bukkit.entity.Player player,
                                              org.bukkit.entity.Entity entity,
                                              double damage)

Calls a damage event, that will not receive attack bonuses, hittting a single enemy.

Parameters:

player - The player who casted the attack.

entity - The entity that got hit by the attack.

damage - The fixed damage value.

See Also:

MobMetadataUtils.setFixedDamage(Entity, boolean)

callPlayerDamageOverTimeEvent

public static void callPlayerDamageOverTimeEvent(org.bukkit.entity.Player player,
                                                 org.bukkit.entity.Entity entity,
                                                 org.bukkit.Color color,
                                                 int damage,
                                                 int ticks,
                                                 int interval)

Calls a damage event, that deals damage based on a specified interval.

Parameters:

player - The player who casted the attack.

entity - The entity that got hit by the attack.

color - The color of the damage particles.

damage - The fixed damage value.

ticks - How often the damage should be dealt.

interval - The server ticks between each damage.

spawnTotem

public static void spawnTotem(org.bukkit.entity.Player owner,
                              org.bukkit.Material material,
                              SkillUtils.TotemRunnable runnable,
                              int ticks,
                              int interval)

Spawns a totem to execute a runnable based on a specified interval.

Parameters:

owner - The player who summoned the totem.

material - The material of the totem head.

runnable - The runnable that should be executed.

ticks - How often the runnable should be executed.

interval - The server ticks between each execution.

spawnTower

public static void spawnTower(org.bukkit.entity.Player owner,
                              org.bukkit.inventory.ItemStack headItemStack,
                              org.bukkit.inventory.ItemStack bodyItemStack,
                              SkillUtils.TotemRunnable runnable,
                              int ticks,
                              int interval)

Spawns a tower (big totem) to execute a runnable based on a specified interval.

Parameters:

owner - The player who summoned the tower.

headItemStack - The head of thr tower.

bodyItemStack - The body of the tower.

runnable - The runnable that should be executed.

ticks - How often the runnable should be executed.

interval - The server ticks between each execution.

callTotemEvent

private static void callTotemEvent(org.bukkit.entity.Entity totem,
                                   SkillUtils.TotemRunnable runnable,
                                   int ticks,
                                   int interval)

Calls a the totem runnable for an existing totem.

Parameters:

totem - The summoned totem.

runnable - The runnable that should be executed.

ticks - How often the runnable should be executed.

interval - The server ticks between each execution.

createExplosion

public static void createExplosion(org.bukkit.Location location,
                                   float power)

Creates an audiovisual explosion, that can not destroy blocks.

Parameters:

location - The location of the explosion.

power - The power of the explosion.

rotateEntity

public static void rotateEntity(org.bukkit.entity.Entity entity)

Lets the entity rotate 360 degrees over the course of 0.5 seconds.

Parameters:

entity - The entity to rotate.

throwEntity

public static void throwEntity(org.bukkit.entity.Entity entity,
                               org.bukkit.entity.Entity target)

Throws an entity to another entity.

Parameters:

entity - The entity to throw.

target - The targeted entity.

throwEntity

public static void throwEntity(org.bukkit.entity.Entity entity,
                               org.bukkit.Location location)

Throws an entity to a location.

Parameters:

entity - The entity to throw.

location - The targeted location.

throwEntity

public static void throwEntity(org.bukkit.entity.Entity entity,
                               double x,
                               double y,
                               double z)

Throws an entity to given coordinates.

Parameters:

entity - The entity to throw.

x - The targeted x coordinate.

y - The targeted y coordinate.

z - The targeted z coordinate.

throwEntitiesIntoAir

public static void throwEntitiesIntoAir(java.util.List<org.bukkit.entity.Entity> entities,
                                        double force)

Throws multiple entities into the air.

Parameters:

entities - The entities to throw.

force - The force to throw with.

throwEntityIntoAir

public static void throwEntityIntoAir(org.bukkit.entity.Entity entity,
                                      double force)

Throws an entity into the air.

Parameters:

entity - The entity to throw.

force - The force to throw with.

throwBackEntity

public static void throwBackEntity(org.bukkit.entity.Entity entity,
                                   org.bukkit.Location fromLocation,
                                   double force)

Throws an entity back from a location.

Parameters:

entity - The entity to throw.

fromLocation - The location to throw back from.

force - The force to throw with.

getVectorForPoints

public static org.bukkit.util.Vector getVectorForPoints(org.bukkit.Location originLocation,
                                                        org.bukkit.Location targetLocation)

Generates a vector from one location to another.

Parameters:

originLocation - The starting location.

targetLocation - The targeted location.

Returns:

The vector between the locations.

getThrowbackVector

public static org.bukkit.util.Vector getThrowbackVector(org.bukkit.Location originLocation,
                                                        org.bukkit.Location throwbackLocation,
                                                        double force)

Generates a vector from one location away from another.

Parameters:

originLocation - The starting location.

throwbackLocation - The throwback location.

force - The force away from the throwback location.

Returns:

The vector away from the throwback location.