Interface ProxyServer

  • All Superinterfaces:
    Audience

    public interface ProxyServer
    extends Audience
    Provides an interface to a Minecraft server proxy.
    • Method Detail

      • shutdown

        void shutdown​(Component reason)
        Shuts down the proxy, kicking players with the specified reason.
        Parameters:
        reason - message to kick online players with
      • shutdown

        void shutdown()
        Shuts down the proxy, kicking players with the default reason.
      • getPlayer

        Optional<Player> getPlayer​(String username)
        Retrieves the player currently connected to this proxy by their Minecraft username. The search is case-insensitive.
        Parameters:
        username - the username to search for
        Returns:
        an Optional with the player, which may be empty
      • getPlayer

        Optional<Player> getPlayer​(UUID uuid)
        Retrieves the player currently connected to this proxy by their Minecraft UUID.
        Parameters:
        uuid - the UUID
        Returns:
        an Optional with the player, which may be empty
      • getAllPlayers

        Collection<Player> getAllPlayers()
        Retrieves all players currently connected to this proxy. This call may or may not be a snapshot of all players online.
        Returns:
        the players online on this proxy
      • getPlayerCount

        int getPlayerCount()
        Returns the number of players currently connected to this proxy.
        Returns:
        the players on this proxy
      • getServer

        Optional<RegisteredServer> getServer​(String name)
        Retrieves a registered RegisteredServer instance by its name. The search is case-insensitive.
        Parameters:
        name - the name of the server
        Returns:
        the registered server, which may be empty
      • matchPlayer

        Collection<Player> matchPlayer​(String partialName)
        Matches all Players whose names start with the provided partial name.
        Parameters:
        partialName - the partial name to check for
        Returns:
        a collection of mathed Players
      • registerServer

        RegisteredServer registerServer​(ServerInfo server)
        Registers a server with this proxy. A server with this name should not already exist.
        Parameters:
        server - the server to register
        Returns:
        the newly registered server
      • unregisterServer

        void unregisterServer​(ServerInfo server)
        Unregisters this server from the proxy.
        Parameters:
        server - the server to unregister
      • getConsoleCommandSource

        ConsoleCommandSource getConsoleCommandSource()
        Returns an instance of CommandSource that can be used to determine if the command is being invoked by the console or a console-like executor. Plugins that execute commands are strongly urged to implement their own CommandSource instead of using the console invoker.
        Returns:
        the console command invoker
      • getScheduler

        Scheduler getScheduler()
        Gets the Scheduler instance.
        Returns:
        the scheduler instance
      • getBoundAddress

        InetSocketAddress getBoundAddress()
        Gets the address that this proxy is bound to. This does not necessarily indicate the external IP address of the proxy.
        Returns:
        the address the proxy is bound to
      • getVersion

        ProxyVersion getVersion()
        Returns the version of the proxy.
        Returns:
        the proxy version
      • createBossBar

        @Deprecated
        @NonNull BossBar createBossBar​(net.kyori.text.Component title,
                                       @NonNull BossBarColor color,
                                       @NonNull BossBarOverlay overlay,
                                       float progress)
        Deprecated.
        Use BossBar instead
        Creates a new BossBar.
        Parameters:
        title - boss bar title
        color - boss bar color
        overlay - boss bar overlay
        progress - boss bar progress
        Returns:
        a completely new and fresh boss bar