Package org.spongepowered.api

Interface Server

    • Method Detail

      • isMultiWorldEnabled

        boolean isMultiWorldEnabled()
        Gets if multiple worlds will be loaded by the server.

        If false, no calls to loading worlds via the world manager or otherwise will load a world

        Returns:
        True if enabled, false if not

      • maxPlayers

        int maxPlayers()
        Gets the max players allowed to join.
        Returns:
        The max players

      • isWhitelistEnabled

        boolean isWhitelistEnabled()
        Gets if the whitelist is currently enforced.
        Returns:
        True if enabled, false if not

      • isOnlineModeEnabled

        boolean isOnlineModeEnabled()
        Gets if incoming connections are authenticated against Mojang's servers.
        Returns:
        True if enabled, false if not

      • motd

        Component motd()
        Gets the "message of the day" presented to clients who have this server saved as a connection profile in the multiplayer menu
        Returns:
        The message of the day

      • resourcePack

        java.util.Optional<ResourcePack> resourcePack()
        Gets the pack sent to clients when they join.
        Returns:
        The resource pack

      • playerIdleTimeout

        int playerIdleTimeout()
        Gets the player idle timeout, in minutes.

        A value of 0 means the timeout is disabled

        Returns:
        The player idle timeout

      • isHardcoreModeEnabled

        boolean isHardcoreModeEnabled()
        Gets if hardcode mode has been enabled.
        Returns:
        True if enabled, false if not

      • isGameModeEnforced

        boolean isGameModeEnforced()
        Gets if players will have their game mode set to the default. gameMode()
        Returns:
        True if enforced, false if not

      • isPVPEnabled

        boolean isPVPEnabled()
        Gets if pvp is enabled.
        Returns:
        True if enabled, false if not

      • areCommandBlocksEnabled

        boolean areCommandBlocksEnabled()
        Gets if command blocks will run commands.
        Returns:
        True if enabled, false if not

      • isMonsterSpawnsEnabled

        boolean isMonsterSpawnsEnabled()
        Gets if monsters will naturally spawn.
        Returns:
        True if enabled, false if not

      • isAnimalSpawnsEnabled

        boolean isAnimalSpawnsEnabled()
        Gets if animals will naturally spawn.
        Returns:
        True if enabled, false if not

      • isDedicatedServer

        boolean isDedicatedServer()
        Gets whether this server is dedicated to being a global server, or whether this server is local to a game client where a Client instance may be available.
        Returns:
        True if this is a dedicated server without a game client

      • onlinePlayers

        java.util.Collection<ServerPlayer> onlinePlayers()
        Gets the ServerPlayers currently online.
        Returns:
        A Collection of online players

      • player

        java.util.Optional<ServerPlayer> player​(java.util.UUID uniqueId)
        Gets a ServerPlayer by their UUID.
        Parameters:
        uniqueId - The UUID to get the player from
        Returns:
        The ServerPlayer or empty if not found

      • player

        java.util.Optional<ServerPlayer> player​(java.lang.String name)
        Gets a ServerPlayer by their name.

        This only works for online players.

        Note: Do not use names for persistent storage, the Notch of today may not be the Notch of yesterday.

        Parameters:
        name - The name to get the player from
        Returns:
        The ServerPlayer or empty if not found

      • serverScoreboard

        java.util.Optional<? extends Scoreboard> serverScoreboard()
        Gets the 'server' scoreboard. In Vanilla, this is the scoreboard of dimension 0 (the overworld).

        The server scoreboard is used with the Vanilla /scoreboard command, automatic score updating through criteria, and other things.

        The server scoreboard may not be available if dimension 0 is not yet loaded. In Vanilla, this will only occur when the server is first starting, as dimension 0 is normally always loaded.

        Returns:
        the server scoreboard, if available.

      • chunkLayout

        ChunkLayout chunkLayout()
        Returns information about the chunk layout used by this server implementation.
        Returns:
        The chunk layout used by the implementation

      • runningTimeTicks

        Ticks runningTimeTicks()
        Gets the time, in ticks, since this server began running for the current session.

        This value is not persisted across server restarts, it is set to zero each time the server starts.

        Returns:
        The number of ticks since this server started running

      • broadcastAudience

        Audience broadcastAudience()
        Gets the message channel that server-wide messages are sent through.
        Returns:
        The server-wide broadcast channel

      • setBroadcastAudience

        void setBroadcastAudience​(Audience channel)
        Sets the channel that server-wide messages should be sent through.
        Parameters:
        channel - The broadcast channel

      • boundAddress

        java.util.Optional<java.net.InetSocketAddress> boundAddress()
        Gets the bound InetSocketAddress from where this server is accepting connections.
        Returns:
        The address or Optional.empty() if not found

      • setHasWhitelist

        void setHasWhitelist​(boolean enabled)
        Sets whether the server is utilizing a whitelist.
        Parameters:
        enabled - True to enable the whitelist, false to disable

      • shutdown

        void shutdown()
        Shuts down the server, and kicks all players with the default kick message.

        For the Sponge implementation on the client, this will trigger the Integrated Server to shutdown a tick later.

      • shutdown

        void shutdown​(Component kickMessage)
        Shuts down the server, and kicks all players with the given message.
        Parameters:
        kickMessage - The message to kick players with

      • ticksPerSecond

        double ticksPerSecond()
        Gets the current ticks per second. A tick represents one cycle of the game loop.
        Returns:
        The current ticks per second

      • averageTickTime

        double averageTickTime()
        Gets the current average milliseconds per tick.
        Returns:
        The current average tick time.

      • targetTicksPerSecond

        int targetTicksPerSecond()
        Gets the target ticks per second for this server.

        This is dependent on the implementation.

        Returns:
        The target tick per second rate.

      • setPlayerIdleTimeout

        void setPlayerIdleTimeout​(int timeout)
        Sets the player idle timeout, in minutes.

        A value of 0 disables the player idle timeout.

        Parameters:
        timeout - The player idle timeout

      • serviceProvider

        ServiceProvider.ServerScoped serviceProvider()
        Gets the ServiceProvider.ServerScoped, used to provide Sponge services that plugins may provide. Services provided here are scoped to the lifetime of this Server.

        The provider will not be available during plugin construction and will throw an IllegalStateException if there is an attempt to access this before the provider is ready.

        Returns:
        The service manager

      • mapStorage

        MapStorage mapStorage()
        Gets the map storage for this server

        This allows for control over the server's maps, including obtaining and creating them

        Returns:
        MapStorage