public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginMessageRecipient, NetworkClient
Modifier and Type | Interface and Description |
---|---|
static class |
Player.Spigot |
Modifier and Type | Method and Description |
---|---|
int |
applyMending(int amount)
Applies the mending effect to any items just as picking up an orb would.
|
void |
awardAchievement(Achievement achievement)
Deprecated.
future versions of Minecraft do not have achievements
|
default BanEntry |
banPlayerFull(String reason)
Permanently Bans the Profile and IP address currently used by the player.
|
default BanEntry |
banPlayerFull(String reason,
Date expires)
Bans the Profile and IP address currently used by the player.
|
default BanEntry |
banPlayerFull(String reason,
Date expires,
String source)
Bans the Profile and IP address currently used by the player.
|
default BanEntry |
banPlayerFull(String reason,
String source)
Permanently Bans the Profile and IP address currently used by the player.
|
default BanEntry |
banPlayerIP(String reason)
Permanently Bans the IP address currently used by the player.
|
default BanEntry |
banPlayerIP(String reason,
boolean kickPlayer)
Permanently Bans the IP address currently used by the player.
|
default BanEntry |
banPlayerIP(String reason,
Date expires)
Bans the IP address currently used by the player.
|
default BanEntry |
banPlayerIP(String reason,
Date expires,
boolean kickPlayer)
Bans the IP address currently used by the player.
|
default BanEntry |
banPlayerIP(String reason,
Date expires,
String source)
Bans the IP address currently used by the player.
|
default BanEntry |
banPlayerIP(String reason,
Date expires,
String source,
boolean kickPlayer)
Bans the IP address currently used by the player.
|
default BanEntry |
banPlayerIP(String reason,
String source)
Permanently Bans the IP address currently used by the player.
|
default BanEntry |
banPlayerIP(String reason,
String source,
boolean kickPlayer)
Permanently Bans the IP address currently used by the player.
|
boolean |
canSee(Player player)
Checks to see if a player has been hidden from this player
|
void |
chat(String msg)
Says a message (or runs a command).
|
void |
decrementStatistic(Statistic statistic)
Decrements the given statistic for this player.
|
void |
decrementStatistic(Statistic statistic,
EntityType entityType)
Decrements the given statistic for this player for the given entity.
|
void |
decrementStatistic(Statistic statistic,
EntityType entityType,
int amount)
Decrements the given statistic for this player for the given entity.
|
void |
decrementStatistic(Statistic statistic,
int amount)
Decrements the given statistic for this player.
|
void |
decrementStatistic(Statistic statistic,
Material material)
Decrements the given statistic for this player for the given material.
|
void |
decrementStatistic(Statistic statistic,
Material material,
int amount)
Decrements the given statistic for this player for the given material.
|
InetSocketAddress |
getAddress()
Gets the socket address of this player
|
AdvancementProgress |
getAdvancementProgress(Advancement advancement)
Return the player's progression on the specified advancement.
|
boolean |
getAffectsSpawning()
Get whether the player can affect mob spawning
|
boolean |
getAllowFlight()
Determines if the Player is allowed to fly via jump key double-tap like
in creative mode.
|
int |
getClientViewDistance()
Get the player's current client side view distance.
|
Location |
getCompassTarget()
Get the previously set compass target.
|
float |
getCooldownPeriod()
Returns the amount of ticks the current cooldown lasts
|
float |
getCooledAttackStrength(float adjustTicks)
Returns the percentage of attack power available based on the cooldown (zero to one).
|
String |
getDisplayName()
Gets the "friendly" name to display of this player.
|
float |
getExhaustion()
Gets the players current exhaustion level.
|
float |
getExp()
Gets the players current experience points towards the next level.
|
float |
getFlySpeed()
Gets the current allowed speed that a client can fly.
|
int |
getFoodLevel()
Gets the players current food level
|
double |
getHealthScale()
Gets the number that health is scaled to for the client.
|
int |
getLevel()
Gets the players current experience level
|
String |
getLocale()
Gets the player's current locale.
|
String |
getPlayerListFooter()
Gets the currently displayed player list footer for this player.
|
String |
getPlayerListHeader()
Gets the currently displayed player list header for this player.
|
String |
getPlayerListName()
Gets the name that is shown on the player list.
|
PlayerProfile |
getPlayerProfile()
Gets a copy of this players profile
|
long |
getPlayerTime()
Returns the player's current timestamp.
|
long |
getPlayerTimeOffset()
Returns the player's current time offset relative to server time, or
the current player's fixed time if the player's time is absolute.
|
WeatherType |
getPlayerWeather()
Returns the type of weather the player is currently experiencing.
|
String |
getResourcePackHash()
Deprecated.
This is no longer sent from the client and will always be null
|
PlayerResourcePackStatusEvent.Status |
getResourcePackStatus() |
float |
getSaturation()
Gets the players current saturation level.
|
Scoreboard |
getScoreboard()
Gets the Scoreboard displayed to this player
|
Entity |
getSpectatorTarget()
Gets the entity which is followed by the camera when in
GameMode.SPECTATOR . |
int |
getStatistic(Statistic statistic)
Gets the value of the given statistic for this player.
|
int |
getStatistic(Statistic statistic,
EntityType entityType)
Gets the value of the given statistic for this player.
|
int |
getStatistic(Statistic statistic,
Material material)
Gets the value of the given statistic for this player.
|
int |
getTotalExperience()
Gets the players total experience points.
|
int |
getViewDistance()
Gets the view distance for this player
|
float |
getWalkSpeed()
Gets the current allowed speed that a client can walk.
|
default void |
giveExp(int amount)
Gives the player the amount of experience specified.
|
void |
giveExp(int amount,
boolean applyMending)
Gives the player the amount of experience specified.
|
void |
giveExpLevels(int amount)
Gives the player the amount of experience levels specified.
|
boolean |
hasAchievement(Achievement achievement)
Deprecated.
future versions of Minecraft do not have achievements
|
boolean |
hasResourcePack() |
void |
hidePlayer(Player player)
Deprecated.
|
void |
hidePlayer(Plugin plugin,
Player player)
Hides a player from this player
|
void |
hideTitle()
Hide any title that is currently visible to the player
|
void |
incrementStatistic(Statistic statistic)
Increments the given statistic for this player.
|
void |
incrementStatistic(Statistic statistic,
EntityType entityType)
Increments the given statistic for this player for the given entity.
|
void |
incrementStatistic(Statistic statistic,
EntityType entityType,
int amount)
Increments the given statistic for this player for the given entity.
|
void |
incrementStatistic(Statistic statistic,
int amount)
Increments the given statistic for this player.
|
void |
incrementStatistic(Statistic statistic,
Material material)
Increments the given statistic for this player for the given material.
|
void |
incrementStatistic(Statistic statistic,
Material material,
int amount)
Increments the given statistic for this player for the given material.
|
boolean |
isFlying()
Checks to see if this player is currently flying or not.
|
boolean |
isHealthScaled()
Gets if the client is displayed a 'scaled' health, that is, health on a
scale from 0-
getHealthScale() . |
boolean |
isPlayerTimeRelative()
Returns true if the player's time is relative to the server time,
otherwise the player's time is absolute and will not change its current
time unless done so with setPlayerTime().
|
boolean |
isSleepingIgnored()
Returns whether the player is sleeping ignored.
|
boolean |
isSneaking()
Returns if the player is in sneak mode
|
boolean |
isSprinting()
Gets whether the player is sprinting or not.
|
void |
kickPlayer(String message)
Kicks player with custom kick message.
|
void |
loadData()
Loads the players current location, health, inventory, motion, and
other information from the username.dat file, in the world/player
folder.
|
void |
openBook(ItemStack book)
Open a
Material.WRITTEN_BOOK for a Player |
boolean |
performCommand(String command)
Makes the player perform the given command
|
void |
playEffect(Location loc,
Effect effect,
int data)
Deprecated.
Magic value
|
<T> void |
playEffect(Location loc,
Effect effect,
T data)
Plays an effect to just this player.
|
void |
playNote(Location loc,
byte instrument,
byte note)
Deprecated.
Magic value
|
void |
playNote(Location loc,
Instrument instrument,
Note note)
Play a note for a player at a location.
|
void |
playSound(Location location,
Sound sound,
float volume,
float pitch)
Play a sound for a player at the location.
|
void |
playSound(Location location,
Sound sound,
SoundCategory category,
float volume,
float pitch)
Play a sound for a player at the location.
|
void |
playSound(Location location,
String sound,
float volume,
float pitch)
Play a sound for a player at the location.
|
void |
playSound(Location location,
String sound,
SoundCategory category,
float volume,
float pitch)
Play a sound for a player at the location.
|
void |
removeAchievement(Achievement achievement)
Deprecated.
future versions of Minecraft do not have achievements
|
void |
resetCooldown()
Reset the cooldown counter to 0, effectively starting the cooldown period.
|
void |
resetPlayerTime()
Restores the normal condition where the player's time is synchronized
with the server time.
|
void |
resetPlayerWeather()
Restores the normal condition where the player's weather is controlled
by server conditions.
|
void |
resetTitle()
Resets the title displayed to the player.
|
void |
saveData()
Saves the players current location, health, inventory, motion, and
other information into the username.dat file, in the world/player
folder
|
void |
sendActionBar(char alternateChar,
String message)
Sends an Action Bar message to the client.
|
void |
sendActionBar(String message)
Sends an Action Bar message to the client.
|
void |
sendBlockChange(Location loc,
BlockData block)
Send a block change.
|
void |
sendBlockChange(Location loc,
Material material,
byte data)
Deprecated.
Magic value
|
boolean |
sendChunkChange(Location loc,
int sx,
int sy,
int sz,
byte[] data)
Deprecated.
Magic value
|
void |
sendMap(MapView map)
Render a map and send it to the player in its entirety.
|
default void |
sendMessage(net.md_5.bungee.api.chat.BaseComponent... components)
Sends an array of components as a single message to the player
|
default void |
sendMessage(net.md_5.bungee.api.chat.BaseComponent component)
Sends the component to the player
|
default void |
sendMessage(net.md_5.bungee.api.ChatMessageType position,
net.md_5.bungee.api.chat.BaseComponent... components)
Deprecated.
This is unlikely the API you want to use. See
sendActionBar(String) for a more proper Action Bar API. This deprecated API may send unsafe items to the client. |
void |
sendRawMessage(String message)
Sends this sender a message raw
|
void |
sendSignChange(Location loc,
String[] lines)
Send a sign change.
|
void |
sendSignChange(Location loc,
String[] lines,
DyeColor dyeColor)
Send a sign change.
|
void |
sendTitle(String title,
String subtitle)
Deprecated.
API behavior subject to change
|
void |
sendTitle(String title,
String subtitle,
int fadeIn,
int stay,
int fadeOut)
Sends a title and a subtitle message to the player.
|
void |
sendTitle(Title title)
Show the title to the player, overriding any previously displayed title.
|
void |
setAffectsSpawning(boolean affects)
Set whether the player can affect mob spawning
|
void |
setAllowFlight(boolean flight)
Sets if the Player is allowed to fly via jump key double-tap like in
creative mode.
|
void |
setCompassTarget(Location loc)
Set the target of the player's compass.
|
void |
setDisplayName(String name)
Sets the "friendly" name to display of this player.
|
void |
setExhaustion(float value)
Sets the players current exhaustion level
|
void |
setExp(float exp)
Sets the players current experience points towards the next level
|
void |
setFlying(boolean value)
Makes this player start or stop flying.
|
void |
setFlySpeed(float value)
Sets the speed at which a client will fly.
|
void |
setFoodLevel(int value)
Sets the players current food level
|
void |
setHealthScale(double scale)
Sets the number to scale health to for the client; this will also
setHealthScaled(true) . |
void |
setHealthScaled(boolean scale)
Sets if the client is displayed a 'scaled' health, that is, health on a
scale from 0-
getHealthScale() . |
void |
setLevel(int level)
Sets the players current experience level
|
void |
setPlayerListFooter(String footer)
Sets the currently displayed player list footer for this player.
|
void |
setPlayerListHeader(String header)
Sets the currently displayed player list header for this player.
|
void |
setPlayerListHeaderFooter(net.md_5.bungee.api.chat.BaseComponent[] header,
net.md_5.bungee.api.chat.BaseComponent[] footer)
Set the text displayed in the player list header and footer for this player
|
void |
setPlayerListHeaderFooter(net.md_5.bungee.api.chat.BaseComponent header,
net.md_5.bungee.api.chat.BaseComponent footer)
Set the text displayed in the player list header and footer for this player
|
void |
setPlayerListHeaderFooter(String header,
String footer)
Sets the currently displayed player list header and footer for this
player.
|
void |
setPlayerListName(String name)
Sets the name that is shown on the in-game player list.
|
void |
setPlayerProfile(PlayerProfile profile)
Changes the PlayerProfile for this player.
|
void |
setPlayerTime(long time,
boolean relative)
Sets the current time on the player's client.
|
void |
setPlayerWeather(WeatherType type)
Sets the type of weather the player will see.
|
void |
setResourcePack(String url)
Deprecated.
|
void |
setResourcePack(String url,
byte[] hash)
Request that the player's client download and switch resource packs.
|
void |
setResourcePack(String url,
String hash)
Request that the player's client download and switch resource packs.
|
void |
setSaturation(float value)
Sets the players current saturation level
|
void |
setScoreboard(Scoreboard scoreboard)
Sets the player's visible Scoreboard.
|
void |
setSleepingIgnored(boolean isSleeping)
Sets whether the player is ignored as not sleeping.
|
void |
setSneaking(boolean sneak)
Sets the sneak mode the player
|
void |
setSpectatorTarget(Entity entity)
Sets the entity which is followed by the camera when in
GameMode.SPECTATOR . |
void |
setSprinting(boolean sprinting)
Sets whether the player is sprinting or not.
|
void |
setStatistic(Statistic statistic,
EntityType entityType,
int newValue)
Sets the given statistic for this player for the given entity.
|
void |
setStatistic(Statistic statistic,
int newValue)
Sets the given statistic for this player.
|
void |
setStatistic(Statistic statistic,
Material material,
int newValue)
Sets the given statistic for this player for the given material.
|
void |
setSubtitle(net.md_5.bungee.api.chat.BaseComponent subtitle)
Deprecated.
|
void |
setSubtitle(net.md_5.bungee.api.chat.BaseComponent[] subtitle)
Deprecated.
|
void |
setTexturePack(String url)
Deprecated.
Minecraft no longer uses textures packs. Instead you
should use
setResourcePack(String) . |
void |
setTitleTimes(int fadeInTicks,
int stayTicks,
int fadeOutTicks)
Deprecated.
|
void |
setTotalExperience(int exp)
Sets the players current experience points.
|
void |
setViewDistance(int viewDistance)
Sets the view distance for this player
|
void |
setWalkSpeed(float value)
Sets the speed at which a client will walk.
|
void |
showPlayer(Player player)
Deprecated.
|
void |
showPlayer(Plugin plugin,
Player player)
Allows this player to see a player that was previously hidden.
|
void |
showTitle(net.md_5.bungee.api.chat.BaseComponent title)
Deprecated.
|
void |
showTitle(net.md_5.bungee.api.chat.BaseComponent[] title)
Deprecated.
|
void |
showTitle(net.md_5.bungee.api.chat.BaseComponent[] title,
net.md_5.bungee.api.chat.BaseComponent[] subtitle,
int fadeInTicks,
int stayTicks,
int fadeOutTicks)
Deprecated.
|
void |
showTitle(net.md_5.bungee.api.chat.BaseComponent title,
net.md_5.bungee.api.chat.BaseComponent subtitle,
int fadeInTicks,
int stayTicks,
int fadeOutTicks)
Deprecated.
|
void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
double offsetX,
double offsetY,
double offsetZ,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
double x,
double y,
double z,
int count,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
Location location,
int count)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
Location location,
int count,
double offsetX,
double offsetY,
double offsetZ)
Spawns the particle (the number of times specified by count)
at the target location.
|
void |
spawnParticle(Particle particle,
Location location,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
Location location,
int count,
double offsetX,
double offsetY,
double offsetZ,
double extra,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
Location location,
int count,
double offsetX,
double offsetY,
double offsetZ,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
<T> void |
spawnParticle(Particle particle,
Location location,
int count,
T data)
Spawns the particle (the number of times specified by count)
at the target location.
|
Player.Spigot |
spigot() |
void |
stopSound(Sound sound)
Stop the specified sound from playing.
|
void |
stopSound(Sound sound,
SoundCategory category)
Stop the specified sound from playing.
|
void |
stopSound(String sound)
Stop the specified sound from playing.
|
void |
stopSound(String sound,
SoundCategory category)
Stop the specified sound from playing.
|
void |
updateCommands()
Update the list of commands sent to the client.
|
void |
updateInventory()
Forces an update of the player's entire inventory.
|
void |
updateTitle(Title title)
Show the title to the player, overriding any previously displayed title.
|
closeInventory, closeInventory, discoverRecipe, discoverRecipes, getBedLocation, getBedSpawnLocation, getCooldown, getEnderChest, getExpToLevel, getGameMode, getInventory, getItemInHand, getItemOnCursor, getMainHand, getName, getOpenInventory, getShoulderEntityLeft, getShoulderEntityRight, getSleepTicks, hasCooldown, isBlocking, isHandRaised, openEnchanting, openInventory, openInventory, openMerchant, openMerchant, openSign, openWorkbench, releaseLeftShoulderEntity, releaseRightShoulderEntity, setBedSpawnLocation, setBedSpawnLocation, setCooldown, setGameMode, setItemInHand, setItemOnCursor, setShoulderEntityLeft, setShoulderEntityRight, setWindowProperty, sleep, undiscoverRecipe, undiscoverRecipes, wakeup
addPotionEffect, addPotionEffect, addPotionEffects, getActiveItem, getActivePotionEffects, getArrowsStuck, getCanPickupItems, getEquipment, getEyeHeight, getEyeHeight, getEyeLocation, getHandRaisedTime, getItemUseRemainingTime, getKiller, getLastDamage, getLastTwoTargetBlocks, getLeashHolder, getLineOfSight, getMaximumAir, getMaximumNoDamageTicks, getMemory, getNoDamageTicks, getPotionEffect, getRemainingAir, getRemoveWhenFarAway, getShieldBlockingDelay, getTargetBlock, getTargetBlock, getTargetBlock, getTargetBlockExact, getTargetBlockExact, getTargetBlockFace, getTargetBlockFace, getTargetBlockInfo, getTargetBlockInfo, getTargetEntity, getTargetEntity, getTargetEntityInfo, getTargetEntityInfo, hasAI, hasLineOfSight, hasPotionEffect, isCollidable, isGliding, isLeashed, isRiptiding, isSleeping, isSwimming, rayTraceBlocks, rayTraceBlocks, removePotionEffect, setAI, setArrowsStuck, setCanPickupItems, setCollidable, setGliding, setKiller, setLastDamage, setLeashHolder, setMaximumAir, setMaximumNoDamageTicks, setMemory, setNoDamageTicks, setRemainingAir, setRemoveWhenFarAway, setShieldBlockingDelay, setSwimming
getAttribute
damage, damage, getAbsorptionAmount, getHealth, getMaxHealth, resetMaxHealth, setAbsorptionAmount, setHealth, setMaxHealth
addPassenger, addScoreboardTag, eject, fromMobSpawner, getBoundingBox, getChunk, getEntityId, getEntitySpawnReason, getFacing, getFallDistance, getFireTicks, getHeight, getLastDamageCause, getLocation, getLocation, getMaxFireTicks, getNearbyEntities, getOrigin, getPassenger, getPassengers, getPistonMoveReaction, getPortalCooldown, getPose, getScoreboardTags, getServer, getTicksLived, getType, getUniqueId, getVehicle, getVelocity, getWidth, getWorld, hasGravity, isCustomNameVisible, isDead, isEmpty, isGlowing, isInsideVehicle, isInvulnerable, isOnGround, isPersistent, isSilent, isValid, leaveVehicle, playEffect, remove, removePassenger, removeScoreboardTag, setCustomNameVisible, setFallDistance, setFireTicks, setGlowing, setGravity, setInvulnerable, setLastDamageCause, setPassenger, setPersistent, setPortalCooldown, setRotation, setSilent, setTicksLived, setVelocity, teleport, teleport, teleport, teleport, teleportAsync, teleportAsync
getMetadata, hasMetadata, removeMetadata, setMetadata
sendMessage, sendMessage
addAttachment, addAttachment, addAttachment, addAttachment, getEffectivePermissions, hasPermission, hasPermission, isPermissionSet, isPermissionSet, recalculatePermissions, removeAttachment
isOp, setOp
getCustomName, setCustomName
getPersistentDataContainer
launchProjectile, launchProjectile
abandonConversation, abandonConversation, acceptConversationInput, beginConversation, isConversing
banPlayer, banPlayer, banPlayer, banPlayer, banPlayer, getBedSpawnLocation, getFirstPlayed, getLastLogin, getLastPlayed, getLastSeen, getName, getPlayer, getUniqueId, hasPlayedBefore, isBanned, isOnline, isWhitelisted, setWhitelisted
serialize
getListeningPluginChannels, sendPluginMessage
getProtocolVersion, getVirtualHost
@NotNull String getDisplayName()
Note that this name will not be displayed in game, only in chat and places defined by plugins.
void setDisplayName(@Nullable String name)
Note that this name will not be displayed in game, only in chat and places defined by plugins.
name
- The new display name.@NotNull String getPlayerListName()
void setPlayerListName(@Nullable String name)
If the value is null, the name will be identical to HumanEntity.getName()
.
name
- new player list name@Nullable String getPlayerListHeader()
@Nullable String getPlayerListFooter()
void setPlayerListHeader(@Nullable String header)
header
- player list header, null for emptyvoid setPlayerListFooter(@Nullable String footer)
footer
- player list footer, null for emptyvoid setPlayerListHeaderFooter(@Nullable String header, @Nullable String footer)
header
- player list header, null for emptyfooter
- player list footer, null for emptyvoid setCompassTarget(@NotNull Location loc)
loc
- Location to point to@NotNull Location getCompassTarget()
@Nullable InetSocketAddress getAddress()
getAddress
in interface NetworkClient
void sendRawMessage(@NotNull String message)
sendRawMessage
in interface Conversable
message
- Message to be displayedvoid kickPlayer(@Nullable String message)
message
- kick messagevoid chat(@NotNull String msg)
msg
- message to printboolean performCommand(@NotNull String command)
command
- Command to performboolean isSneaking()
void setSneaking(boolean sneak)
sneak
- true if player should appear sneakingboolean isSprinting()
void setSprinting(boolean sprinting)
sprinting
- true if the player should be sprintingvoid saveData()
void loadData()
Note: This will overwrite the players current inventory, health, motion, etc, with the state from the saved dat file.
void setSleepingIgnored(boolean isSleeping)
isSleeping
- Whether to ignore.boolean isSleepingIgnored()
@Deprecated void playNote(@NotNull Location loc, byte instrument, byte note)
loc
- The location of a note block.instrument
- The instrument ID.note
- The note ID.void playNote(@NotNull Location loc, @NotNull Instrument instrument, @NotNull Note note)
loc
- The location of a note blockinstrument
- The instrumentnote
- The notevoid playSound(@NotNull Location location, @NotNull Sound sound, float volume, float pitch)
This function will fail silently if Location or Sound are null.
location
- The location to play the soundsound
- The sound to playvolume
- The volume of the soundpitch
- The pitch of the soundvoid playSound(@NotNull Location location, @NotNull String sound, float volume, float pitch)
This function will fail silently if Location or Sound are null. No sound will be heard by the player if their client does not have the respective sound for the value passed.
location
- the location to play the soundsound
- the internal sound name to playvolume
- the volume of the soundpitch
- the pitch of the soundvoid playSound(@NotNull Location location, @NotNull Sound sound, @NotNull SoundCategory category, float volume, float pitch)
This function will fail silently if Location or Sound are null.
location
- The location to play the soundsound
- The sound to playcategory
- The category of the soundvolume
- The volume of the soundpitch
- The pitch of the soundvoid playSound(@NotNull Location location, @NotNull String sound, @NotNull SoundCategory category, float volume, float pitch)
This function will fail silently if Location or Sound are null. No sound will be heard by the player if their client does not have the respective sound for the value passed.
location
- the location to play the soundsound
- the internal sound name to playcategory
- The category of the soundvolume
- the volume of the soundpitch
- the pitch of the soundvoid stopSound(@NotNull Sound sound)
sound
- the sound to stopvoid stopSound(@NotNull String sound)
sound
- the sound to stopvoid stopSound(@NotNull Sound sound, @Nullable SoundCategory category)
sound
- the sound to stopcategory
- the category of the soundvoid stopSound(@NotNull String sound, @Nullable SoundCategory category)
sound
- the sound to stopcategory
- the category of the sound@Deprecated void playEffect(@NotNull Location loc, @NotNull Effect effect, int data)
loc
- the location to play the effect ateffect
- the Effect
data
- a data bit needed for some effects<T> void playEffect(@NotNull Location loc, @NotNull Effect effect, @Nullable T data)
T
- the data based based on the type of the effectloc
- the location to play the effect ateffect
- the Effect
data
- a data bit needed for some effects@Deprecated void sendBlockChange(@NotNull Location loc, @NotNull Material material, byte data)
loc
- The location of the changed blockmaterial
- The new blockdata
- The block datavoid sendBlockChange(@NotNull Location loc, @NotNull BlockData block)
loc
- The location of the changed blockblock
- The new block@Deprecated boolean sendChunkChange(@NotNull Location loc, int sx, int sy, int sz, @NotNull byte[] data)
At least one of the dimensions of the cuboid must be even. The size of the data buffer must be 2.5*sx*sy*sz and formatted in accordance with the Packet51 format.
loc
- The location of the cuboidsx
- The x size of the cuboidsy
- The y size of the cuboidsz
- The z size of the cuboiddata
- The data to be sentvoid sendSignChange(@NotNull Location loc, @Nullable String[] lines) throws IllegalArgumentException
sendBlockChange(org.bukkit.Location, org.bukkit.Material, byte)
.
If the client does not have a sign at the given location it will display an error message to the user.
loc
- the location of the signlines
- the new text on the sign or null to clear itIllegalArgumentException
- if location is nullIllegalArgumentException
- if lines is non-null and has a length less than 4void sendSignChange(@NotNull Location loc, @Nullable String[] lines, @NotNull DyeColor dyeColor) throws IllegalArgumentException
sendBlockChange(org.bukkit.Location, org.bukkit.Material, byte)
.
If the client does not have a sign at the given location it will display an error message to the user.
loc
- the location of the signlines
- the new text on the sign or null to clear itdyeColor
- the color of the signIllegalArgumentException
- if location is nullIllegalArgumentException
- if dyeColor is nullIllegalArgumentException
- if lines is non-null and has a length less than 4void sendMap(@NotNull MapView map)
map
- The map to be sent@Nullable default BanEntry banPlayerFull(@Nullable String reason)
reason
- Reason for ban@Nullable default BanEntry banPlayerFull(@Nullable String reason, @Nullable String source)
reason
- Reason for bansource
- Source of ban, or null for default@Nullable default BanEntry banPlayerFull(@Nullable String reason, @Nullable Date expires)
reason
- Reason for Banexpires
- When to expire the ban@Nullable default BanEntry banPlayerFull(@Nullable String reason, @Nullable Date expires, @Nullable String source)
reason
- Reason for Banexpires
- When to expire the bansource
- Source of the ban, or null for default@Nullable default BanEntry banPlayerIP(@Nullable String reason, boolean kickPlayer)
banPlayerFull(String, Date, String)
reason
- Reason for bankickPlayer
- Whether or not to kick the player afterwards@Nullable default BanEntry banPlayerIP(@Nullable String reason, @Nullable String source, boolean kickPlayer)
banPlayerFull(String, Date, String)
reason
- Reason for bansource
- Source of ban, or null for defaultkickPlayer
- Whether or not to kick the player afterwards@Nullable default BanEntry banPlayerIP(@Nullable String reason, @Nullable Date expires, boolean kickPlayer)
banPlayerFull(String, Date, String)
reason
- Reason for Banexpires
- When to expire the bankickPlayer
- Whether or not to kick the player afterwards@Nullable default BanEntry banPlayerIP(@Nullable String reason)
banPlayerFull(String, Date, String)
reason
- Reason for ban@Nullable default BanEntry banPlayerIP(@Nullable String reason, @Nullable String source)
banPlayerFull(String, Date, String)
reason
- Reason for bansource
- Source of ban, or null for default@Nullable default BanEntry banPlayerIP(@Nullable String reason, @Nullable Date expires)
banPlayerFull(String, Date, String)
reason
- Reason for Banexpires
- When to expire the ban@Nullable default BanEntry banPlayerIP(@Nullable String reason, @Nullable Date expires, @Nullable String source)
banPlayerFull(String, Date, String)
reason
- Reason for Banexpires
- When to expire the bansource
- Source of the banm or null for default@Nullable default BanEntry banPlayerIP(@Nullable String reason, @Nullable Date expires, @Nullable String source, boolean kickPlayer)
banPlayerFull(String, Date, String)
reason
- Reason for Banexpires
- When to expire the bansource
- Source of the banm or null for defaultkickPlayer
- if the targeted player should be kickedvoid sendActionBar(@NotNull String message)
message
- The message to sendvoid sendActionBar(char alternateChar, @NotNull String message)
alternateChar
- Alternate symbol such as '&'message
- The message to senddefault void sendMessage(@NotNull net.md_5.bungee.api.chat.BaseComponent component)
sendMessage
in interface CommandSender
component
- the components to senddefault void sendMessage(@NotNull net.md_5.bungee.api.chat.BaseComponent... components)
sendMessage
in interface CommandSender
components
- the components to send@Deprecated default void sendMessage(net.md_5.bungee.api.ChatMessageType position, net.md_5.bungee.api.chat.BaseComponent... components)
sendActionBar(String)
for a more proper Action Bar API. This deprecated API may send unsafe items to the client.position
- the screen positioncomponents
- the components to sendvoid setPlayerListHeaderFooter(@Nullable net.md_5.bungee.api.chat.BaseComponent[] header, @Nullable net.md_5.bungee.api.chat.BaseComponent[] footer)
header
- content for the top of the player listfooter
- content for the bottom of the player listvoid setPlayerListHeaderFooter(@Nullable net.md_5.bungee.api.chat.BaseComponent header, @Nullable net.md_5.bungee.api.chat.BaseComponent footer)
header
- content for the top of the player listfooter
- content for the bottom of the player list@Deprecated void setTitleTimes(int fadeInTicks, int stayTicks, int fadeOutTicks)
updateTitle(Title)
fadeInTicks
- ticks to fade-instayTicks
- ticks to stay visiblefadeOutTicks
- ticks to fade-out@Deprecated void setSubtitle(net.md_5.bungee.api.chat.BaseComponent[] subtitle)
updateTitle(Title)
subtitle
- Subtitle to set@Deprecated void setSubtitle(net.md_5.bungee.api.chat.BaseComponent subtitle)
updateTitle(Title)
subtitle
- Subtitle to set@Deprecated void showTitle(@Nullable net.md_5.bungee.api.chat.BaseComponent[] title)
sendTitle(Title)
or updateTitle(Title)
title
- Title to set@Deprecated void showTitle(@Nullable net.md_5.bungee.api.chat.BaseComponent title)
sendTitle(Title)
or updateTitle(Title)
title
- Title to set@Deprecated void showTitle(@Nullable net.md_5.bungee.api.chat.BaseComponent[] title, @Nullable net.md_5.bungee.api.chat.BaseComponent[] subtitle, int fadeInTicks, int stayTicks, int fadeOutTicks)
sendTitle(Title)
or updateTitle(Title)
title
- big textsubtitle
- little text under itfadeInTicks
- ticks to fade-instayTicks
- ticks to stay visiblefadeOutTicks
- ticks to fade-out@Deprecated void showTitle(@Nullable net.md_5.bungee.api.chat.BaseComponent title, @Nullable net.md_5.bungee.api.chat.BaseComponent subtitle, int fadeInTicks, int stayTicks, int fadeOutTicks)
sendTitle(Title)
or updateTitle(Title)
title
- big textsubtitle
- little text under itfadeInTicks
- ticks to fade-instayTicks
- ticks to stay visiblefadeOutTicks
- ticks to fade-outvoid sendTitle(@NotNull Title title)
This method overrides any previous title, use updateTitle(Title)
to change the existing one.
title
- the title to sendNullPointerException
- if the title is nullvoid updateTitle(@NotNull Title title)
This method doesn't override previous titles, but changes their values.
title
- the title to sendNullPointerException
- if title is nullvoid hideTitle()
void updateInventory()
@Deprecated void awardAchievement(@NotNull Achievement achievement)
achievement
- Achievement to awardIllegalArgumentException
- if achievement is null@Deprecated void removeAchievement(@NotNull Achievement achievement)
achievement
- Achievement to removeIllegalArgumentException
- if achievement is null@Deprecated boolean hasAchievement(@NotNull Achievement achievement)
achievement
- the achievement to checkIllegalArgumentException
- if achievement is nullvoid incrementStatistic(@NotNull Statistic statistic) throws IllegalArgumentException
This is equivalent to the following code:
incrementStatistic(Statistic, 1)
statistic
- Statistic to incrementIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if the statistic requires an
additional parametervoid decrementStatistic(@NotNull Statistic statistic) throws IllegalArgumentException
This is equivalent to the following code:
decrementStatistic(Statistic, 1)
statistic
- Statistic to decrementIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if the statistic requires an
additional parametervoid incrementStatistic(@NotNull Statistic statistic, int amount) throws IllegalArgumentException
statistic
- Statistic to incrementamount
- Amount to increment this statistic byIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if amount is negativeIllegalArgumentException
- if the statistic requires an
additional parametervoid decrementStatistic(@NotNull Statistic statistic, int amount) throws IllegalArgumentException
statistic
- Statistic to decrementamount
- Amount to decrement this statistic byIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if amount is negativeIllegalArgumentException
- if the statistic requires an
additional parametervoid setStatistic(@NotNull Statistic statistic, int newValue) throws IllegalArgumentException
statistic
- Statistic to setnewValue
- The value to set this statistic toIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if newValue is negativeIllegalArgumentException
- if the statistic requires an
additional parameterint getStatistic(@NotNull Statistic statistic) throws IllegalArgumentException
statistic
- Statistic to checkIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if the statistic requires an
additional parametervoid incrementStatistic(@NotNull Statistic statistic, @NotNull Material material) throws IllegalArgumentException
This is equivalent to the following code:
incrementStatistic(Statistic, Material, 1)
statistic
- Statistic to incrementmaterial
- Material to offset the statistic withIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if material is nullIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid decrementStatistic(@NotNull Statistic statistic, @NotNull Material material) throws IllegalArgumentException
This is equivalent to the following code:
decrementStatistic(Statistic, Material, 1)
statistic
- Statistic to decrementmaterial
- Material to offset the statistic withIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if material is nullIllegalArgumentException
- if the given parameter is not valid
for the statisticint getStatistic(@NotNull Statistic statistic, @NotNull Material material) throws IllegalArgumentException
statistic
- Statistic to checkmaterial
- Material offset of the statisticIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if material is nullIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid incrementStatistic(@NotNull Statistic statistic, @NotNull Material material, int amount) throws IllegalArgumentException
statistic
- Statistic to incrementmaterial
- Material to offset the statistic withamount
- Amount to increment this statistic byIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if material is nullIllegalArgumentException
- if amount is negativeIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid decrementStatistic(@NotNull Statistic statistic, @NotNull Material material, int amount) throws IllegalArgumentException
statistic
- Statistic to decrementmaterial
- Material to offset the statistic withamount
- Amount to decrement this statistic byIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if material is nullIllegalArgumentException
- if amount is negativeIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid setStatistic(@NotNull Statistic statistic, @NotNull Material material, int newValue) throws IllegalArgumentException
statistic
- Statistic to setmaterial
- Material to offset the statistic withnewValue
- The value to set this statistic toIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if material is nullIllegalArgumentException
- if newValue is negativeIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid incrementStatistic(@NotNull Statistic statistic, @NotNull EntityType entityType) throws IllegalArgumentException
This is equivalent to the following code:
incrementStatistic(Statistic, EntityType, 1)
statistic
- Statistic to incremententityType
- EntityType to offset the statistic withIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if entityType is nullIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid decrementStatistic(@NotNull Statistic statistic, @NotNull EntityType entityType) throws IllegalArgumentException
This is equivalent to the following code:
decrementStatistic(Statistic, EntityType, 1)
statistic
- Statistic to decremententityType
- EntityType to offset the statistic withIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if entityType is nullIllegalArgumentException
- if the given parameter is not valid
for the statisticint getStatistic(@NotNull Statistic statistic, @NotNull EntityType entityType) throws IllegalArgumentException
statistic
- Statistic to checkentityType
- EntityType offset of the statisticIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if entityType is nullIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid incrementStatistic(@NotNull Statistic statistic, @NotNull EntityType entityType, int amount) throws IllegalArgumentException
statistic
- Statistic to incremententityType
- EntityType to offset the statistic withamount
- Amount to increment this statistic byIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if entityType is nullIllegalArgumentException
- if amount is negativeIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid decrementStatistic(@NotNull Statistic statistic, @NotNull EntityType entityType, int amount)
statistic
- Statistic to decremententityType
- EntityType to offset the statistic withamount
- Amount to decrement this statistic byIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if entityType is nullIllegalArgumentException
- if amount is negativeIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid setStatistic(@NotNull Statistic statistic, @NotNull EntityType entityType, int newValue)
statistic
- Statistic to setentityType
- EntityType to offset the statistic withnewValue
- The value to set this statistic toIllegalArgumentException
- if statistic is nullIllegalArgumentException
- if entityType is nullIllegalArgumentException
- if newValue is negativeIllegalArgumentException
- if the given parameter is not valid
for the statisticvoid setPlayerTime(long time, boolean relative)
When using non relative time the player's time will stay fixed at the specified time parameter. It's up to the caller to continue updating the player's time. To restore player time to normal use resetPlayerTime().
time
- The current player's perceived time or the player's time
offset from the server time.relative
- When true the player time is kept relative to its world
time.long getPlayerTime()
long getPlayerTimeOffset()
boolean isPlayerTimeRelative()
void resetPlayerTime()
Equivalent to calling setPlayerTime(0, true).
void setPlayerWeather(@NotNull WeatherType type)
resetPlayerWeather()
is
used.type
- The WeatherType enum type the player should experience@Nullable WeatherType getPlayerWeather()
void resetPlayerWeather()
default void giveExp(int amount)
amount
- Exp amount to givevoid giveExp(int amount, boolean applyMending)
amount
- Exp amount to giveapplyMending
- Mend players items with mending, with same behavior as picking up orbs. calls applyMending(int)
int applyMending(int amount)
giveExp(int, boolean)
by passing true to applyMendingamount
- Exp to applyvoid giveExpLevels(int amount)
amount
- amount of experience levels to give or takefloat getExp()
This is a percentage value. 0 is "no progress" and 1 is "next level".
void setExp(float exp)
This is a percentage value. 0 is "no progress" and 1 is "next level".
exp
- New experience pointsint getLevel()
void setLevel(int level)
level
- New experience levelint getTotalExperience()
void setTotalExperience(int exp)
exp
- New total experience pointsfloat getExhaustion()
Exhaustion controls how fast the food level drops. While you have a certain amount of exhaustion, your saturation will drop to zero, and then your food will drop to zero.
void setExhaustion(float value)
value
- Exhaustion levelfloat getSaturation()
Saturation is a buffer for food level. Your food level will not drop if you are saturated > 0.
void setSaturation(float value)
value
- Saturation levelint getFoodLevel()
void setFoodLevel(int value)
value
- New food levelboolean getAllowFlight()
void setAllowFlight(boolean flight)
flight
- If flight should be allowed.@Deprecated void hidePlayer(@NotNull Player player)
hidePlayer(Plugin, Player)
player
- Player to hidevoid hidePlayer(@NotNull Plugin plugin, @NotNull Player player)
plugin
- Plugin that wants to hide the playerplayer
- Player to hide@Deprecated void showPlayer(@NotNull Player player)
showPlayer(Plugin, Player)
player
- Player to showvoid showPlayer(@NotNull Plugin plugin, @NotNull Player player)
plugin
- Plugin that wants to show the playerplayer
- Player to showboolean canSee(@NotNull Player player)
player
- Player to checkboolean isFlying()
void setFlying(boolean value)
value
- True to fly.void setFlySpeed(float value) throws IllegalArgumentException
value
- The new speed, from -1 to 1.IllegalArgumentException
- If new speed is less than -1 or
greater than 1void setWalkSpeed(float value) throws IllegalArgumentException
value
- The new speed, from -1 to 1.IllegalArgumentException
- If new speed is less than -1 or
greater than 1float getFlySpeed()
float getWalkSpeed()
@Deprecated void setTexturePack(@NotNull String url)
setResourcePack(String)
.The player's client will download the new texture pack asynchronously in the background, and will automatically switch to it once the download is complete. If the client has downloaded and cached the same texture pack in the past, it will perform a file size check against the response content to determine if the texture pack has changed and needs to be downloaded again. When this request is sent for the very first time from a given server, the client will first display a confirmation GUI to the player before proceeding with the download.
Notes:
PlayerResourcePackStatusEvent
to figure out whether or not
the player loaded the pack!
url
- The URL from which the client will download the texture
pack. The string must contain only US-ASCII characters and should
be encoded as per RFC 1738.IllegalArgumentException
- Thrown if the URL is null.IllegalArgumentException
- Thrown if the URL is too long.@Deprecated void setResourcePack(@NotNull String url)
setResourcePack(String, String)
The player's client will download the new resource pack asynchronously in the background, and will automatically switch to it once the download is complete. If the client has downloaded and cached the same resource pack in the past, it will perform a file size check against the response content to determine if the resource pack has changed and needs to be downloaded again. When this request is sent for the very first time from a given server, the client will first display a confirmation GUI to the player before proceeding with the download.
Notes:
PlayerResourcePackStatusEvent
to figure out whether or not
the player loaded the pack!
url
- The URL from which the client will download the resource
pack. The string must contain only US-ASCII characters and should
be encoded as per RFC 1738.IllegalArgumentException
- Thrown if the URL is null.IllegalArgumentException
- Thrown if the URL is too long. The
length restriction is an implementation specific arbitrary value.void setResourcePack(@NotNull String url, @NotNull byte[] hash)
The player's client will download the new resource pack asynchronously in the background, and will automatically switch to it once the download is complete. If the client has downloaded and cached a resource pack with the same hash in the past it will not download but directly apply the cached pack. When this request is sent for the very first time from a given server, the client will first display a confirmation GUI to the player before proceeding with the download.
Notes:
PlayerResourcePackStatusEvent
to figure out whether or not
the player loaded the pack!
url
- The URL from which the client will download the resource
pack. The string must contain only US-ASCII characters and should
be encoded as per RFC 1738.hash
- The sha1 hash sum of the resource pack file which is used
to apply a cached version of the pack directly without downloading
if it is available. Hast to be 20 bytes long!IllegalArgumentException
- Thrown if the URL is null.IllegalArgumentException
- Thrown if the URL is too long. The
length restriction is an implementation specific arbitrary value.IllegalArgumentException
- Thrown if the hash is null.IllegalArgumentException
- Thrown if the hash is not 20 bytes
long.@NotNull Scoreboard getScoreboard()
void setScoreboard(@NotNull Scoreboard scoreboard) throws IllegalArgumentException, IllegalStateException
scoreboard
- New Scoreboard for the playerIllegalArgumentException
- if scoreboard is nullIllegalArgumentException
- if scoreboard was not created by the
scoreboard manager
IllegalStateException
- if this is a player that is not logged
yet or has logged outboolean isHealthScaled()
getHealthScale()
.setHealthScaled(boolean)
void setHealthScaled(boolean scale)
getHealthScale()
.
Displayed health follows a simple formula displayedHealth =
getHealth() / getMaxHealth() * getHealthScale()
.
scale
- if the client health display is scaledvoid setHealthScale(double scale) throws IllegalArgumentException
setHealthScaled(true)
.
Displayed health follows a simple formula displayedHealth =
getHealth() / getMaxHealth() * getHealthScale()
.
scale
- the number to scale health toIllegalArgumentException
- if scale is <0IllegalArgumentException
- if scale is Double.NaN
IllegalArgumentException
- if scale is too highdouble getHealthScale()
setHealthScale(double)
,
setHealthScaled(boolean)
@Nullable Entity getSpectatorTarget()
GameMode.SPECTATOR
.void setSpectatorTarget(@Nullable Entity entity)
GameMode.SPECTATOR
.entity
- the entity to follow or null to resetIllegalStateException
- if the player is not in
GameMode.SPECTATOR
@Deprecated void sendTitle(@Nullable String title, @Nullable String subtitle)
title
- Title textsubtitle
- Subtitle textvoid sendTitle(@Nullable String title, @Nullable String subtitle, int fadeIn, int stay, int fadeOut)
title
- Title textsubtitle
- Subtitle textfadeIn
- time in ticks for titles to fade in. Defaults to 10.stay
- time in ticks for titles to stay. Defaults to 70.fadeOut
- time in ticks for titles to fade out. Defaults to 20.void resetTitle()
void spawnParticle(@NotNull Particle particle, @NotNull Location location, int count)
particle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesvoid spawnParticle(@NotNull Particle particle, double x, double y, double z, int count)
particle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particles<T> void spawnParticle(@NotNull Particle particle, @NotNull Location location, int count, @Nullable T data)
T
- type of particle data (see Particle.getDataType()
T
- Typeparticle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesdata
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
<T> void spawnParticle(@NotNull Particle particle, double x, double y, double z, int count, @Nullable T data)
T
- type of particle data (see Particle.getDataType()
T
- Typeparticle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesdata
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
void spawnParticle(@NotNull Particle particle, @NotNull Location location, int count, double offsetX, double offsetY, double offsetZ)
particle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisvoid spawnParticle(@NotNull Particle particle, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ)
particle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axis<T> void spawnParticle(@NotNull Particle particle, @NotNull Location location, int count, double offsetX, double offsetY, double offsetZ, @Nullable T data)
T
- type of particle data (see Particle.getDataType()
T
- Typeparticle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisdata
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
<T> void spawnParticle(@NotNull Particle particle, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ, @Nullable T data)
T
- type of particle data (see Particle.getDataType()
T
- Typeparticle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisdata
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
void spawnParticle(@NotNull Particle particle, @NotNull Location location, int count, double offsetX, double offsetY, double offsetZ, double extra)
particle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)void spawnParticle(@NotNull Particle particle, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ, double extra)
particle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)<T> void spawnParticle(@NotNull Particle particle, @NotNull Location location, int count, double offsetX, double offsetY, double offsetZ, double extra, @Nullable T data)
T
- type of particle data (see Particle.getDataType()
T
- Typeparticle
- the particle to spawnlocation
- the location to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)data
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
<T> void spawnParticle(@NotNull Particle particle, double x, double y, double z, int count, double offsetX, double offsetY, double offsetZ, double extra, @Nullable T data)
T
- type of particle data (see Particle.getDataType()
T
- Typeparticle
- the particle to spawnx
- the position on the x axis to spawn aty
- the position on the y axis to spawn atz
- the position on the z axis to spawn atcount
- the number of particlesoffsetX
- the maximum random offset on the X axisoffsetY
- the maximum random offset on the Y axisoffsetZ
- the maximum random offset on the Z axisextra
- the extra data for this particle, depends on the
particle used (normally speed)data
- the data to use for the particle or null,
the type of this depends on Particle.getDataType()
@NotNull AdvancementProgress getAdvancementProgress(@NotNull Advancement advancement)
advancement
- advancementint getClientViewDistance()
@NotNull String getLocale()
boolean getAffectsSpawning()
void setAffectsSpawning(boolean affects)
affects
- Whether the player can affect mob spawningint getViewDistance()
void setViewDistance(int viewDistance)
viewDistance
- the player's view distancevoid updateCommands()
void openBook(@NotNull ItemStack book)
Material.WRITTEN_BOOK
for a Playerbook
- The book to open for this playervoid setResourcePack(@NotNull String url, @NotNull String hash)
The player's client will download the new resource pack asynchronously in the background, and will automatically switch to it once the download is complete. If the client has downloaded and cached the same resource pack in the past, it will perform a quick timestamp check over the network to determine if the resource pack has changed and needs to be downloaded again. When this request is sent for the very first time from a given server, the client will first display a confirmation GUI to the player before proceeding with the download.
Notes:
url
- The URL from which the client will download the resource
pack. The string must contain only US-ASCII characters and should
be encoded as per RFC 1738.hash
- A 40 character hexadecimal and lowercase SHA-1 digest of
the resource pack file.IllegalArgumentException
- Thrown if the URL is null.IllegalArgumentException
- Thrown if the URL is too long. The
length restriction is an implementation specific arbitrary value.@Nullable PlayerResourcePackStatusEvent.Status getResourcePackStatus()
@Nullable @Deprecated String getResourcePackHash()
boolean hasResourcePack()
PlayerResourcePackStatusEvent.Status.SUCCESSFULLY_LOADED
@NotNull PlayerProfile getPlayerProfile()
void setPlayerProfile(@NotNull PlayerProfile profile)
profile
- The new profile to usefloat getCooldownPeriod()
float getCooledAttackStrength(float adjustTicks)
adjustTicks
- Amount of ticks to add to cooldown counter for this calculationvoid resetCooldown()
@NotNull Player.Spigot spigot()
spigot
in interface CommandSender
spigot
in interface Entity
Copyright © 2022. All rights reserved.