public final class Bukkit
extends java.lang.Object
Modifier and Type | Method | Description |
---|---|---|
static boolean |
addRecipe(Recipe recipe) |
Adds a recipe to the crafting manager.
|
static java.util.Iterator<Advancement> |
advancementIterator() |
Get an iterator through all advancements.
|
static void |
banIP(java.lang.String address) |
Bans the specified address from the server.
|
static int |
broadcast(java.lang.String message,
java.lang.String permission) |
Broadcasts the specified message to every user with the given
permission name.
|
static int |
broadcastMessage(java.lang.String message) |
Broadcast a message to all players.
|
static void |
clearRecipes() |
Clears the list of crafting recipes.
|
static BlockData |
createBlockData(java.lang.String data) |
Creates a new
BlockData instance with material and properties
parsed from provided data. |
static BlockData |
createBlockData(Material material) |
Creates a new
BlockData instance for the specified Material, with
all properties initialized to unspecified defaults. |
static BlockData |
createBlockData(Material material,
java.lang.String data) |
Creates a new
BlockData instance for the specified Material, with
all properties initialized to unspecified defaults, except for those
provided in data. |
static BlockData |
createBlockData(Material material,
java.util.function.Consumer<BlockData> consumer) |
Creates a new
BlockData instance for the specified Material, with
all properties initialized to unspecified defaults. |
static BossBar |
createBossBar(java.lang.String title,
BarColor color,
BarStyle style,
BarFlag... flags) |
Creates a boss bar instance to display to players.
|
static ChunkGenerator.ChunkData |
createChunkData(World world) |
Create a ChunkData for use in a generator.
|
static Inventory |
createInventory(InventoryHolder owner,
int size) |
Creates an empty inventory of type
InventoryType.CHEST with the
specified size. |
static Inventory |
createInventory(InventoryHolder owner,
int size,
java.lang.String title) |
Creates an empty inventory of type
InventoryType.CHEST with the
specified size and title. |
static Inventory |
createInventory(InventoryHolder owner,
InventoryType type) |
Creates an empty inventory with the specified type and title.
|
static Inventory |
createInventory(InventoryHolder owner,
InventoryType type,
java.lang.String title) |
Creates an empty inventory with the specified type and title.
|
static MapView |
createMap(World world) |
Create a new map with an automatically assigned ID.
|
static Merchant |
createMerchant(java.lang.String title) |
Creates an empty merchant.
|
static World |
createWorld(WorldCreator creator) |
Creates or loads a world with the given name using the specified
options.
|
static boolean |
dispatchCommand(CommandSender sender,
java.lang.String commandLine) |
Dispatches a command on this server, and executes it if found.
|
static Advancement |
getAdvancement(NamespacedKey key) |
Get the advancement specified by this key.
|
static boolean |
getAllowEnd() |
Gets whether this server allows the End or not.
|
static boolean |
getAllowFlight() |
Gets whether this server allows flying or not.
|
static boolean |
getAllowNether() |
Gets whether this server allows the Nether or not.
|
static int |
getAmbientSpawnLimit() |
Gets user-specified limit for number of ambient mobs that can spawn in
a chunk.
|
static int |
getAnimalSpawnLimit() |
Gets user-specified limit for number of animals that can spawn in a
chunk.
|
static BanList |
getBanList(BanList.Type type) |
Gets a ban list for the supplied type.
|
static java.util.Set<OfflinePlayer> |
getBannedPlayers() |
Gets a set containing all banned players.
|
static java.lang.String |
getBukkitVersion() |
Gets the Bukkit version that this server is running.
|
static java.util.Map<java.lang.String,java.lang.String[]> |
getCommandAliases() |
Gets a list of command aliases defined in the server properties.
|
static long |
getConnectionThrottle() |
Gets the value of the connection throttle setting.
|
static ConsoleCommandSender |
getConsoleSender() |
Gets a
ConsoleCommandSender that may be used as an input source
for this server. |
static GameMode |
getDefaultGameMode() |
Gets the default
GameMode for new players. |
static Entity |
getEntity(java.util.UUID uuid) |
Gets an entity on the server by its UUID
|
static boolean |
getGenerateStructures() |
Get generate-structures setting.
|
static HelpMap |
getHelpMap() |
Gets the
HelpMap providing help topics for this server. |
static int |
getIdleTimeout() |
Gets the idle kick timeout.
|
static java.lang.String |
getIp() |
Get the IP that this server is bound to, or empty string if not
specified.
|
static java.util.Set<java.lang.String> |
getIPBans() |
Gets a set containing all current IPs that are banned.
|
static ItemFactory |
getItemFactory() |
Gets the instance of the item factory (for
ItemMeta ). |
static java.util.logging.Logger |
getLogger() |
Returns the primary logger associated with this server instance.
|
static LootTable |
getLootTable(NamespacedKey key) |
Gets the specified
LootTable . |
static MapView |
getMap(short id) |
Deprecated.
Magic value
|
static int |
getMaxPlayers() |
Get the maximum amount of players which can login to this server.
|
static Messenger |
getMessenger() |
Gets the
Messenger responsible for this server. |
static int |
getMonsterSpawnLimit() |
Gets user-specified limit for number of monsters that can spawn in a
chunk.
|
static java.lang.String |
getMotd() |
Gets the message that is displayed on the server list.
|
static java.lang.String |
getName() |
Gets the name of this server implementation.
|
static OfflinePlayer |
getOfflinePlayer(java.lang.String name) |
Deprecated.
Persistent storage of users should be by UUID as names are no longer
unique past a single session.
|
static OfflinePlayer |
getOfflinePlayer(java.util.UUID id) |
Gets the player by the given UUID, regardless if they are offline or
online.
|
static OfflinePlayer[] |
getOfflinePlayers() |
Gets every player that has ever played on this server.
|
static boolean |
getOnlineMode() |
Gets whether the Server is in online mode or not.
|
static java.util.Collection<? extends Player> |
getOnlinePlayers() |
Gets a view of all currently logged in players.
|
static java.util.Set<OfflinePlayer> |
getOperators() |
Gets a set containing all player operators.
|
static Player |
getPlayer(java.lang.String name) |
Gets a player object by the given username.
|
static Player |
getPlayer(java.util.UUID id) |
Gets the player with the given UUID.
|
static Player |
getPlayerExact(java.lang.String name) |
Gets the player with the exact given name, case insensitive.
|
static PluginCommand |
getPluginCommand(java.lang.String name) |
Gets a
PluginCommand with the given name or alias. |
static PluginManager |
getPluginManager() |
Gets the plugin manager for interfacing with plugins.
|
static int |
getPort() |
Get the game port that the server runs on.
|
static java.util.List<Recipe> |
getRecipesFor(ItemStack result) |
Get a list of all recipes for a given item.
|
static BukkitScheduler |
getScheduler() |
Gets the scheduler for managing scheduled events.
|
static ScoreboardManager |
getScoreboardManager() |
Gets the instance of the scoreboard manager.
|
static Server |
getServer() |
Gets the current
Server singleton |
static CachedServerIcon |
getServerIcon() |
Gets an instance of the server's default server-icon.
|
static java.lang.String |
getServerId() |
Get an ID of this server.
|
static java.lang.String |
getServerName() |
Get the name of this server.
|
static ServicesManager |
getServicesManager() |
Gets a services manager.
|
static java.lang.String |
getShutdownMessage() |
Gets the default message that is displayed when the server is stopped.
|
static int |
getSpawnRadius() |
Gets the radius, in blocks, around each worlds spawn point to protect.
|
static <T extends Keyed> |
getTag(java.lang.String registry,
NamespacedKey tag,
java.lang.Class<T> clazz) |
Gets a tag which has already been defined within the server.
|
static int |
getTicksPerAnimalSpawns() |
Gets default ticks per animal spawns value.
|
static int |
getTicksPerMonsterSpawns() |
Gets the default ticks per monster spawns value.
|
static UnsafeValues |
getUnsafe() |
Deprecated.
|
static java.lang.String |
getUpdateFolder() |
Gets the name of the update folder.
|
static java.io.File |
getUpdateFolderFile() |
Gets the update folder.
|
static java.lang.String |
getVersion() |
Gets the version string of this server implementation.
|
static int |
getViewDistance() |
Get the view distance from this server.
|
static Warning.WarningState |
getWarningState() |
Gets the current warning state for the server.
|
static int |
getWaterAnimalSpawnLimit() |
Gets user-specified limit for number of water animals that can spawn in
a chunk.
|
static java.util.Set<OfflinePlayer> |
getWhitelistedPlayers() |
Gets a list of whitelisted players.
|
static World |
getWorld(java.lang.String name) |
Gets the world with the given name.
|
static World |
getWorld(java.util.UUID uid) |
Gets the world from the given Unique ID.
|
static java.io.File |
getWorldContainer() |
Gets the folder that contains all of the various
World s. |
static java.util.List<World> |
getWorlds() |
Gets a list of all worlds on this server.
|
static java.lang.String |
getWorldType() |
Get world type (level-type setting) for default world.
|
static boolean |
hasWhitelist() |
Gets whether this server has a whitelist or not.
|
static boolean |
isHardcore() |
Gets whether the server is in hardcore mode or not.
|
static boolean |
isPrimaryThread() |
Checks the current thread against the expected primary thread for the
server.
|
static CachedServerIcon |
loadServerIcon(java.awt.image.BufferedImage image) |
Creates a cached server-icon for the specific image.
|
static CachedServerIcon |
loadServerIcon(java.io.File file) |
Loads an image from a file, and returns a cached image for the specific
server-icon.
|
static java.util.List<Player> |
matchPlayer(java.lang.String name) |
Attempts to match any players with the given name, and returns a list
of all possibly matches.
|
static java.util.Iterator<Recipe> |
recipeIterator() |
Get an iterator through the list of crafting recipes.
|
static void |
reload() |
Reloads the server, refreshing settings and plugin information.
|
static void |
reloadData() |
Reload only the Minecraft data for the server.
|
static void |
reloadWhitelist() |
Reloads the whitelist from disk.
|
static void |
resetRecipes() |
Resets the list of crafting recipes to the default.
|
static void |
savePlayers() |
Writes loaded players to disk.
|
static void |
setDefaultGameMode(GameMode mode) |
Sets the default
GameMode for new players. |
static void |
setIdleTimeout(int threshold) |
Set the idle kick timeout.
|
static void |
setServer(Server server) |
Attempts to set the
Server singleton. |
static void |
setSpawnRadius(int value) |
Sets the radius, in blocks, around each worlds spawn point to protect.
|
static void |
setWhitelist(boolean value) |
Sets if the server is whitelisted.
|
static void |
shutdown() |
Shutdowns the server, stopping everything.
|
static Server.Spigot |
spigot() |
|
static void |
unbanIP(java.lang.String address) |
Unbans the specified address from the server.
|
static boolean |
unloadWorld(java.lang.String name,
boolean save) |
Unloads a world with the given name.
|
static boolean |
unloadWorld(World world,
boolean save) |
Unloads the given world.
|
public static Server getServer()
Server
singletonpublic static void setServer(Server server)
Server
singleton.
This cannot be done if the Server is already set.
server
- Server instancepublic static java.lang.String getName()
public static java.lang.String getVersion()
public static java.lang.String getBukkitVersion()
public static java.util.Collection<? extends Player> getOnlinePlayers()
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.
public static int getMaxPlayers()
public static int getPort()
public static int getViewDistance()
public static java.lang.String getIp()
public static java.lang.String getServerName()
public static java.lang.String getServerId()
public static java.lang.String getWorldType()
public static boolean getGenerateStructures()
public static boolean getAllowEnd()
public static boolean getAllowNether()
public static boolean hasWhitelist()
public static void setWhitelist(boolean value)
value
- true for whitelist on, false for offpublic static java.util.Set<OfflinePlayer> getWhitelistedPlayers()
public static void reloadWhitelist()
public static int broadcastMessage(java.lang.String message)
This is the same as calling broadcast(java.lang.String,
java.lang.String)
to Server.BROADCAST_CHANNEL_USERS
message
- the messagepublic static java.lang.String getUpdateFolder()
The update folder name is relative to the plugins folder.
public static java.io.File getUpdateFolderFile()
public static long getConnectionThrottle()
public static int getTicksPerAnimalSpawns()
Example Usage:
Note: If set to 0, animal spawning will be disabled. We recommend using spawn-animals to control this instead.
Minecraft default: 400.
public static int getTicksPerMonsterSpawns()
Example Usage:
Note: If set to 0, monsters spawning will be disabled. We recommend using spawn-monsters to control this instead.
Minecraft default: 1.
public static Player getPlayer(java.lang.String name)
This method may not return objects for offline players.
name
- the name to look uppublic static Player getPlayerExact(java.lang.String name)
name
- Exact name of the player to retrievepublic static java.util.List<Player> matchPlayer(java.lang.String name)
This list is not sorted in any particular order. If an exact match is found, the returned list will only contain a single result.
name
- the (partial) name to matchpublic static Player getPlayer(java.util.UUID id)
id
- UUID of the player to retrievepublic static PluginManager getPluginManager()
public static BukkitScheduler getScheduler()
public static ServicesManager getServicesManager()
public static java.util.List<World> getWorlds()
public static World createWorld(WorldCreator creator)
If the world is already loaded, it will just return the equivalent of getWorld(creator.name()).
creator
- the options to use when creating the worldpublic static boolean unloadWorld(java.lang.String name, boolean save)
name
- Name of the world to unloadsave
- whether to save the chunks before unloadingpublic static boolean unloadWorld(World world, boolean save)
world
- the world to unloadsave
- whether to save the chunks before unloadingpublic static World getWorld(java.lang.String name)
name
- the name of the world to retrievepublic static World getWorld(java.util.UUID uid)
uid
- a unique-id of the world to retrieve@Deprecated public static MapView getMap(short id)
id
- the id of the map to getpublic static MapView createMap(World world)
world
- the world the map will belong topublic static void reload()
public static void reloadData()
public static java.util.logging.Logger getLogger()
public static PluginCommand getPluginCommand(java.lang.String name)
PluginCommand
with the given name or alias.name
- the name of the command to retrievepublic static void savePlayers()
public static boolean dispatchCommand(CommandSender sender, java.lang.String commandLine) throws CommandException
sender
- the apparent sender of the commandcommandLine
- the command + arguments. Example: test abc
123
CommandException
- thrown when the executor for the given command
fails with an unhandled exceptionpublic static boolean addRecipe(Recipe recipe)
recipe
- the recipe to addpublic static java.util.List<Recipe> getRecipesFor(ItemStack result)
result
- the item to match against recipe resultspublic static java.util.Iterator<Recipe> recipeIterator()
public static void clearRecipes()
public static void resetRecipes()
public static java.util.Map<java.lang.String,java.lang.String[]> getCommandAliases()
public static int getSpawnRadius()
public static void setSpawnRadius(int value)
value
- new spawn radius, or 0 if nonepublic static boolean getOnlineMode()
public static boolean getAllowFlight()
public static boolean isHardcore()
public static void shutdown()
public static int broadcast(java.lang.String message, java.lang.String permission)
message
- message to broadcastpermission
- the required permission permissibles
must have to receive the broadcast@Deprecated public static OfflinePlayer getOfflinePlayer(java.lang.String name)
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.
name
- the name the player to retrievegetOfflinePlayer(java.util.UUID)
public static OfflinePlayer getOfflinePlayer(java.util.UUID id)
This will return an object even if the player does not exist. To this method, all players will exist.
id
- the UUID of the player to retrievepublic static java.util.Set<java.lang.String> getIPBans()
public static void banIP(java.lang.String address)
address
- the IP address to banpublic static void unbanIP(java.lang.String address)
address
- the IP address to unbanpublic static java.util.Set<OfflinePlayer> getBannedPlayers()
public static BanList getBanList(BanList.Type 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.
type
- the type of list to fetch, cannot be nullpublic static java.util.Set<OfflinePlayer> getOperators()
public static GameMode getDefaultGameMode()
GameMode
for new players.public static void setDefaultGameMode(GameMode mode)
GameMode
for new players.mode
- the new game modepublic static ConsoleCommandSender getConsoleSender()
ConsoleCommandSender
that may be used as an input source
for this server.public static java.io.File getWorldContainer()
World
s.public static OfflinePlayer[] getOfflinePlayers()
public static Messenger getMessenger()
Messenger
responsible for this server.public static HelpMap getHelpMap()
HelpMap
providing help topics for this server.public static Inventory createInventory(InventoryHolder owner, InventoryType type)
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 ItemStack
s
for possible enchanting results. Use
HumanEntity.openEnchanting(Location, boolean)
instead.owner
- the holder of the inventory, or null to indicate no holdertype
- the type of inventory to createjava.lang.IllegalArgumentException
- if the InventoryType
cannot be
viewed.InventoryType.isCreatable()
public static Inventory createInventory(InventoryHolder owner, InventoryType type, java.lang.String title)
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 ItemStack
s
for possible enchanting results. Use
HumanEntity.openEnchanting(Location, boolean)
instead.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.java.lang.IllegalArgumentException
- if the InventoryType
cannot be
viewed.InventoryType.isCreatable()
public static Inventory createInventory(InventoryHolder owner, int size) throws java.lang.IllegalArgumentException
InventoryType.CHEST
with the
specified size.owner
- the holder of the inventory, or null to indicate no holdersize
- a multiple of 9 as the size of inventory to createjava.lang.IllegalArgumentException
- if the size is not a multiple of 9public static Inventory createInventory(InventoryHolder owner, int size, java.lang.String title) throws java.lang.IllegalArgumentException
InventoryType.CHEST
with the
specified size and title.owner
- the holder of the inventory, or null to indicate no holdersize
- a multiple of 9 as the size of inventory to createtitle
- the title of the inventory, displayed when inventory is
viewedjava.lang.IllegalArgumentException
- if the size is not a multiple of 9public static Merchant createMerchant(java.lang.String title)
title
- the title of the corresponding merchant inventory, displayed
when the merchant inventory is viewedpublic static int getMonsterSpawnLimit()
public static int getAnimalSpawnLimit()
public static int getWaterAnimalSpawnLimit()
public static int getAmbientSpawnLimit()
public static boolean isPrimaryThread()
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.
public static java.lang.String getMotd()
public static java.lang.String getShutdownMessage()
public static Warning.WarningState getWarningState()
public static ItemFactory getItemFactory()
ItemMeta
).ItemFactory
public static ScoreboardManager getScoreboardManager()
This will only exist after the first world has loaded.
public static CachedServerIcon getServerIcon()
public static CachedServerIcon loadServerIcon(java.io.File file) throws java.lang.IllegalArgumentException, java.lang.Exception
Size and type are implementation defined. An incompatible file is
guaranteed to throw an implementation-defined Exception
.
file
- the file to load the fromServerListPingEvent.setServerIcon(CachedServerIcon)
java.lang.IllegalArgumentException
- if image is nulljava.lang.Exception
- if the image does not meet current server server-icon
specificationspublic static CachedServerIcon loadServerIcon(java.awt.image.BufferedImage image) throws java.lang.IllegalArgumentException, java.lang.Exception
Size and type are implementation defined. An incompatible file is
guaranteed to throw an implementation-defined Exception
.
image
- the image to useServerListPingEvent.setServerIcon(CachedServerIcon)
java.lang.IllegalArgumentException
- if image is nulljava.lang.Exception
- if the image does not meet current server
server-icon specificationspublic static void setIdleTimeout(int threshold)
A value of 0 will disable the idle kick timeout.
threshold
- the idle timeout in minutespublic static int getIdleTimeout()
public static ChunkGenerator.ChunkData createChunkData(World world)
ChunkGenerator.generateChunkData(org.bukkit.World, java.util.Random, int, int, org.bukkit.generator.ChunkGenerator.BiomeGrid)
world
- the world to create the ChunkData forpublic static BossBar createBossBar(java.lang.String title, BarColor color, BarStyle style, BarFlag... flags)
title
- the title of the boss barcolor
- the color of the boss barstyle
- the style of the boss barflags
- an optional list of flags to set on the boss barpublic static Entity getEntity(java.util.UUID uuid)
uuid
- the UUID of the entitypublic static Advancement getAdvancement(NamespacedKey key)
key
- unique advancement keypublic static java.util.Iterator<Advancement> advancementIterator()
public static BlockData createBlockData(Material material)
BlockData
instance for the specified Material, with
all properties initialized to unspecified defaults.material
- the materialpublic static BlockData createBlockData(Material material, java.util.function.Consumer<BlockData> consumer)
BlockData
instance for the specified Material, with
all properties initialized to unspecified defaults.material
- the materialconsumer
- consumer to run on new instance before returningpublic static BlockData createBlockData(java.lang.String data) throws java.lang.IllegalArgumentException
BlockData
instance with material and properties
parsed from provided data.data
- data stringjava.lang.IllegalArgumentException
- if the specified data is not validpublic static BlockData createBlockData(Material material, java.lang.String data) throws java.lang.IllegalArgumentException
BlockData
instance for the specified Material, with
all properties initialized to unspecified defaults, except for those
provided in data.material
- the materialdata
- data stringjava.lang.IllegalArgumentException
- if the specified data is not validpublic static <T extends Keyed> Tag<T> getTag(java.lang.String registry, NamespacedKey tag, java.lang.Class<T> clazz)
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.
Tag
.T
- type of the tagregistry
- the tag registry to look attag
- the name of the tagclazz
- the class of the tag entriespublic static LootTable getLootTable(NamespacedKey key)
LootTable
.key
- the name of the LootTable@Deprecated public static UnsafeValues getUnsafe()
UnsafeValues
public static Server.Spigot spigot()
Copyright © 2018. All rights reserved.