Package org.bukkit

Interface Server

All Superinterfaces:
Audience, ForwardingAudience, PluginMessageRecipient, Pointered
public interface Server extends PluginMessageRecipient, ForwardingAudience
Represents a server implementation.

  • Field Details

  • Method Details

    • getName

      @NotNull @NotNull String getName()
      Gets the name of this server implementation.
      Returns:
      name of this server implementation

    • getVersion

      @NotNull @NotNull String getVersion()
      Gets the version string of this server implementation.
      Returns:
      version of this server implementation

    • getBukkitVersion

      @NotNull @NotNull String getBukkitVersion()
      Gets the Bukkit version that this server is running.
      Returns:
      version of Bukkit

    • getMinecraftVersion

      @NotNull @NotNull String getMinecraftVersion()
      Gets the version of game this server implements
      Returns:
      version of game

    • getOnlinePlayers

      @NotNull @NotNull Collection<? extends Player> getOnlinePlayers()
      Gets a view of all currently logged in players. This view is a reused object, making some operations like Collection.size() zero-allocation.

      The collection is a view backed by the internal representation, such that, changes to the internal state of the server will be reflected immediately. However, the reuse of the returned collection (identity) is not strictly guaranteed for future or all implementations. Casting the collection, or relying on interface implementations (like Serializable or List), is deprecated.

      Iteration behavior is undefined outside of self-contained main-thread uses. Normal and immediate iterator use without consequences that affect the collection are fully supported. The effects following (non-exhaustive) teleportation, death, and kicking are undefined. Any use of this collection from asynchronous threads is unsafe.

      For safe consequential iteration or mimicking the old array behavior, using Collection.toArray(Object[]) is recommended. For making snapshots, ImmutableList.copyOf(Collection) is recommended.

      Returns:
      a view of currently online players.

    • getMaxPlayers

      int getMaxPlayers()
      Get the maximum amount of players which can login to this server.
      Returns:
      the amount of players this server allows

    • setMaxPlayers

      void setMaxPlayers​(int maxPlayers)
      Set the maximum amount of players which can login to this server.
      Parameters:
      maxPlayers - the amount of players this server allows

    • getPort

      int getPort()
      Get the game port that the server runs on.
      Returns:
      the port number of this server

    • getViewDistance

      int getViewDistance()
      Get the view distance from this server.
      Returns:
      the view distance from this server.

    • getIp

      @NotNull @NotNull String getIp()
      Get the IP that this server is bound to, or empty string if not specified.
      Returns:
      the IP string that this server is bound to, otherwise empty string

    • getWorldType

      @NotNull @NotNull String getWorldType()
      Get world type (level-type setting) for default world.
      Returns:
      the value of level-type (e.g. DEFAULT, FLAT, DEFAULT_1_1)

    • getGenerateStructures

      boolean getGenerateStructures()
      Get generate-structures setting.
      Returns:
      true if structure generation is enabled, false otherwise

    • getMaxWorldSize

      int getMaxWorldSize()
      Get max world size.
      Returns:
      the maximum world size as specified for the server

    • getAllowEnd

      boolean getAllowEnd()
      Gets whether this server allows the End or not.
      Returns:
      whether this server allows the End or not

    • getAllowNether

      boolean getAllowNether()
      Gets whether this server allows the Nether or not.
      Returns:
      whether this server allows the Nether or not

    • hasWhitelist

      boolean hasWhitelist()
      Gets whether this server has a whitelist or not.
      Returns:
      whether this server has a whitelist or not

    • setWhitelist

      void setWhitelist​(boolean value)
      Sets if the server is whitelisted.
      Parameters:
      value - true for whitelist on, false for off

    • isWhitelistEnforced

      boolean isWhitelistEnforced()
      Gets whether the server whitelist is enforced. If the whitelist is enforced, non-whitelisted players will be disconnected when the server whitelist is reloaded.
      Returns:
      whether the server whitelist is enforced

    • setWhitelistEnforced

      void setWhitelistEnforced​(boolean value)
      Sets if the server whitelist is enforced. If the whitelist is enforced, non-whitelisted players will be disconnected when the server whitelist is reloaded.
      Parameters:
      value - true for enforced, false for not

    • getWhitelistedPlayers

      @NotNull @NotNull Set<OfflinePlayer> getWhitelistedPlayers()
      Gets a list of whitelisted players.
      Returns:
      a set containing all whitelisted players

    • reloadWhitelist

      void reloadWhitelist()
      Reloads the whitelist from disk.

    • broadcastMessage

      @Deprecated int broadcastMessage​(@NotNull @NotNull String message)
      Deprecated.
      use broadcast(net.kyori.adventure.text.Component)
      Broadcast a message to all players.

      This is the same as calling broadcast(java.lang.String, java.lang.String) to BROADCAST_CHANNEL_USERS

      Parameters:
      message - the message
      Returns:
      the number of players

    • broadcast

      @Deprecated default void broadcast​(@NotNull BaseComponent component)
      Deprecated.
      use sendMessage methods that accept Component
      Sends the component to all online players.
      Parameters:
      component - the component to send

    • broadcast

      @Deprecated default void broadcast​(@NotNull @NotNull BaseComponent... components)
      Deprecated.
      use sendMessage methods that accept Component
      Sends an array of components as a single message to all online players.
      Parameters:
      components - the components to send

    • getUpdateFolder

      @NotNull @NotNull String getUpdateFolder()
      Gets the name of the update folder. The update folder is used to safely update plugins at the right moment on a plugin load.

      The update folder name is relative to the plugins folder.

      Returns:
      the name of the update folder

    • getUpdateFolderFile

      @NotNull @NotNull File getUpdateFolderFile()
      Gets the update folder. The update folder is used to safely update plugins at the right moment on a plugin load.
      Returns:
      the update folder

    • getConnectionThrottle

      long getConnectionThrottle()
      Gets the value of the connection throttle setting.
      Returns:
      the value of the connection throttle setting

    • getTicksPerAnimalSpawns

      int getTicksPerAnimalSpawns()
      Gets default ticks per animal spawns value.

      Example Usage:

      • A value of 1 will mean the server will attempt to spawn monsters every tick.
      • A value of 400 will mean the server will attempt to spawn monsters every 400th tick.
      • A value below 0 will be reset back to Minecraft's default.

      Note: If set to 0, animal spawning will be disabled. We recommend using spawn-animals to control this instead.

      Minecraft default: 400.

      Returns:
      the default ticks per animal spawns value

    • getTicksPerMonsterSpawns

      int getTicksPerMonsterSpawns()
      Gets the default ticks per monster spawns value.

      Example Usage:

      • A value of 1 will mean the server will attempt to spawn monsters every tick.
      • A value of 400 will mean the server will attempt to spawn monsters every 400th tick.
      • A value below 0 will be reset back to Minecraft's default.

      Note: If set to 0, monsters spawning will be disabled. We recommend using spawn-monsters to control this instead.

      Minecraft default: 1.

      Returns:
      the default ticks per monsters spawn value

    • getTicksPerWaterSpawns

      int getTicksPerWaterSpawns()
      Gets the default ticks per water mob spawns value.

      Example Usage:

      • A value of 1 will mean the server will attempt to spawn water mobs every tick.
      • A value of 400 will mean the server will attempt to spawn water mobs every 400th tick.
      • A value below 0 will be reset back to Minecraft's default.

      Note: If set to 0, water mobs spawning will be disabled.

      Minecraft default: 1.

      Returns:
      the default ticks per water mobs spawn value

    • getTicksPerWaterAmbientSpawns

      int getTicksPerWaterAmbientSpawns()
      Gets the default ticks per water ambient mob spawns value.

      Example Usage:

      • A value of 1 will mean the server will attempt to spawn water ambient mobs every tick.
      • A value of 400 will mean the server will attempt to spawn water ambient mobs every 400th tick.
      • A value below 0 will be reset back to Minecraft's default.

      Note: If set to 0, ambient mobs spawning will be disabled.

      Minecraft default: 1.

      Returns:
      the default ticks per water ambient mobs spawn value

    • getTicksPerWaterUndergroundCreatureSpawns

      int getTicksPerWaterUndergroundCreatureSpawns()
      Gets the default ticks per water underground creature spawns value.

      Example Usage:

      • A value of 1 will mean the server will attempt to spawn water underground creature every tick.
      • A value of 400 will mean the server will attempt to spawn water underground creature every 400th tick.
      • A value below 0 will be reset back to Minecraft's default.

      Note: If set to 0, water underground creature spawning will be disabled.

      Minecraft default: 1.

      Returns:
      the default ticks per water underground creature spawn value

    • getTicksPerAmbientSpawns

      int getTicksPerAmbientSpawns()
      Gets the default ticks per ambient mob spawns value.

      Example Usage:

      • A value of 1 will mean the server will attempt to spawn ambient mobs every tick.
      • A value of 400 will mean the server will attempt to spawn ambient mobs every 400th tick.
      • A value below 0 will be reset back to Minecraft's default.

      Note: If set to 0, ambient mobs spawning will be disabled.

      Minecraft default: 1.

      Returns:
      the default ticks per ambient mobs spawn value

    • getPlayer

      @Nullable @Nullable Player getPlayer​(@NotNull @NotNull String name)
      Gets a player object by the given username.

      This method may not return objects for offline players.

      Parameters:
      name - the name to look up
      Returns:
      a player if one was found, null otherwise

    • getPlayerExact

      @Nullable @Nullable Player getPlayerExact​(@NotNull @NotNull String name)
      Gets the player with the exact given name, case insensitive.
      Parameters:
      name - Exact name of the player to retrieve
      Returns:
      a player object if one was found, null otherwise

    • matchPlayer

      @NotNull @NotNull List<Player> matchPlayer​(@NotNull @NotNull String name)
      Attempts to match any players with the given name, and returns a list of all possibly matches.

      This list is not sorted in any particular order. If an exact match is found, the returned list will only contain a single result.

      Parameters:
      name - the (partial) name to match
      Returns:
      list of all possible players

    • getPlayer

      @Nullable @Nullable Player getPlayer​(@NotNull @NotNull UUID id)
      Gets the player with the given UUID.
      Parameters:
      id - UUID of the player to retrieve
      Returns:
      a player object if one was found, null otherwise

    • getPlayerUniqueId

      @Nullable @Nullable UUID getPlayerUniqueId​(@NotNull @NotNull String playerName)
      Gets the unique ID of the player currently known as the specified player name In Offline Mode, will return an Offline UUID
      Parameters:
      playerName - the player name to look up the unique ID for
      Returns:
      A UUID, or null if that player name is not registered with Minecraft and the server is in online mode

    • getPluginManager

      @NotNull @NotNull PluginManager getPluginManager()
      Gets the plugin manager for interfacing with plugins.
      Returns:
      a plugin manager for this Server instance

    • getScheduler

      @NotNull @NotNull BukkitScheduler getScheduler()
      Gets the scheduler for managing scheduled events.
      Returns:
      a scheduling service for this server

    • getServicesManager

      @NotNull @NotNull ServicesManager getServicesManager()
      Gets a services manager.
      Returns:
      s services manager

    • getWorlds

      @NotNull @NotNull List<World> getWorlds()
      Gets a list of all worlds on this server.
      Returns:
      a list of worlds

    • createWorld

      @Nullable @Nullable World createWorld​(@NotNull @NotNull WorldCreator creator)
      Creates or loads a world with the given name using the specified options.

      If the world is already loaded, it will just return the equivalent of getWorld(creator.name()).

      Parameters:
      creator - the options to use when creating the world
      Returns:
      newly created or loaded world

    • unloadWorld

      boolean unloadWorld​(@NotNull @NotNull String name, boolean save)
      Unloads a world with the given name.
      Parameters:
      name - Name of the world to unload
      save - whether to save the chunks before unloading
      Returns:
      true if successful, false otherwise

    • unloadWorld

      boolean unloadWorld​(@NotNull @NotNull World world, boolean save)
      Unloads the given world.
      Parameters:
      world - the world to unload
      save - whether to save the chunks before unloading
      Returns:
      true if successful, false otherwise

    • getWorld

      @Nullable @Nullable World getWorld​(@NotNull @NotNull String name)
      Gets the world with the given name.
      Parameters:
      name - the name of the world to retrieve
      Returns:
      a world with the given name, or null if none exists

    • getWorld

      @Nullable @Nullable World getWorld​(@NotNull @NotNull UUID uid)
      Gets the world from the given Unique ID.
      Parameters:
      uid - a unique-id of the world to retrieve
      Returns:
      a world with the given Unique ID, or null if none exists

    • getWorld

      @Nullable @Nullable World getWorld​(@NotNull @NotNull NamespacedKey worldKey)
      Gets the world from the given NamespacedKey
      Parameters:
      worldKey - the NamespacedKey of the world to retrieve
      Returns:
      a world with the given NamespacedKey, or null if none exists

    • getMap

      @Deprecated @Nullable @Nullable MapView getMap​(int id)
      Deprecated.
      Magic value
      Gets the map from the given item ID.
      Parameters:
      id - the id of the map to get
      Returns:
      a map view if it exists, or null otherwise

    • createMap

      @NotNull @NotNull MapView createMap​(@NotNull @NotNull World world)
      Create a new map with an automatically assigned ID.
      Parameters:
      world - the world the map will belong to
      Returns:
      a newly created map view

    • createExplorerMap

      @NotNull @NotNull ItemStack createExplorerMap​(@NotNull @NotNull World world, @NotNull @NotNull Location location, @NotNull @NotNull StructureType structureType)
      Create a new explorer map targeting the closest nearby structure of a given StructureType.
      This method uses implementation default values for radius and findUnexplored (usually 100, true).
      Parameters:
      world - the world the map will belong to
      location - the origin location to find the nearest structure
      structureType - the type of structure to find
      Returns:
      a newly created item stack
      See Also:
      World.locateNearestStructure(org.bukkit.Location, org.bukkit.StructureType, int, boolean)

    • createExplorerMap

      @NotNull @NotNull ItemStack createExplorerMap​(@NotNull @NotNull World world, @NotNull @NotNull Location location, @NotNull @NotNull StructureType structureType, int radius, boolean findUnexplored)
      Create a new explorer map targeting the closest nearby structure of a given StructureType.
      This method uses implementation default values for radius and findUnexplored (usually 100, true).
      Parameters:
      world - the world the map will belong to
      location - the origin location to find the nearest structure
      structureType - the type of structure to find
      radius - radius to search, see World#locateNearestStructure for more information
      findUnexplored - whether to find unexplored structures
      Returns:
      the newly created item stack
      See Also:
      World.locateNearestStructure(org.bukkit.Location, org.bukkit.StructureType, int, boolean)

    • reload

      void reload()
      Reloads the server, refreshing settings and plugin information.

    • reloadData

      void reloadData()
      Reload only the Minecraft data for the server. This includes custom advancements and loot tables.

    • getLogger

      @NotNull @NotNull Logger getLogger()
      Returns the primary logger associated with this server instance.
      Returns:
      Logger associated with this server

    • getPluginCommand

      @Nullable @Nullable PluginCommand getPluginCommand​(@NotNull @NotNull String name)
      Gets a PluginCommand with the given name or alias.
      Parameters:
      name - the name of the command to retrieve
      Returns:
      a plugin command if found, null otherwise

    • savePlayers

      void savePlayers()
      Writes loaded players to disk.

    • dispatchCommand

      boolean dispatchCommand​(@NotNull @NotNull CommandSender sender, @NotNull @NotNull String commandLine) throws CommandException
      Dispatches a command on this server, and executes it if found.
      Parameters:
      sender - the apparent sender of the command
      commandLine - the command + arguments. Example: test abc 123
      Returns:
      returns false if no target is found
      Throws:
      CommandException - thrown when the executor for the given command fails with an unhandled exception

    • addRecipe

      @Contract("null -> false") boolean addRecipe​(@Nullable @Nullable Recipe recipe)
      Adds a recipe to the crafting manager.
      Parameters:
      recipe - the recipe to add
      Returns:
      true if the recipe was added, false if it wasn't for some reason

    • getRecipesFor

      @NotNull @NotNull List<Recipe> getRecipesFor​(@NotNull @NotNull ItemStack result)
      Get a list of all recipes for a given item. The stack size is ignored in comparisons. If the durability is -1, it will match any data value.
      Parameters:
      result - the item to match against recipe results
      Returns:
      a list of recipes with the given result

    • getRecipe

      @Nullable @Nullable Recipe getRecipe​(@NotNull @NotNull NamespacedKey recipeKey)
      Get the Recipe for the given key.
      Parameters:
      recipeKey - the key of the recipe to return
      Returns:
      the recipe for the given key or null.

    • getCraftingRecipe

      @Nullable @Nullable Recipe getCraftingRecipe​(@NotNull @NotNull ItemStack[] craftingMatrix, @NotNull @NotNull World world)
      Get the Recipe for the list of ItemStacks provided.

      The list is formatted as a crafting matrix where the index follow the pattern below:

       [ 0 1 2 ]
 [ 3 4 5 ]
 [ 6 7 8 ]

      NOTE: This method will not modify the provided ItemStack array, for that, use craftItem(ItemStack[], World, Player).

      Parameters:
      craftingMatrix - list of items to be crafted from. Must not contain more than 9 items.
      world - The world the crafting takes place in.
      Returns:
      the Recipe resulting from the given crafting matrix.

    • craftItem

      @NotNull @NotNull ItemStack craftItem​(@NotNull @NotNull ItemStack[] craftingMatrix, @NotNull @NotNull World world, @NotNull @NotNull Player player)
      Get the crafted item using the list of ItemStack provided.

      The list is formatted as a crafting matrix where the index follow the pattern below:

       [ 0 1 2 ]
 [ 3 4 5 ]
 [ 6 7 8 ]

      The World and Player arguments are required to fulfill the Bukkit Crafting events.

      Calls PrepareItemCraftEvent to imitate the Player initiating the crafting event.

      Parameters:
      craftingMatrix - list of items to be crafted from. Must not contain more than 9 items.
      world - The world the crafting takes place in.
      player - The player to imitate the crafting event on.
      Returns:
      the ItemStack resulting from the given crafting matrix, if no recipe is found an ItemStack of Material.AIR is returned.

    • recipeIterator

      @NotNull @NotNull Iterator<Recipe> recipeIterator()
      Get an iterator through the list of crafting recipes.
      Returns:
      an iterator

    • clearRecipes

      void clearRecipes()
      Clears the list of crafting recipes.

    • resetRecipes

      void resetRecipes()
      Resets the list of crafting recipes to the default.

    • removeRecipe

      boolean removeRecipe​(@NotNull @NotNull NamespacedKey key)
      Remove a recipe from the server. Note that removing a recipe may cause permanent loss of data associated with that recipe (eg whether it has been discovered by players).
      Parameters:
      key - NamespacedKey of recipe to remove.
      Returns:
      True if recipe was removed

    • getCommandAliases

      @NotNull @NotNull Map<String,​String[]> getCommandAliases()
      Gets a list of command aliases defined in the server properties.
      Returns:
      a map of aliases to command names

    • getSpawnRadius

      int getSpawnRadius()
      Gets the radius, in blocks, around each worlds spawn point to protect.
      Returns:
      spawn radius, or 0 if none

    • setSpawnRadius

      void setSpawnRadius​(int value)
      Sets the radius, in blocks, around each worlds spawn point to protect.
      Parameters:
      value - new spawn radius, or 0 if none

    • getOnlineMode

      boolean getOnlineMode()
      Gets whether the Server is in online mode or not.
      Returns:
      true if the server authenticates clients, false otherwise

    • getAllowFlight

      boolean getAllowFlight()
      Gets whether this server allows flying or not.
      Returns:
      true if the server allows flight, false otherwise

    • isHardcore

      boolean isHardcore()
      Gets whether the server is in hardcore mode or not.
      Returns:
      true if the server mode is hardcore, false otherwise

    • shutdown

      void shutdown()
      Shutdowns the server, stopping everything.

    • broadcast

      @Deprecated int broadcast​(@NotNull @NotNull String message, @NotNull @NotNull String permission)
      Deprecated.
      in favour of broadcast(net.kyori.adventure.text.Component, String)
      Broadcasts the specified message to every user with the given permission name.
      Parameters:
      message - message to broadcast
      permission - the required permission permissibles must have to receive the broadcast
      Returns:
      number of message recipients

    • broadcast

      int broadcast​(@NotNull Component message)
      Broadcast a message to all players.

      This is the same as calling broadcast(net.kyori.adventure.text.Component, java.lang.String) with the BROADCAST_CHANNEL_USERS permission.

      Parameters:
      message - the message
      Returns:
      the number of players

    • broadcast

      int broadcast​(@NotNull Component message, @NotNull @NotNull String permission)
      Broadcasts the specified message to every user with the given permission name.
      Parameters:
      message - message to broadcast
      permission - the required permission permissibles must have to receive the broadcast
      Returns:
      number of message recipients

    • getOfflinePlayer

      @Deprecated @NotNull @NotNull OfflinePlayer getOfflinePlayer​(@NotNull @NotNull String name)
      Deprecated.
      Persistent storage of users should be by UUID as names are no longer unique past a single session.
      Gets the player by the given name, regardless if they are offline or online.

      This method may involve a blocking web request to get the UUID for the given name.

      This will return an object even if the player does not exist. To this method, all players will exist.

      Parameters:
      name - the name the player to retrieve
      Returns:
      an offline player
      See Also:
      getOfflinePlayer(java.util.UUID)

    • getOfflinePlayerIfCached

      @Nullable @Nullable OfflinePlayer getOfflinePlayerIfCached​(@NotNull @NotNull String name)
      Gets the player by the given name, regardless if they are offline or online.

      This will not make a web request to get the UUID for the given name, thus this method will not block. However this method will return null if the player is not cached.

      Parameters:
      name - the name of the player to retrieve
      Returns:
      an offline player if cached, null otherwise
      See Also:
      getOfflinePlayer(String), getOfflinePlayer(java.util.UUID)

    • getOfflinePlayer

      @NotNull @NotNull OfflinePlayer getOfflinePlayer​(@NotNull @NotNull UUID id)
      Gets the player by the given UUID, regardless if they are offline or online.

      This will return an object even if the player does not exist. To this method, all players will exist.

      Parameters:
      id - the UUID of the player to retrieve
      Returns:
      an offline player

    • getIPBans

      @NotNull @NotNull Set<String> getIPBans()
      Gets a set containing all current IPs that are banned.
      Returns:
      a set containing banned IP addresses

    • banIP

      void banIP​(@NotNull @NotNull String address)
      Bans the specified address from the server.
      Parameters:
      address - the IP address to ban

    • unbanIP

      void unbanIP​(@NotNull @NotNull String address)
      Unbans the specified address from the server.
      Parameters:
      address - the IP address to unban

    • getBannedPlayers

      @NotNull @NotNull Set<OfflinePlayer> getBannedPlayers()
      Gets a set containing all banned players.
      Returns:
      a set containing banned players

    • getBanList

      @NotNull @NotNull BanList getBanList​(@NotNull BanList.Type type)
      Gets a ban list for the supplied type.

      Bans by name are no longer supported and this method will return null when trying to request them. The replacement is bans by UUID.

      Parameters:
      type - the type of list to fetch, cannot be null
      Returns:
      a ban list of the specified type

    • getOperators

      @NotNull @NotNull Set<OfflinePlayer> getOperators()
      Gets a set containing all player operators.
      Returns:
      a set containing player operators

    • getDefaultGameMode

      @NotNull @NotNull GameMode getDefaultGameMode()
      Gets the default GameMode for new players.
      Returns:
      the default game mode

    • setDefaultGameMode

      void setDefaultGameMode​(@NotNull @NotNull GameMode mode)
      Sets the default GameMode for new players.
      Parameters:
      mode - the new game mode

    • getConsoleSender

      @NotNull @NotNull ConsoleCommandSender getConsoleSender()
      Gets a ConsoleCommandSender that may be used as an input source for this server.
      Returns:
      a console command sender

    • getWorldContainer

      @NotNull @NotNull File getWorldContainer()
      Gets the folder that contains all of the various Worlds.
      Returns:
      folder that contains all worlds

    • getOfflinePlayers

      @NotNull @NotNull OfflinePlayer[] getOfflinePlayers()
      Gets every player that has ever played on this server.

      This method can be expensive as it loads all the player data files from the disk.

      Returns:
      an array containing all previous players

    • getMessenger

      @NotNull @NotNull Messenger getMessenger()
      Gets the Messenger responsible for this server.
      Returns:
      messenger responsible for this server

    • getHelpMap

      @NotNull @NotNull HelpMap getHelpMap()
      Gets the HelpMap providing help topics for this server.
      Returns:
      a help map for this server

    • createInventory

      @NotNull @NotNull Inventory createInventory​(@Nullable @Nullable InventoryHolder owner, @NotNull @NotNull InventoryType type)
      Creates an empty inventory with the specified type. If the type is InventoryType.CHEST, the new inventory has a size of 27; otherwise the new inventory has the normal size for its type.
      InventoryType.WORKBENCH will not process crafting recipes if created with this method. Use HumanEntity.openWorkbench(Location, boolean) instead.
      InventoryType.ENCHANTING will not process ItemStacks for possible enchanting results. Use HumanEntity.openEnchanting(Location, boolean) instead.
      Parameters:
      owner - the holder of the inventory, or null to indicate no holder
      type - the type of inventory to create
      Returns:
      a new inventory
      Throws:
      IllegalArgumentException - if the InventoryType cannot be viewed.
      See Also:
      InventoryType.isCreatable()

    • createInventory

      @NotNull @NotNull Inventory createInventory​(@Nullable @Nullable InventoryHolder owner, @NotNull @NotNull InventoryType type, @NotNull Component title)
      Creates an empty inventory with the specified type and title. If the type is InventoryType.CHEST, the new inventory has a size of 27; otherwise the new inventory has the normal size for its type.
      It should be noted that some inventory types do not support titles and may not render with said titles on the Minecraft client.
      InventoryType.WORKBENCH will not process crafting recipes if created with this method. Use HumanEntity.openWorkbench(Location, boolean) instead.
      InventoryType.ENCHANTING will not process ItemStacks for possible enchanting results. Use HumanEntity.openEnchanting(Location, boolean) instead.
      Parameters:
      owner - The holder of the inventory; can be null if there's no holder.
      type - The type of inventory to create.
      title - The title of the inventory, to be displayed when it is viewed.
      Returns:
      The new inventory.
      Throws:
      IllegalArgumentException - if the InventoryType cannot be viewed.
      See Also:
      InventoryType.isCreatable()

    • createInventory

      @Deprecated @NotNull @NotNull Inventory createInventory​(@Nullable @Nullable InventoryHolder owner, @NotNull @NotNull InventoryType type, @NotNull @NotNull String title)
      Deprecated.
      in favour of createInventory(InventoryHolder, InventoryType, net.kyori.adventure.text.Component)
      Creates an empty inventory with the specified type and title. If the type is InventoryType.CHEST, the new inventory has a size of 27; otherwise the new inventory has the normal size for its type.
      It should be noted that some inventory types do not support titles and may not render with said titles on the Minecraft client.
      InventoryType.WORKBENCH will not process crafting recipes if created with this method. Use HumanEntity.openWorkbench(Location, boolean) instead.
      InventoryType.ENCHANTING will not process ItemStacks for possible enchanting results. Use HumanEntity.openEnchanting(Location, boolean) instead.
      Parameters:
      owner - The holder of the inventory; can be null if there's no holder.
      type - The type of inventory to create.
      title - The title of the inventory, to be displayed when it is viewed.
      Returns:
      The new inventory.
      Throws:
      IllegalArgumentException - if the InventoryType cannot be viewed.
      See Also:
      InventoryType.isCreatable()

    • createInventory

      @NotNull @NotNull Inventory createInventory​(@Nullable @Nullable InventoryHolder owner, int size) throws IllegalArgumentException
      Creates an empty inventory of type InventoryType.CHEST with the specified size.
      Parameters:
      owner - the holder of the inventory, or null to indicate no holder
      size - a multiple of 9 as the size of inventory to create
      Returns:
      a new inventory
      Throws:
      IllegalArgumentException - if the size is not a multiple of 9

    • createInventory

      @NotNull @NotNull Inventory createInventory​(@Nullable @Nullable InventoryHolder owner, int size, @NotNull Component title) throws IllegalArgumentException
      Creates an empty inventory of type InventoryType.CHEST with the specified size and title.
      Parameters:
      owner - the holder of the inventory, or null to indicate no holder
      size - a multiple of 9 as the size of inventory to create
      title - the title of the inventory, displayed when inventory is viewed
      Returns:
      a new inventory
      Throws:
      IllegalArgumentException - if the size is not a multiple of 9

    • createInventory

      @Deprecated @NotNull @NotNull Inventory createInventory​(@Nullable @Nullable InventoryHolder owner, int size, @NotNull @NotNull String title) throws IllegalArgumentException
      Deprecated.
      in favour of createInventory(InventoryHolder, int, net.kyori.adventure.text.Component)
      Creates an empty inventory of type InventoryType.CHEST with the specified size and title.
      Parameters:
      owner - the holder of the inventory, or null to indicate no holder
      size - a multiple of 9 as the size of inventory to create
      title - the title of the inventory, displayed when inventory is viewed
      Returns:
      a new inventory
      Throws:
      IllegalArgumentException - if the size is not a multiple of 9

    • createMerchant

      @NotNull @NotNull Merchant createMerchant​(@Nullable Component title)
      Creates an empty merchant.
      Parameters:
      title - the title of the corresponding merchant inventory, displayed when the merchant inventory is viewed
      Returns:
      a new merchant

    • createMerchant

      @NotNull @Deprecated @NotNull Merchant createMerchant​(@Nullable @Nullable String title)
      Deprecated.
      in favour of createMerchant(net.kyori.adventure.text.Component)
      Creates an empty merchant.
      Parameters:
      title - the title of the corresponding merchant inventory, displayed when the merchant inventory is viewed
      Returns:
      a new merchant

    • getMonsterSpawnLimit

      int getMonsterSpawnLimit()
      Gets user-specified limit for number of monsters that can spawn in a chunk.
      Returns:
      the monster spawn limit

    • getAnimalSpawnLimit

      int getAnimalSpawnLimit()
      Gets user-specified limit for number of animals that can spawn in a chunk.
      Returns:
      the animal spawn limit

    • getWaterAnimalSpawnLimit

      int getWaterAnimalSpawnLimit()
      Gets user-specified limit for number of water animals that can spawn in a chunk.
      Returns:
      the water animal spawn limit

    • getWaterAmbientSpawnLimit

      int getWaterAmbientSpawnLimit()
      Gets user-specified limit for number of water ambient mobs that can spawn in a chunk.
      Returns:
      the water ambient spawn limit

    • getWaterUndergroundCreatureSpawnLimit

      int getWaterUndergroundCreatureSpawnLimit()
      Get user-specified limit for number of water creature underground that can spawn in a chunk.
      Returns:
      the water underground creature limit

    • getAmbientSpawnLimit

      int getAmbientSpawnLimit()
      Gets user-specified limit for number of ambient mobs that can spawn in a chunk.
      Returns:
      the ambient spawn limit

    • isPrimaryThread

      boolean isPrimaryThread()
      Checks the current thread against the expected primary thread for the server.

      Note: this method should not be used to indicate the current synchronized state of the runtime. A current thread matching the main thread indicates that it is synchronized, but a mismatch does not preclude the same assumption.

      Returns:
      true if the current thread matches the expected primary thread, false otherwise

    • motd

      @NotNull Component motd()
      Gets the message that is displayed on the server list.
      Returns:
      the server's MOTD

    • getMotd

      @NotNull @Deprecated @NotNull String getMotd()
      Deprecated.
      in favour of motd()
      Gets the message that is displayed on the server list.
      Returns:
      the servers MOTD

    • shutdownMessage

      @Nullable Component shutdownMessage()
      Gets the default message that is displayed when the server is stopped.
      Returns:
      the shutdown message

    • getShutdownMessage

      @Nullable @Deprecated @Nullable String getShutdownMessage()
      Deprecated.
      in favour of shutdownMessage()
      Gets the default message that is displayed when the server is stopped.
      Returns:
      the shutdown message

    • getWarningState

      @NotNull @NotNull Warning.WarningState getWarningState()
      Gets the current warning state for the server.
      Returns:
      the configured warning state

    • getItemFactory

      @NotNull @NotNull ItemFactory getItemFactory()
      Gets the instance of the item factory (for ItemMeta).
      Returns:
      the item factory
      See Also:
      ItemFactory

    • getScoreboardManager

      @NotNull @NotNull ScoreboardManager getScoreboardManager()
      Gets the instance of the scoreboard manager.

      This will only exist after the first world has loaded.

      Returns:
      the scoreboard manager or null if no worlds are loaded.

    • getServerIcon

      @Nullable @Nullable CachedServerIcon getServerIcon()
      Gets an instance of the server's default server-icon.
      Returns:
      the default server-icon; null values may be used by the implementation to indicate no defined icon, but this behavior is not guaranteed

    • loadServerIcon

      @NotNull @NotNull CachedServerIcon loadServerIcon​(@NotNull @NotNull File file) throws IllegalArgumentException, Exception
      Loads an image from a file, and returns a cached image for the specific server-icon.

      Size and type are implementation defined. An incompatible file is guaranteed to throw an implementation-defined Exception.

      Parameters:
      file - the file to load the from
      Returns:
      a cached server-icon that can be used for a ServerListPingEvent.setServerIcon(CachedServerIcon)
      Throws:
      IllegalArgumentException - if image is null
      Exception - if the image does not meet current server server-icon specifications

    • loadServerIcon

      @NotNull @NotNull CachedServerIcon loadServerIcon​(@NotNull @NotNull BufferedImage image) throws IllegalArgumentException, Exception
      Creates a cached server-icon for the specific image.

      Size and type are implementation defined. An incompatible file is guaranteed to throw an implementation-defined Exception.

      Parameters:
      image - the image to use
      Returns:
      a cached server-icon that can be used for a ServerListPingEvent.setServerIcon(CachedServerIcon)
      Throws:
      IllegalArgumentException - if image is null
      Exception - if the image does not meet current server server-icon specifications

    • setIdleTimeout

      void setIdleTimeout​(int threshold)
      Set the idle kick timeout. Any players idle for the specified amount of time will be automatically kicked.

      A value of 0 will disable the idle kick timeout.

      Parameters:
      threshold - the idle timeout in minutes

    • getIdleTimeout

      int getIdleTimeout()
      Gets the idle kick timeout.
      Returns:
      the idle timeout in minutes

    • createChunkData

      @NotNull ChunkGenerator.ChunkData createChunkData​(@NotNull @NotNull World world)
      Create a ChunkData for use in a generator. See ChunkGenerator.generateChunkData(org.bukkit.World, java.util.Random, int, int, org.bukkit.generator.ChunkGenerator.BiomeGrid)
      Parameters:
      world - the world to create the ChunkData for
      Returns:
      a new ChunkData for the world

    • createVanillaChunkData

      @NotNull ChunkGenerator.ChunkData createVanillaChunkData​(@NotNull @NotNull World world, int x, int z)
      Create a ChunkData for use in a generator, that is populated by the vanilla generator for that world
      Parameters:
      world - the world to create the ChunkData for
      x - the x coordinate of the chunk
      z - the z coordinate of the chunk
      Returns:
      a new ChunkData for the world

    • createBossBar

      @NotNull @NotNull BossBar createBossBar​(@Nullable @Nullable String title, @NotNull @NotNull BarColor color, @NotNull @NotNull BarStyle style, @NotNull @NotNull BarFlag... flags)
      Creates a boss bar instance to display to players. The progress defaults to 1.0
      Parameters:
      title - the title of the boss bar
      color - the color of the boss bar
      style - the style of the boss bar
      flags - an optional list of flags to set on the boss bar
      Returns:
      the created boss bar

    • createBossBar

      @NotNull @NotNull KeyedBossBar createBossBar​(@NotNull @NotNull NamespacedKey key, @Nullable @Nullable String title, @NotNull @NotNull BarColor color, @NotNull @NotNull BarStyle style, @NotNull @NotNull BarFlag... flags)
      Creates a boss bar instance to display to players. The progress defaults to 1.0.
      This instance is added to the persistent storage of the server and will be editable by commands and restored after restart.
      Parameters:
      key - the key of the boss bar that is used to access the boss bar
      title - the title of the boss bar
      color - the color of the boss bar
      style - the style of the boss bar
      flags - an optional list of flags to set on the boss bar
      Returns:
      the created boss bar

    • getBossBars

      @NotNull @NotNull Iterator<KeyedBossBar> getBossBars()
      Gets an unmodifiable iterator through all persistent bossbars. e.g. bossbars created using the bossbar command
      Returns:
      a bossbar iterator

    • getBossBar

      @Nullable @Nullable KeyedBossBar getBossBar​(@NotNull @NotNull NamespacedKey key)
      Gets the KeyedBossBar specified by this key. e.g. bossbars created using the bossbar command
      Parameters:
      key - unique bossbar key
      Returns:
      bossbar or null if not exists

    • removeBossBar

      boolean removeBossBar​(@NotNull @NotNull NamespacedKey key)
      Removes a KeyedBossBar specified by this key. e.g. bossbars created using the bossbar command
      Parameters:
      key - unique bossbar key
      Returns:
      true if removal succeeded or false

    • getEntity

      @Nullable @Nullable Entity getEntity​(@NotNull @NotNull UUID uuid)
      Gets an entity on the server by its UUID
      Parameters:
      uuid - the UUID of the entity
      Returns:
      the entity with the given UUID, or null if it isn't found

    • getTPS

      @NotNull @org.jetbrains.annotations.NotNull double[] getTPS()
      Gets the current server TPS
      Returns:
      current server TPS (1m, 5m, 15m in Paper-Server)

    • getTickTimes

      @NotNull @org.jetbrains.annotations.NotNull long[] getTickTimes()
      Get a sample of the servers last tick times (in nanos)
      Returns:
      A sample of the servers last tick times (in nanos)

    • getAverageTickTime

      double getAverageTickTime()
      Get the average tick time (in millis)
      Returns:
      Average tick time (in millis)

    • getCommandMap

      @NotNull CommandMap getCommandMap()
      Gets the active CommandMap
      Returns:
      the active command map

    • getAdvancement

      @Nullable @Nullable Advancement getAdvancement​(@NotNull @NotNull NamespacedKey key)
      Get the advancement specified by this key.
      Parameters:
      key - unique advancement key
      Returns:
      advancement or null if not exists

    • advancementIterator

      @NotNull @NotNull Iterator<Advancement> advancementIterator()
      Get an iterator through all advancements. Advancements cannot be removed from this iterator,
      Returns:
      an advancement iterator

    • createBlockData

      @NotNull @NotNull BlockData createBlockData​(@NotNull @NotNull Material material)
      Creates a new BlockData instance for the specified Material, with all properties initialized to unspecified defaults.
      Parameters:
      material - the material
      Returns:
      new data instance

    • createBlockData

      @NotNull @NotNull BlockData createBlockData​(@NotNull @NotNull Material material, @Nullable @Nullable Consumer<BlockData> consumer)
      Creates a new BlockData instance for the specified Material, with all properties initialized to unspecified defaults.
      Parameters:
      material - the material
      consumer - consumer to run on new instance before returning
      Returns:
      new data instance

    • createBlockData

      @NotNull @NotNull BlockData createBlockData​(@NotNull @NotNull String data) throws IllegalArgumentException
      Creates a new BlockData instance with material and properties parsed from provided data.
      Parameters:
      data - data string
      Returns:
      new data instance
      Throws:
      IllegalArgumentException - if the specified data is not valid

    • createBlockData

      @NotNull @Contract("null, null -> fail") @NotNull BlockData createBlockData​(@Nullable @Nullable Material material, @Nullable @Nullable String data) throws IllegalArgumentException
      Creates a new BlockData instance for the specified Material, with all properties initialized to unspecified defaults, except for those provided in data.
      If material is specified, then the data string must not also contain the material.
      Parameters:
      material - the material
      data - data string
      Returns:
      new data instance
      Throws:
      IllegalArgumentException - if the specified data is not valid

    • getTag

      <T extends Keyed> Tag<T> getTag​(@NotNull @NotNull String registry, @NotNull @NotNull NamespacedKey tag, @NotNull @NotNull Class<T> clazz)
      Gets a tag which has already been defined within the server. Plugins are suggested to use the concrete tags in Tag rather than this method which makes no guarantees about which tags are available, and may also be less performant due to lack of caching.
      Tags will be searched for in an implementation specific manner, but a path consisting of namespace/tags/registry/key is expected.
      Server implementations are allowed to handle only the registries indicated in Tag.
      Type Parameters:
      T - type of the tag
      Parameters:
      registry - the tag registry to look at
      tag - the name of the tag
      clazz - the class of the tag entries
      Returns:
      the tag or null

    • getTags

      @NotNull <T extends Keyed> @NotNull Iterable<Tag<T>> getTags​(@NotNull @NotNull String registry, @NotNull @NotNull Class<T> clazz)
      Gets a all tags which have been defined within the server.
      Server implementations are allowed to handle only the registries indicated in Tag.
      No guarantees are made about the mutability of the returned iterator.
      Type Parameters:
      T - type of the tag
      Parameters:
      registry - the tag registry to look at
      clazz - the class of the tag entries
      Returns:
      all defined tags

    • getLootTable

      @Nullable @Nullable LootTable getLootTable​(@NotNull @NotNull NamespacedKey key)
      Gets the specified LootTable.
      Parameters:
      key - the name of the LootTable
      Returns:
      the LootTable, or null if no LootTable is found with that name

    • selectEntities

      @NotNull @NotNull List<Entity> selectEntities​(@NotNull @NotNull CommandSender sender, @NotNull @NotNull String selector) throws IllegalArgumentException
      Selects entities using the given Vanilla selector.
      No guarantees are made about the selector format, other than they match the Vanilla format for the active Minecraft version.
      Usually a selector will start with '@', unless selecting a Player in which case it may simply be the Player's name or UUID.
      Note that in Vanilla, elevated permissions are usually required to use '@' selectors, but this method should not check such permissions from the sender.
      Parameters:
      sender - the sender to execute as, must be provided
      selector - the selection string
      Returns:
      a list of the selected entities. The list will not be null, but no further guarantees are made.
      Throws:
      IllegalArgumentException - if the selector is malformed in any way or a parameter is null

    • getStructureManager

      @NotNull @NotNull StructureManager getStructureManager()
      Gets the structure manager for loading and saving structures.
      Returns:
      the structure manager

    • getUnsafe

      @Deprecated @NotNull @NotNull UnsafeValues getUnsafe()
      Deprecated.
      Returns:
      the unsafe values instance
      See Also:
      UnsafeValues

    • spigot

      @NotNull @NotNull Server.Spigot spigot()

    • reloadPermissions

      void reloadPermissions()

    • reloadCommandAliases

      boolean reloadCommandAliases()

    • suggestPlayerNamesWhenNullTabCompletions

      boolean suggestPlayerNamesWhenNullTabCompletions()
      Checks if player names should be suggested when a command returns null as their tab completion result.
      Returns:
      true if player names should be suggested

    • getPermissionMessage

      @NotNull @NotNull String getPermissionMessage()
      Returns:
      the default no permission message used on the server

    • createProfile

      @NotNull PlayerProfile createProfile​(@NotNull @NotNull UUID uuid)
      Creates a PlayerProfile for the specified uuid, with name as null
      Parameters:
      uuid - UUID to create profile for
      Returns:
      A PlayerProfile object

    • createProfile

      @NotNull PlayerProfile createProfile​(@NotNull @NotNull String name)
      Creates a PlayerProfile for the specified name, with UUID as null
      Parameters:
      name - Name to create profile for
      Returns:
      A PlayerProfile object

    • createProfile

      @NotNull PlayerProfile createProfile​(@Nullable @Nullable UUID uuid, @Nullable @Nullable String name)
      Creates a PlayerProfile for the specified name/uuid Both UUID and Name can not be null at same time. One must be supplied.
      Parameters:
      uuid - UUID to create profile for
      name - Name to create profile for
      Returns:
      A PlayerProfile object

    • getCurrentTick

      int getCurrentTick()
      Get the current internal server tick
      Returns:
      Current tick

    • getPluginsFolder

      @NotNull @NotNull File getPluginsFolder()
      Returns the de facto plugins directory, generally used for storing plugin jars to be loaded, as well as their data folders.

      Plugins should use Plugin.getDataFolder() rather than traversing this directory manually when determining the location in which to store their data and configuration files.

      Returns:
      plugins directory

    • isStopping

      boolean isStopping()
      Checks if the server is in the process of being shutdown.
      Returns:
      true if server is in the process of being shutdown

    • getMobGoals

      @NotNull MobGoals getMobGoals()
      Returns the MobGoals manager
      Returns:
      the mob goals manager

    • getDatapackManager

      @NotNull DatapackManager getDatapackManager()
      Returns:
      the datapack manager