org.geysermc.floodgate.core.platform.command

Class CommandUtil

java.lang.Object

org.geysermc.floodgate.core.platform.command.CommandUtil

public abstract class CommandUtil
extends Object

An interface used across all Floodgate platforms to simple stuff in commands like kicking players and sending player messages independent of the Floodgate platform implementation.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.geysermc.floodgate.api.FloodgateApi	api
protected LanguageManager	manager

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CommandUtil(LanguageManager manager, org.geysermc.floodgate.api.FloodgateApi api)

Method Summary

Modifier and Type	Method and Description
protected Object	applyPlayerTypeFilter(Object player, PlayerType filter, Object fallback)
protected abstract Collection<?>	getOnlinePlayers()
Collection<Object>	getOnlinePlayersWithPermission(String permission) Get all online players with the given permission.
@NonNull Collection<String>	getOnlineUsernames(@NonNull PlayerType limitTo)
abstract Object	getPlayerByUsername(@NonNull String username)
Object	getPlayerByUsername(@NonNull String username, PlayerType filter)
abstract Object	getPlayerByUuid(@NonNull UUID uuid)
Object	getPlayerByUuid(@NonNull UUID uuid, PlayerType limitTo)
@Nullable ProfileAudience	getProfileAudience(@NonNull Object source, boolean allowOffline) Get a ProfileAudience from a source.
abstract @NonNull UserAudience	getUserAudience(@NonNull Object source)
protected abstract String	getUsernameFromSource(@NonNull Object source)
protected abstract UUID	getUuidFromSource(@NonNull Object source)
abstract boolean	hasPermission(Object player, String permission) Checks if the given player has the given permission.
abstract void	kickPlayer(Object player, String message) Kicks the given player using the given message as the kick reason.
boolean	removePlayerFromWhitelist(String xuid, String username) Removes the given Bedrock player from the whitelist.
boolean	removePlayerFromWhitelist(UUID uuid, String username) Removes the given Bedrock player from the whitelist.
abstract void	sendMessage(Object target, String message) Sends a raw message to the specified target, no matter what platform Floodgate is running on.
String	translateMessage(String locale, TranslatableMessage message, Object... args)
boolean	whitelistPlayer(String xuid, String username) Whitelist the given Bedrock player.
boolean	whitelistPlayer(UUID uuid, String username) Whitelist the given Bedrock player.

Methods inherited from class java.lang.Object

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

Field Detail

manager

protected final LanguageManager manager

api

protected final org.geysermc.floodgate.api.FloodgateApi api

Constructor Detail

CommandUtil

protected CommandUtil(LanguageManager manager,
                      org.geysermc.floodgate.api.FloodgateApi api)

Method Detail

getUserAudience

public abstract @NonNull UserAudience getUserAudience(@NonNull Object source)

getProfileAudience

public @Nullable ProfileAudience getProfileAudience(@NonNull Object source,
                                                    boolean allowOffline)

Get a ProfileAudience from a source. The source should be a platform-specific player instance when the player is online, and the username / uuid of the requested player when offline.

Parameters:

source - source to create a ProfileAudience from

allowOffline - if offline players are allowed

Returns:

a ProfileAudience unless allowOffline is false and the player isn't online

getUsernameFromSource

protected abstract String getUsernameFromSource(@NonNull Object source)

getUuidFromSource

protected abstract UUID getUuidFromSource(@NonNull Object source)

getOnlinePlayers

protected abstract Collection<?> getOnlinePlayers()

getOnlineUsernames

public @NonNull Collection<String> getOnlineUsernames(@NonNull PlayerType limitTo)

getPlayerByUuid

public abstract Object getPlayerByUuid(@NonNull UUID uuid)

getPlayerByUuid

public Object getPlayerByUuid(@NonNull UUID uuid,
                              PlayerType limitTo)

getPlayerByUsername

public abstract Object getPlayerByUsername(@NonNull String username)

getPlayerByUsername

public Object getPlayerByUsername(@NonNull String username,
                                  PlayerType filter)

applyPlayerTypeFilter

protected Object applyPlayerTypeFilter(Object player,
                                       PlayerType filter,
                                       Object fallback)

hasPermission

public abstract boolean hasPermission(Object player,
                                      String permission)

Checks if the given player has the given permission.

Parameters:

player - the player to check

permission - the permission to check

Returns:

true or false depending on if the player has the permission

getOnlinePlayersWithPermission

public Collection<Object> getOnlinePlayersWithPermission(String permission)

Get all online players with the given permission.

Parameters:

permission - the permission to check

Returns:

a list of online players that have the given permission

sendMessage

public abstract void sendMessage(Object target,
                                 String message)

Sends a raw message to the specified target, no matter what platform Floodgate is running on.

Parameters:

target - the player that should receive the message

message - the message

kickPlayer

public abstract void kickPlayer(Object player,
                                String message)

Kicks the given player using the given message as the kick reason.

Parameters:

player - the player that should be kicked

message - the command message

translateMessage

public String translateMessage(String locale,
                               TranslatableMessage message,
                               Object... args)

whitelistPlayer

public boolean whitelistPlayer(String xuid,
                               String username)

Whitelist the given Bedrock player.

Parameters:

xuid - the xuid of the username to be whitelisted

username - the username to be whitelisted

Returns:

true if the player has been whitelisted, false if the player was already whitelisted. Defaults to false when this platform doesn't support whitelisting.

whitelistPlayer

public boolean whitelistPlayer(UUID uuid,
                               String username)

Whitelist the given Bedrock player.

Parameters:

uuid - the UUID of the username to be whitelisted

username - the username to be whitelisted

Returns:

true if the player has been whitelisted, false if the player was already whitelisted. Defaults to false when this platform doesn't support whitelisting.

removePlayerFromWhitelist

public boolean removePlayerFromWhitelist(String xuid,
                                         String username)

Removes the given Bedrock player from the whitelist.

Parameters:

xuid - the xuid of the username to be removed from the whitelist

username - the username to be removed from the whitelist

Returns:

true if the player has been removed from the whitelist, false if the player wasn't whitelisted. Defaults to false when this platform doesn't support whitelisting.

removePlayerFromWhitelist

public boolean removePlayerFromWhitelist(UUID uuid,
                                         String username)

Removes the given Bedrock player from the whitelist.

Parameters:

uuid - the UUID of the username to be removed from the whitelist

username - the username to be removed from the whitelist

Returns:

true if the player has been removed from the whitelist, false if the player wasn't whitelisted. Defaults to false when this platform doesn't support whitelisting.