Package com.velocitypowered.api.proxy

Interface Player

All Superinterfaces:
Audience, ChannelMessageSink, ChannelMessageSource, CommandSource, HoverEventSource<HoverEvent.ShowEntity>, Identified, InboundConnection, net.kyori.adventure.key.Keyed, PermissionSubject, Pointered
public interface Player extends CommandSource, Identified, InboundConnection, ChannelMessageSource, ChannelMessageSink, HoverEventSource<HoverEvent.ShowEntity>, net.kyori.adventure.key.Keyed
Represents a player who is connected to the proxy.

  • Method Details

    • getUsername

      String getUsername()
      Returns the player's current username.
      Returns:
      the username

    • getEffectiveLocale

      @Nullable Locale getEffectiveLocale()
      Returns the locale the proxy will use to send messages translated via the Adventure global translator. By default, the value of PlayerSettings.getLocale() is used.

      This can be null when the client has not yet connected to any server.

      Returns:
      the locale.

    • setEffectiveLocale

      void setEffectiveLocale(Locale locale)
      Change the locale the proxy will be translating its messages to.
      Parameters:
      locale - the locale to translate to

    • getUniqueId

      UUID getUniqueId()
      Returns the player's UUID.
      Returns:
      the UUID

    • getCurrentServer

      Optional<ServerConnection> getCurrentServer()
      Returns the server that the player is currently connected to.
      Returns:
      an Optional the server that the player is connected to, which may be empty

    • getPlayerSettings

      PlayerSettings getPlayerSettings()
      Returns the player's client settings.
      Returns:
      the settings

    • getModInfo

      Optional<ModInfo> getModInfo()
      Returns the player's mod info if they have a modded client.
      Returns:
      an Optional the mod info. which may be empty

    • getPing

      long getPing()
      Gets the player's estimated ping in milliseconds.
      Returns:
      the player's ping or -1 if ping information is currently unknown

    • isOnlineMode

      boolean isOnlineMode()
      Returns the player's connection status.
      Returns:
      true if the player is authenticated with Mojang servers

    • createConnectionRequest

      ConnectionRequestBuilder createConnectionRequest(RegisteredServer server)
      Creates a new connection request so that the player can connect to another server.
      Parameters:
      server - the server to connect to
      Returns:
      a new connection request

    • getGameProfileProperties

      List<GameProfile.Property> getGameProfileProperties()
      Gets the player's profile properties.

      The returned list may be unmodifiable.

      Returns:
      the player's profile properties

    • setGameProfileProperties

      void setGameProfileProperties(List<GameProfile.Property> properties)
      Sets the player's profile properties.
      Parameters:
      properties - the properties

    • getGameProfile

      GameProfile getGameProfile()
      Returns the player's game profile.

    • clearHeaderAndFooter

      @Deprecated void clearHeaderAndFooter()
      Deprecated.
      Use TabList.clearHeaderAndFooter().
      Clears the tab list header and footer for the player.

    • getPlayerListHeader

      Component getPlayerListHeader()
      Returns the player's player list header.
      Returns:
      this player's player list header

    • getPlayerListFooter

      Component getPlayerListFooter()
      Returns the player's player list footer.
      Returns:
      this player's tab list

    • getTabList

      TabList getTabList()
      Returns the player's tab list.
      Returns:
      this player's tab list

    • disconnect

      void disconnect(Component reason)
      Disconnects the player with the specified reason. Once this method is called, further calls to other Player methods will become undefined.
      Parameters:
      reason - component with the reason

    • spoofChatInput

      void spoofChatInput(String input)
      Sends chat input onto the players current server as if they typed it into the client chat box.
      Parameters:
      input - the chat input to send

    • sendResourcePack

      @Deprecated void sendResourcePack(String url)
      Deprecated.
      Use sendResourcePackOffer(ResourcePackInfo) instead
      Sends the specified resource pack from url to the user. If at all possible, send the resource pack using sendResourcePack(String, byte[]). To monitor the status of the sent resource pack, subscribe to PlayerResourcePackStatusEvent.
      Parameters:
      url - the URL for the resource pack

    • sendResourcePack

      @Deprecated void sendResourcePack(String url, byte[] hash)
      Deprecated.
      Use sendResourcePackOffer(ResourcePackInfo) instead
      Sends the specified resource pack from url to the user, using the specified 20-byte SHA-1 hash. To monitor the status of the sent resource pack, subscribe to PlayerResourcePackStatusEvent.
      Parameters:
      url - the URL for the resource pack
      hash - the SHA-1 hash value for the resource pack

    • sendResourcePackOffer

      void sendResourcePackOffer(ResourcePackInfo packInfo)
      Queues and sends a new Resource-pack offer to the player. To monitor the status of the sent resource pack, subscribe to PlayerResourcePackStatusEvent. To create a ResourcePackInfo use the ProxyServer.createResourcePackBuilder(String) builder.
      Parameters:
      packInfo - the resource-pack in question

    • getAppliedResourcePack

      @Nullable ResourcePackInfo getAppliedResourcePack()
      Gets the ResourcePackInfo of the currently applied resource-pack or null if none.
      Returns:
      the applied resource pack or null if none.

    • getPendingResourcePack

      @Nullable ResourcePackInfo getPendingResourcePack()
      Gets the ResourcePackInfo of the resource pack the user is currently downloading or is currently prompted to install or null if none.
      Returns:
      the pending resource pack or null if none

    • sendPluginMessage

      boolean sendPluginMessage(ChannelIdentifier identifier, byte[] data)
      Note that this method does not send a plugin message to the server the player is connected to. You should only use this method if you are trying to communicate with a mod that is installed on the player's client. To send a plugin message to the server from the player, you should use the equivalent method on the instance returned by getCurrentServer().
      Specified by:
      sendPluginMessage in interface ChannelMessageSink
      Parameters:
      identifier - the channel identifier to send the message on
      data - the data to send
      Returns:
      whether or not the message could be sent

    • key

      @NotNull default @NotNull net.kyori.adventure.key.Key key()
      Specified by:
      key in interface net.kyori.adventure.key.Keyed

    • asHoverEvent

      @NotNull default @NotNull HoverEvent<HoverEvent.ShowEntity> asHoverEvent(@NotNull @NotNull UnaryOperator<HoverEvent.ShowEntity> op)
      Specified by:
      asHoverEvent in interface HoverEventSource<HoverEvent.ShowEntity>

    • getClientBrand

      @Nullable String getClientBrand()
      Gets the player's client brand.
      Returns:
      the player's client brand