org.bukkit.entity
Interface Player

All Superinterfaces:
AnimalTamer, CommandSender, ConfigurationSerializable, Conversable, Damageable, Entity, HumanEntity, InventoryHolder, LivingEntity, Metadatable, OfflinePlayer, Permissible, PluginMessageRecipient, ServerOperator

public interface Player
extends HumanEntity, Conversable, CommandSender, OfflinePlayer, PluginMessageRecipient

Represents a player, connected or not


Method Summary
 void awardAchievement(Achievement achievement)
          Awards this player the given achievement
 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).
 InetSocketAddress getAddress()
          Gets the socket address of this player
 boolean getAllowFlight()
          Determines if the Player is allowed to fly via jump key double-tap like in creative mode.
 Location getBedSpawnLocation()
          Gets the Location where the player will spawn at their bed, null if they have not slept in one or their current bed spawn is invalid.
 Location getCompassTarget()
          Get the previously set compass target.
 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
 int getLevel()
          Gets the players current experience level
 String getPlayerListName()
          Gets the name that is shown on the player list.
 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.
 float getSaturation()
          Gets the players current saturation level.
 int getTotalExperience()
          Gets the players total experience points
 float getWalkSpeed()
          Gets the current allowed speed that a client can walk.
 void giveExp(int amount)
          Gives the player the amount of experience specified.
 void giveExpLevels(int amount)
          Gives the player the amount of experience levels specified.
 void hidePlayer(Player player)
          Hides a player from this player
 void incrementStatistic(Statistic statistic)
          Increments the given statistic for this player
 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 isOnGround()
          Deprecated. Inconsistent with org.bukkit.craftbukkit.entity.Entity#isOnGround()
 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

Note: This will overwrite the players current inventory, health, motion, etc, with the state from the saved dat file.

 boolean performCommand(String command)
          Makes the player perform the given command
 void playEffect(Location loc, Effect effect, int data)
          Plays an effect to just this player.
<T> void
playEffect(Location loc, Effect effect, T data)
          Plays an effect to just this player.
 void playNote(Location loc, byte instrument, byte note)
          Play a note for a player at a location.
 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 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 saveData()
          Saves the players current location, health, inventory, motion, and other information into the username.dat file, in the world/player folder
 void sendBlockChange(Location loc, int material, byte data)
          Send a block change.
 void sendBlockChange(Location loc, Material material, byte data)
          Send a block change.
 boolean sendChunkChange(Location loc, int sx, int sy, int sz, byte[] data)
          Send a chunk change.
 void sendMap(MapView map)
          Render a map and send it to the player in its entirety.
 void sendRawMessage(String message)
          Sends this sender a message raw
 void setAllowFlight(boolean flight)
          Sets if the Player is allowed to fly via jump key double-tap like in creative mode.
 void setBedSpawnLocation(Location location)
          Sets the Location where the player will spawn at their bed.
 void setBedSpawnLocation(Location location, boolean force)
          Sets the Location where the player will spawn at their bed.
 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

This is a percentage value.

 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 setLevel(int level)
          Sets the players current experience level
 void setPlayerListName(String name)
          Sets the name that is shown on the in-game player list.
 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 setSaturation(float value)
          Sets the players current saturation level
 void setSleepingIgnored(boolean isSleeping)
          Sets whether the player is ignored as not sleeping.
 void setSneaking(boolean sneak)
          Sets the sneak mode the player
 void setSprinting(boolean sprinting)
          Sets whether the player is sprinting or not.
 void setTexturePack(String url)
          Request that the player's client download and switch texture packs.
 void setTotalExperience(int exp)
          Sets the players current experience level
 void setWalkSpeed(float value)
          Sets the speed at which a client will walk.
 void showPlayer(Player player)
          Allows this player to see a player that was previously hidden
 void updateInventory()
          Deprecated. This method should not be relied upon as it is a temporary work-around for a larger, more complicated issue.
 
Methods inherited from interface org.bukkit.entity.HumanEntity
closeInventory, getEnderChest, getExpToLevel, getGameMode, getInventory, getItemInHand, getItemOnCursor, getName, getOpenInventory, getSleepTicks, isBlocking, isSleeping, openEnchanting, openInventory, openInventory, openWorkbench, setGameMode, setItemInHand, setItemOnCursor, setWindowProperty
 
Methods inherited from interface org.bukkit.entity.LivingEntity
addPotionEffect, addPotionEffect, addPotionEffects, getActivePotionEffects, getCanPickupItems, getCustomName, getEquipment, getEyeHeight, getEyeHeight, getEyeLocation, getKiller, getLastDamage, getLastTwoTargetBlocks, getLineOfSight, getMaximumAir, getMaximumNoDamageTicks, getNoDamageTicks, getRemainingAir, getRemoveWhenFarAway, getTargetBlock, hasLineOfSight, hasPotionEffect, isCustomNameVisible, launchProjectile, removePotionEffect, setCanPickupItems, setCustomName, setCustomNameVisible, setLastDamage, setMaximumAir, setMaximumNoDamageTicks, setNoDamageTicks, setRemainingAir, setRemoveWhenFarAway, shootArrow, throwEgg, throwSnowball
 
Methods inherited from interface org.bukkit.entity.Damageable
damage, damage, getHealth, getMaxHealth, resetMaxHealth, setHealth, setMaxHealth
 
Methods inherited from interface org.bukkit.permissions.Permissible
addAttachment, addAttachment, addAttachment, addAttachment, getEffectivePermissions, hasPermission, hasPermission, isPermissionSet, isPermissionSet, recalculatePermissions, removeAttachment
 
Methods inherited from interface org.bukkit.permissions.ServerOperator
isOp, setOp
 
Methods inherited from interface org.bukkit.conversations.Conversable
abandonConversation, abandonConversation, acceptConversationInput, beginConversation, isConversing
 
Methods inherited from interface org.bukkit.command.CommandSender
getName, getServer, sendMessage, sendMessage
 
Methods inherited from interface org.bukkit.permissions.Permissible
addAttachment, addAttachment, addAttachment, addAttachment, getEffectivePermissions, hasPermission, hasPermission, isPermissionSet, isPermissionSet, recalculatePermissions, removeAttachment
 
Methods inherited from interface org.bukkit.permissions.ServerOperator
isOp, setOp
 
Methods inherited from interface org.bukkit.OfflinePlayer
getFirstPlayed, getLastPlayed, getName, getPlayer, hasPlayedBefore, isBanned, isOnline, isWhitelisted, setBanned, setWhitelisted
 
Methods inherited from interface org.bukkit.configuration.serialization.ConfigurationSerializable
serialize
 
Methods inherited from interface org.bukkit.plugin.messaging.PluginMessageRecipient
getListeningPluginChannels, sendPluginMessage
 

Method Detail

getDisplayName

String getDisplayName()
Gets the "friendly" name to display of this player. This may include color.

Note that this name will not be displayed in game, only in chat and places defined by plugins

Returns:
the friendly name

setDisplayName

void setDisplayName(String name)
Sets the "friendly" name to display of this player. This may include color.

Note that this name will not be displayed in game, only in chat and places defined by plugins

Parameters:
name - The new display name.

getPlayerListName

String getPlayerListName()
Gets the name that is shown on the player list.

Returns:
the player list name

setPlayerListName

void setPlayerListName(String name)
Sets the name that is shown on the in-game player list.

The name cannot be longer than 16 characters, but ChatColor is supported.

If the value is null, the name will be identical to HumanEntity.getName().

This name is case sensitive and unique, two names with different casing will appear as two different people. If a player joins afterwards with a name that conflicts with a player's custom list name, the joining player's player list name will have a random number appended to it (1-2 characters long in the default implementation). If the joining player's name is 15 or 16 characters long, part of the name will be truncated at the end to allow the addition of the two digits.

Parameters:
name - new player list name
Throws:
IllegalArgumentException - if the name is already used by someone else
IllegalArgumentException - if the length of the name is too long

setCompassTarget

void setCompassTarget(Location loc)
Set the target of the player's compass.

Parameters:
loc - Location to point to

getCompassTarget

Location getCompassTarget()
Get the previously set compass target.

Returns:
location of the target

getAddress

InetSocketAddress getAddress()
Gets the socket address of this player

Returns:
the player's address

sendRawMessage

void sendRawMessage(String message)
Sends this sender a message raw

Specified by:
sendRawMessage in interface Conversable
Parameters:
message - Message to be displayed

kickPlayer

void kickPlayer(String message)
Kicks player with custom kick message.

Parameters:
message - kick message

chat

void chat(String msg)
Says a message (or runs a command).

Parameters:
msg - message to print

performCommand

boolean performCommand(String command)
Makes the player perform the given command

Parameters:
command - Command to perform
Returns:
true if the command was successful, otherwise false

isSneaking

boolean isSneaking()
Returns if the player is in sneak mode

Returns:
true if player is in sneak mode

setSneaking

void setSneaking(boolean sneak)
Sets the sneak mode the player

Parameters:
sneak - true if player should appear sneaking

isSprinting

boolean isSprinting()
Gets whether the player is sprinting or not.

Returns:
true if player is sprinting.

setSprinting

void setSprinting(boolean sprinting)
Sets whether the player is sprinting or not.

Parameters:
sprinting - true if the player should be sprinting

saveData

void saveData()
Saves the players current location, health, inventory, motion, and other information into the username.dat file, in the world/player folder


loadData

void loadData()
Loads the players current location, health, inventory, motion, and other information from the username.dat file, in the world/player folder

Note: This will overwrite the players current inventory, health, motion, etc, with the state from the saved dat file.


setSleepingIgnored

void setSleepingIgnored(boolean isSleeping)
Sets whether the player is ignored as not sleeping. If everyone is either sleeping or has this flag set, then time will advance to the next day. If everyone has this flag set but no one is actually in bed, then nothing will happen.

Parameters:
isSleeping - Whether to ignore.

isSleepingIgnored

boolean isSleepingIgnored()
Returns whether the player is sleeping ignored.

Returns:
Whether player is ignoring sleep.

playNote

void playNote(Location loc,
              byte instrument,
              byte note)
Play a note for a player at a location. This requires a note block at the particular location (as far as the client is concerned). This will not work without a note block. This will not work with cake.

Parameters:
loc - The location of a note block.
instrument - The instrument ID.
note - The note ID.

playNote

void playNote(Location loc,
              Instrument instrument,
              Note note)
Play a note for a player at a location. This requires a note block at the particular location (as far as the client is concerned). This will not work without a note block. This will not work with cake.

Parameters:
loc - The location of a note block
instrument - The instrument
note - The note

playSound

void playSound(Location location,
               Sound sound,
               float volume,
               float pitch)
Play a sound for a player at the location.

This function will fail silently if Location or Sound are null.

Parameters:
location - The location to play the sound
sound - The sound to play
volume - The volume of the sound
pitch - The pitch of the sound

playEffect

void playEffect(Location loc,
                Effect effect,
                int data)
Plays an effect to just this player.

Parameters:
loc - the location to play the effect at
effect - the Effect
data - a data bit needed for some effects

playEffect

<T> void playEffect(Location loc,
                    Effect effect,
                    T data)
Plays an effect to just this player.

Parameters:
loc - the location to play the effect at
effect - the Effect
data - a data bit needed for some effects

sendBlockChange

void sendBlockChange(Location loc,
                     Material material,
                     byte data)
Send a block change. This fakes a block change packet for a user at a certain location. This will not actually change the world in any way.

Parameters:
loc - The location of the changed block
material - The new block
data - The block data

sendChunkChange

boolean sendChunkChange(Location loc,
                        int sx,
                        int sy,
                        int sz,
                        byte[] data)
Send a chunk change. This fakes a chunk change packet for a user at a certain location. The updated cuboid must be entirely within a single chunk. This will not actually change the world in any way.

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.

Parameters:
loc - The location of the cuboid
sx - The x size of the cuboid
sy - The y size of the cuboid
sz - The z size of the cuboid
data - The data to be sent
Returns:
true if the chunk change packet was sent

sendBlockChange

void sendBlockChange(Location loc,
                     int material,
                     byte data)
Send a block change. This fakes a block change packet for a user at a certain location. This will not actually change the world in any way.

Parameters:
loc - The location of the changed block
material - The new block ID
data - The block data

sendMap

void sendMap(MapView map)
Render a map and send it to the player in its entirety. This may be used when streaming the map in the normal manner is not desirbale.

Parameters:
map - The map to be sent

updateInventory

@Deprecated
void updateInventory()
Deprecated. This method should not be relied upon as it is a temporary work-around for a larger, more complicated issue.

Forces an update of the player's entire inventory.


awardAchievement

void awardAchievement(Achievement achievement)
Awards this player the given achievement

Parameters:
achievement - Achievement to award

incrementStatistic

void incrementStatistic(Statistic statistic)
Increments the given statistic for this player

Parameters:
statistic - Statistic to increment

incrementStatistic

void incrementStatistic(Statistic statistic,
                        int amount)
Increments the given statistic for this player

Parameters:
statistic - Statistic to increment
amount - Amount to increment this statistic by

incrementStatistic

void incrementStatistic(Statistic statistic,
                        Material material)
Increments the given statistic for this player for the given material

Parameters:
statistic - Statistic to increment
material - Material to offset the statistic with

incrementStatistic

void incrementStatistic(Statistic statistic,
                        Material material,
                        int amount)
Increments the given statistic for this player for the given material

Parameters:
statistic - Statistic to increment
material - Material to offset the statistic with
amount - Amount to increment this statistic by

setPlayerTime

void setPlayerTime(long time,
                   boolean relative)
Sets the current time on the player's client. When relative is true the player's time will be kept synchronized to its world time with the specified offset.

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().

Parameters:
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.

getPlayerTime

long getPlayerTime()
Returns the player's current timestamp.

Returns:
The player's time

getPlayerTimeOffset

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.

Returns:
The player's time

isPlayerTimeRelative

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().

Returns:
true if the player's time is relative to the server time.

resetPlayerTime

void resetPlayerTime()
Restores the normal condition where the player's time is synchronized with the server time. Equivalent to calling setPlayerTime(0, true).


setPlayerWeather

void setPlayerWeather(WeatherType type)
Sets the type of weather the player will see. When used, the weather status of the player is locked until resetPlayerWeather() is used.

Parameters:
type - The WeatherType enum type the player should experience

getPlayerWeather

WeatherType getPlayerWeather()
Returns the type of weather the player is currently experiencing.

Returns:
The WeatherType that the player is currently experiencing or null if player is seeing server weather.

resetPlayerWeather

void resetPlayerWeather()
Restores the normal condition where the player's weather is controlled by server conditions.


giveExp

void giveExp(int amount)
Gives the player the amount of experience specified.

Parameters:
amount - Exp amount to give

giveExpLevels

void giveExpLevels(int amount)
Gives the player the amount of experience levels specified. Levels can be taken by specifying a negative amount.

Parameters:
amount - amount of experience levels to give or take

getExp

float getExp()
Gets the players current experience points towards the next level.

This is a percentage value. 0 is "no progress" and 1 is "next level".

Returns:
Current experience points

setExp

void setExp(float exp)
Sets the players current experience points towards the next level

This is a percentage value. 0 is "no progress" and 1 is "next level".

Parameters:
exp - New experience points

getLevel

int getLevel()
Gets the players current experience level

Returns:
Current experience level

setLevel

void setLevel(int level)
Sets the players current experience level

Parameters:
level - New experience level

getTotalExperience

int getTotalExperience()
Gets the players total experience points

Returns:
Current total experience points

setTotalExperience

void setTotalExperience(int exp)
Sets the players current experience level

Parameters:
exp - New experience level

getExhaustion

float getExhaustion()
Gets the players current exhaustion level.

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.

Returns:
Exhaustion level

setExhaustion

void setExhaustion(float value)
Sets the players current exhaustion level

Parameters:
value - Exhaustion level

getSaturation

float getSaturation()
Gets the players current saturation level.

Saturation is a buffer for food level. Your food level will not drop if you are saturated > 0.

Returns:
Saturation level

setSaturation

void setSaturation(float value)
Sets the players current saturation level

Parameters:
value - Exhaustion level

getFoodLevel

int getFoodLevel()
Gets the players current food level

Returns:
Food level

setFoodLevel

void setFoodLevel(int value)
Sets the players current food level

Parameters:
value - New food level

getBedSpawnLocation

Location getBedSpawnLocation()
Gets the Location where the player will spawn at their bed, null if they have not slept in one or their current bed spawn is invalid.

Specified by:
getBedSpawnLocation in interface OfflinePlayer
Returns:
Bed Spawn Location if bed exists, otherwise null.

setBedSpawnLocation

void setBedSpawnLocation(Location location)
Sets the Location where the player will spawn at their bed.

Parameters:
location - where to set the respawn location

setBedSpawnLocation

void setBedSpawnLocation(Location location,
                         boolean force)
Sets the Location where the player will spawn at their bed.

Parameters:
location - where to set the respawn location
force - whether to forcefully set the respawn location even if a valid bed is not present

getAllowFlight

boolean getAllowFlight()
Determines if the Player is allowed to fly via jump key double-tap like in creative mode.

Returns:
True if the player is allowed to fly.

setAllowFlight

void setAllowFlight(boolean flight)
Sets if the Player is allowed to fly via jump key double-tap like in creative mode.

Parameters:
flight - If flight should be allowed.

hidePlayer

void hidePlayer(Player player)
Hides a player from this player

Parameters:
player - Player to hide

showPlayer

void showPlayer(Player player)
Allows this player to see a player that was previously hidden

Parameters:
player - Player to show

canSee

boolean canSee(Player player)
Checks to see if a player has been hidden from this player

Parameters:
player - Player to check
Returns:
True if the provided player is not being hidden from this player

isOnGround

@Deprecated
boolean isOnGround()
Deprecated. Inconsistent with org.bukkit.craftbukkit.entity.Entity#isOnGround()

Checks to see if this player is currently standing on a block. This information may not be reliable, as it is a state provided by the client, and may therefore not be accurate.

Specified by:
isOnGround in interface Entity
Returns:
True if the player standing on a solid block, else false.

isFlying

boolean isFlying()
Checks to see if this player is currently flying or not.

Returns:
True if the player is flying, else false.

setFlying

void setFlying(boolean value)
Makes this player start or stop flying.

Parameters:
value - True to fly.

setFlySpeed

void setFlySpeed(float value)
                 throws IllegalArgumentException
Sets the speed at which a client will fly. Negative values indicate reverse directions.

Parameters:
value - The new speed, from -1 to 1.
Throws:
IllegalArgumentException - If new speed is less than -1 or greater than 1

setWalkSpeed

void setWalkSpeed(float value)
                  throws IllegalArgumentException
Sets the speed at which a client will walk. Negative values indicate reverse directions.

Parameters:
value - The new speed, from -1 to 1.
Throws:
IllegalArgumentException - If new speed is less than -1 or greater than 1

getFlySpeed

float getFlySpeed()
Gets the current allowed speed that a client can fly.

Returns:
The current allowed speed, from -1 to 1

getWalkSpeed

float getWalkSpeed()
Gets the current allowed speed that a client can walk.

Returns:
The current allowed speed, from -1 to 1

setTexturePack

void setTexturePack(String url)
Request that the player's client download and switch texture packs.

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 quick timestamp check over the network 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:

Parameters:
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.
Throws:
IllegalArgumentException - Thrown if the URL is null.
IllegalArgumentException - Thrown if the URL is too long.


Copyright © 2013. All Rights Reserved.