Package org.bukkit.event.player

Class PlayerLoginEvent

java.lang.Object

org.bukkit.event.Event

org.bukkit.event.player.PlayerEvent

org.bukkit.event.player.PlayerLoginEvent

public class PlayerLoginEvent
extends PlayerEvent

Stores details for players attempting to log in.
Note that this event is called early in the player initialization process. It is recommended that most options involving the Player entity be postponed to the PlayerJoinEvent instead.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	PlayerLoginEvent.Result	Basic kick reasons for communicating to plugins

Field Summary

Fields inherited from class org.bukkit.event.player.PlayerEvent

player

Constructor Summary

Constructors

Constructor	Description
PlayerLoginEvent(@NotNull Player player, @NotNull String hostname, @NotNull InetAddress address)
PlayerLoginEvent(@NotNull Player player, @NotNull String hostname, @NotNull InetAddress address, @NotNull InetAddress realAddress)
PlayerLoginEvent(@NotNull Player player, @NotNull String hostname, @NotNull InetAddress address, @NotNull PlayerLoginEvent.Result result, @NotNull String message, @NotNull InetAddress realAddress)	Deprecated, for removal: This API element is subject to removal in a future version.
PlayerLoginEvent(@NotNull Player player, @NotNull String hostname, @NotNull InetAddress address, @NotNull PlayerLoginEvent.Result result, Component message, @NotNull InetAddress realAddress)

Method Summary

Modifier and Type	Method	Description
void	allow()	Allows the player to log in
void	disallow(@NotNull PlayerLoginEvent.Result result, @NotNull String message)	Deprecated. in favour of disallow(Result, Component)
void	disallow(@NotNull PlayerLoginEvent.Result result, @NotNull Component message)	Disallows the player from logging in, with the given reason
@NotNull InetAddress	getAddress()	Gets the InetAddress for the Player associated with this event.
static @NotNull HandlerList	getHandlerList()
@NotNull HandlerList	getHandlers()
@NotNull String	getHostname()	Gets the hostname that the player used to connect to the server, or blank if unknown
@NotNull String	getKickMessage()	Deprecated. in favour of kickMessage()
@NotNull InetAddress	getRealAddress()	Gets the connection address of this player, regardless of whether it has been spoofed or not.
@NotNull PlayerLoginEvent.Result	getResult()	Gets the current result of the login, as an enum
@NotNull Component	kickMessage()	Gets the current kick message that will be used when the outcome is not allowed
void	kickMessage(@NotNull Component message)	Sets the kick message to display when the outcome is not allowed
void	setKickMessage(@NotNull String message)	Deprecated. in favour of kickMessage(Component)
void	setResult(@NotNull PlayerLoginEvent.Result result)	Sets the new result of the login, as an enum

Methods inherited from class org.bukkit.event.player.PlayerEvent

getPlayer

Methods inherited from class org.bukkit.event.Event

callEvent, getEventName, isAsynchronous

Methods inherited from class java.lang.Object

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

Constructor Details

PlayerLoginEvent

@Internal
public PlayerLoginEvent(@NotNull
 @NotNull Player player,
 @NotNull
 @NotNull String hostname,
 @NotNull
 @NotNull InetAddress address,
 @NotNull
 @NotNull InetAddress realAddress)

PlayerLoginEvent

@Internal
public PlayerLoginEvent(@NotNull
 @NotNull Player player,
 @NotNull
 @NotNull String hostname,
 @NotNull
 @NotNull InetAddress address)

PlayerLoginEvent

@Internal
@Deprecated(forRemoval=true)
public PlayerLoginEvent(@NotNull
 @NotNull Player player,
 @NotNull
 @NotNull String hostname,
 @NotNull
 @NotNull InetAddress address,
 @NotNull
 @NotNull PlayerLoginEvent.Result result,
 @NotNull
 @NotNull String message,
 @NotNull
 @NotNull InetAddress realAddress)

Deprecated, for removal: This API element is subject to removal in a future version.

PlayerLoginEvent

@Internal
public PlayerLoginEvent(@NotNull
 @NotNull Player player,
 @NotNull
 @NotNull String hostname,
 @NotNull
 @NotNull InetAddress address,
 @NotNull
 @NotNull PlayerLoginEvent.Result result,
 @NotNull
 Component message,
 @NotNull
 @NotNull InetAddress realAddress)

Method Details

getHostname

@NotNull
public @NotNull String getHostname()

Gets the hostname that the player used to connect to the server, or blank if unknown

Returns:

The hostname

getAddress

@NotNull
public @NotNull InetAddress getAddress()

Gets the InetAddress for the Player associated with this event. This method is provided as a workaround for player.getAddress() returning null during PlayerLoginEvent.

Returns:

The address for this player. For legacy compatibility, this may be null.

getRealAddress

@NotNull
public @NotNull InetAddress getRealAddress()

Gets the connection address of this player, regardless of whether it has been spoofed or not.

Returns:

the player's connection address

See Also:

• getAddress()

getResult

@NotNull
public @NotNull PlayerLoginEvent.Result getResult()

Gets the current result of the login, as an enum

Returns:

Current Result of the login

setResult

public void setResult(@NotNull
 @NotNull PlayerLoginEvent.Result result)

Sets the new result of the login, as an enum

Parameters:

result - New result to set

kickMessage

@NotNull
public @NotNull Component kickMessage()

Gets the current kick message that will be used when the outcome is not allowed

Returns:

Current kick message

kickMessage

public void kickMessage(@NotNull
 @NotNull Component message)

Sets the kick message to display when the outcome is not allowed

Parameters:

message - New kick message

getKickMessage

@NotNull
@Deprecated
public @NotNull String getKickMessage()

Deprecated.

in favour of kickMessage()

Gets the current kick message that will be used when the outcome is not allowed

Returns:

Current kick message

setKickMessage

@Deprecated
public void setKickMessage(@NotNull
 @NotNull String message)

Deprecated.

in favour of kickMessage(Component)

Sets the kick message to display when the outcome is not allowed

Parameters:

message - New kick message

allow

public void allow()

Allows the player to log in

disallow

@Deprecated
public void disallow(@NotNull
 @NotNull PlayerLoginEvent.Result result,
 @NotNull
 @NotNull String message)

Deprecated.

in favour of disallow(Result, Component)

Disallows the player from logging in, with the given reason

Parameters:

result - New result for disallowing the player

message - Kick message to display to the user

disallow

public void disallow(@NotNull
 @NotNull PlayerLoginEvent.Result result,
 @NotNull
 @NotNull Component message)

Disallows the player from logging in, with the given reason

Parameters:

result - New result for disallowing the player

message - Kick message to display to the user

getHandlers

@NotNull
public @NotNull HandlerList getHandlers()

Specified by:

getHandlers in class Event

getHandlerList

@NotNull
public static @NotNull HandlerList getHandlerList()