Package com.plotsquared.core.util

Class PlayerManager<P extends PlotPlayer<? extends T>,T>

java.lang.Object

com.plotsquared.core.util.PlayerManager<P,T>

public abstract class PlayerManager<P extends PlotPlayer<? extends T>,T>
extends Object

Manages player instances

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	PlayerManager.NoSuchPlayerException

Constructor Summary

Constructors

Constructor	Description
PlayerManager()

Method Summary

Modifier and Type	Method	Description
abstract @NonNull P	createPlayer(@NonNull UUID uuid)
static @NonNull String	getName(@Nullable UUID owner)	Deprecated, for removal: This API element is subject to removal in a future version. Use resolveName(UUID)
static @NonNull String	getName(@Nullable UUID owner, boolean blocking)	Deprecated, for removal: This API element is subject to removal in a future version. Use resolveName(UUID, boolean)
abstract @Nullable OfflinePlotPlayer	getOfflinePlayer(@NonNull String username)	Get an offline player object from the player's username
abstract @Nullable OfflinePlotPlayer	getOfflinePlayer(@Nullable UUID uuid)	Get an an offline player object from the player's UUID
@NonNull P	getPlayer(@NonNull UUID uuid)	Get a plot player from a UUID.
abstract @NonNull P	getPlayer(@NonNull T object)	Get a plot player from a platform player object.
@Nullable P	getPlayerIfExists(@Nullable String name)
@Nullable P	getPlayerIfExists(@Nullable UUID uuid)	Get the player from its UUID if it is stored in the player map.
static @NonNull Component	getPlayerList(@NonNull Collection<UUID> uuids, LocaleHolder localeHolder)	Get a list of names given a list of UUIDs.
Collection<P>	getPlayers()	Get all online players
static void	getUUIDsFromString(@NonNull String list, @NonNull BiConsumer<Collection<UUID>,Throwable> consumer)
void	removePlayer(@NonNull PlotPlayer<?> plotPlayer)	Remove a player from the player map
void	removePlayer(@NonNull UUID uuid)	Remove a player from the player map
static @NonNull Caption	resolveName(@Nullable UUID owner)	Attempts to resolve the username by an uuid
static @NonNull Caption	resolveName(@Nullable UUID owner, boolean blocking)	Attempts to resolve the username by an uuid

Methods inherited from class java.lang.Object

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

Constructor Details

PlayerManager

public PlayerManager()

Method Details

getUUIDsFromString

public static void getUUIDsFromString(@NonNull String list,
 @NonNull BiConsumer<Collection<UUID>,Throwable> consumer)

getPlayerList

public static @NonNull Component getPlayerList(@NonNull Collection<UUID> uuids,
 LocaleHolder localeHolder)

Get a list of names given a list of UUIDs. - Uses the format TranslatableCaption.of(String) of "info.plot_user_list" for the returned string

Parameters:

uuids - UUIDs

localeHolder - the localeHolder to localize the component for

Returns:

Component of name list

getName

@Deprecated(forRemoval=true,
            since="6.4.0")
public static @NonNull String getName(@Nullable UUID owner)

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

Use resolveName(UUID)

Get the name from a UUID.

Parameters:

owner - Owner UUID

Returns:

The player's name, None, Everyone or Unknown

getName

@Deprecated(forRemoval=true,
            since="6.4.0")
public static @NonNull String getName(@Nullable UUID owner,
 boolean blocking)

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

Use resolveName(UUID, boolean)

Get the name from a UUID.

Parameters:

owner - Owner UUID

blocking - Whether or not the operation can be blocking

Returns:

The player's name, None, Everyone or Unknown

resolveName

public static @NonNull Caption resolveName(@Nullable UUID owner)

Attempts to resolve the username by an uuid

Note: blocks the thread until the name was resolved or failed

Parameters:

owner - The UUID of the owner

Returns:

A caption containing either the name, None, Everyone or Unknown

Since:

6.4.0

See Also:

• resolveName(UUID, boolean)

resolveName

public static @NonNull Caption resolveName(@Nullable UUID owner,
 boolean blocking)

Attempts to resolve the username by an uuid

Parameters:

owner - The UUID of the owner

blocking - If the operation should block the current thread for Settings.UUID.BLOCKING_TIMEOUT milliseconds

Returns:

A caption containing either the name, None, Everyone or Unknown

Since:

6.4.0

removePlayer

public void removePlayer(@NonNull PlotPlayer<?> plotPlayer)

Remove a player from the player map

Parameters:

plotPlayer - Player to remove

removePlayer

public void removePlayer(@NonNull UUID uuid)

Remove a player from the player map

Parameters:

uuid - Player to remove

getPlayerIfExists

public @Nullable P getPlayerIfExists(@Nullable UUID uuid)

Get the player from its UUID if it is stored in the player map.

Parameters:

uuid - Player UUID

Returns:

Player, or null

getPlayerIfExists

public @Nullable P getPlayerIfExists(@Nullable String name)

getPlayer

public abstract @NonNull P getPlayer(@NonNull T object)

Get a plot player from a platform player object. This method requires that the caller actually knows that the player exists and is online.

The method will throw an exception if there is no such player online.

Parameters:

object - Platform player object

Returns:

Player object

getPlayer

public @NonNull P getPlayer(@NonNull UUID uuid)

Get a plot player from a UUID. This method requires that the caller actually knows that the player exists.

The method will throw an exception if there is no such player online.

Parameters:

uuid - Player UUID

Returns:

Player object

createPlayer

public abstract @NonNull P createPlayer(@NonNull UUID uuid)

getOfflinePlayer

public abstract @Nullable OfflinePlotPlayer getOfflinePlayer(@Nullable UUID uuid)

Get an an offline player object from the player's UUID

Parameters:

uuid - Player UUID

Returns:

Offline player object

getOfflinePlayer

public abstract @Nullable OfflinePlotPlayer getOfflinePlayer(@NonNull String username)

Get an offline player object from the player's username

Parameters:

username - Player name

Returns:

Offline player object

getPlayers

public Collection<P> getPlayers()

Get all online players

Returns:

Unmodifiable collection of players