PluginMessageRecipient
public interface Server extends PluginMessageRecipient
Modifier and Type | Interface | Description |
---|---|---|
static class |
Server.Spigot |
Modifier and Type | Field | Description |
---|---|---|
static String |
BROADCAST_CHANNEL_ADMINISTRATIVE |
Used for all administrative messages, such as an operator using a
command.
|
static String |
BROADCAST_CHANNEL_USERS |
Used for all announcement messages, such as informing users that a
player has joined.
|
Modifier and Type | Method | Description |
---|---|---|
boolean |
addRecipe(@Nullable Recipe recipe) |
Adds a recipe to the crafting manager.
|
@NotNull Iterator<Advancement> |
advancementIterator() |
Get an iterator through all advancements.
|
void |
banIP(@NotNull String address) |
Bans the specified address from the server.
|
int |
broadcast(@NotNull String message,
@NotNull String permission) |
Broadcasts the specified message to every user with the given
permission name.
|
int |
broadcastMessage(@NotNull String message) |
Broadcast a message to all players.
|
void |
clearRecipes() |
Clears the list of crafting recipes.
|
@NotNull BlockData |
createBlockData(@NotNull String data) |
Creates a new
BlockData instance with material and properties
parsed from provided data. |
@NotNull BlockData |
createBlockData(@NotNull Material material) |
Creates a new
BlockData instance for the specified Material, with
all properties initialized to unspecified defaults. |
@NotNull BlockData |
createBlockData(@NotNull Material material,
@Nullable Consumer<BlockData> consumer) |
Creates a new
BlockData instance for the specified Material, with
all properties initialized to unspecified defaults. |
@NotNull BlockData |
createBlockData(@Nullable Material material,
@Nullable String data) |
Creates a new
BlockData instance for the specified Material, with
all properties initialized to unspecified defaults, except for those
provided in data. |
@NotNull KeyedBossBar |
createBossBar(@NotNull NamespacedKey key,
@Nullable String title,
@NotNull BarColor color,
@NotNull BarStyle style,
@NotNull BarFlag... flags) |
Creates a boss bar instance to display to players.
|
@NotNull BossBar |
createBossBar(@Nullable String title,
@NotNull BarColor color,
@NotNull BarStyle style,
@NotNull BarFlag... flags) |
Creates a boss bar instance to display to players.
|
ChunkGenerator.ChunkData |
createChunkData(@NotNull World world) |
Create a ChunkData for use in a generator.
|
@NotNull ItemStack |
createExplorerMap(@NotNull World world,
@NotNull Location location,
@NotNull StructureType structureType) |
Create a new explorer map targeting the closest nearby structure of a
given
StructureType . |
@NotNull ItemStack |
createExplorerMap(@NotNull World world,
@NotNull Location location,
@NotNull StructureType structureType,
int radius,
boolean findUnexplored) |
Create a new explorer map targeting the closest nearby structure of a
given
StructureType . |
@NotNull Inventory |
createInventory(@Nullable InventoryHolder owner,
int size) |
Creates an empty inventory of type
InventoryType.CHEST with the
specified size. |
@NotNull Inventory |
createInventory(@Nullable InventoryHolder owner,
int size,
@NotNull String title) |
Creates an empty inventory of type
InventoryType.CHEST with the
specified size and title. |
@NotNull Inventory |
createInventory(@Nullable InventoryHolder owner,
@NotNull InventoryType type) |
Creates an empty inventory with the specified type.
|
@NotNull Inventory |
createInventory(@Nullable InventoryHolder owner,
@NotNull InventoryType type,
@NotNull String title) |
Creates an empty inventory with the specified type and title.
|
@NotNull MapView |
createMap(@NotNull World world) |
Create a new map with an automatically assigned ID.
|
@NotNull Merchant |
createMerchant(@Nullable String title) |
Creates an empty merchant.
|
@Nullable World |
createWorld(@NotNull WorldCreator creator) |
Creates or loads a world with the given name using the specified
options.
|
boolean |
dispatchCommand(@NotNull CommandSender sender,
@NotNull String commandLine) |
Dispatches a command on this server, and executes it if found.
|
@Nullable Advancement |
getAdvancement(@NotNull NamespacedKey key) |
Get the advancement specified by this key.
|
boolean |
getAllowEnd() |
Gets whether this server allows the End or not.
|
boolean |
getAllowFlight() |
Gets whether this server allows flying or not.
|
boolean |
getAllowNether() |
Gets whether this server allows the Nether or not.
|
int |
getAmbientSpawnLimit() |
Gets user-specified limit for number of ambient mobs that can spawn in
a chunk.
|
int |
getAnimalSpawnLimit() |
Gets user-specified limit for number of animals that can spawn in a
chunk.
|
@NotNull BanList |
getBanList(BanList.Type type) |
Gets a ban list for the supplied type.
|
@NotNull Set<OfflinePlayer> |
getBannedPlayers() |
Gets a set containing all banned players.
|
@Nullable KeyedBossBar |
getBossBar(@NotNull NamespacedKey key) |
Gets the
KeyedBossBar specified by this key. |
@NotNull Iterator<KeyedBossBar> |
getBossBars() |
Gets an unmodifiable iterator through all persistent bossbars.
|
@NotNull String |
getBukkitVersion() |
Gets the Bukkit version that this server is running.
|
@NotNull Map<String,String[]> |
getCommandAliases() |
Gets a list of command aliases defined in the server properties.
|
long |
getConnectionThrottle() |
Gets the value of the connection throttle setting.
|
@NotNull ConsoleCommandSender |
getConsoleSender() |
Gets a
ConsoleCommandSender that may be used as an input source
for this server. |
@NotNull GameMode |
getDefaultGameMode() |
Gets the default
GameMode for new players. |
@Nullable Entity |
getEntity(@NotNull UUID uuid) |
Gets an entity on the server by its UUID
|
boolean |
getGenerateStructures() |
Get generate-structures setting.
|
@NotNull HelpMap |
getHelpMap() |
Gets the
HelpMap providing help topics for this server. |
int |
getIdleTimeout() |
Gets the idle kick timeout.
|
@NotNull String |
getIp() |
Get the IP that this server is bound to, or empty string if not
specified.
|
@NotNull Set<String> |
getIPBans() |
Gets a set containing all current IPs that are banned.
|
@NotNull ItemFactory |
getItemFactory() |
Gets the instance of the item factory (for
ItemMeta ). |
@NotNull Logger |
getLogger() |
Returns the primary logger associated with this server instance.
|
@Nullable LootTable |
getLootTable(@NotNull NamespacedKey key) |
Gets the specified
LootTable . |
@Nullable MapView |
getMap(int id) |
Deprecated.
Magic value
|
int |
getMaxPlayers() |
Get the maximum amount of players which can login to this server.
|
@NotNull Messenger |
getMessenger() |
Gets the
Messenger responsible for this server. |
int |
getMonsterSpawnLimit() |
Gets user-specified limit for number of monsters that can spawn in a
chunk.
|
@NotNull String |
getMotd() |
Gets the message that is displayed on the server list.
|
@NotNull String |
getName() |
Gets the name of this server implementation.
|
@NotNull OfflinePlayer |
getOfflinePlayer(@NotNull String name) |
Deprecated.
Persistent storage of users should be by UUID as names are no longer
unique past a single session.
|
@NotNull OfflinePlayer |
getOfflinePlayer(@NotNull UUID id) |
Gets the player by the given UUID, regardless if they are offline or
online.
|
@NotNull OfflinePlayer[] |
getOfflinePlayers() |
Gets every player that has ever played on this server.
|
boolean |
getOnlineMode() |
Gets whether the Server is in online mode or not.
|
@NotNull Collection<? extends Player> |
getOnlinePlayers() |
Gets a view of all currently logged in players.
|
@NotNull Set<OfflinePlayer> |
getOperators() |
Gets a set containing all player operators.
|
@Nullable Player |
getPlayer(@NotNull String name) |
Gets a player object by the given username.
|
@Nullable Player |
getPlayer(@NotNull UUID id) |
Gets the player with the given UUID.
|
@Nullable Player |
getPlayerExact(@NotNull String name) |
Gets the player with the exact given name, case insensitive.
|
@Nullable PluginCommand |
getPluginCommand(@NotNull String name) |
Gets a
PluginCommand with the given name or alias. |
@NotNull PluginManager |
getPluginManager() |
Gets the plugin manager for interfacing with plugins.
|
int |
getPort() |
Get the game port that the server runs on.
|
@NotNull List<Recipe> |
getRecipesFor(@NotNull ItemStack result) |
Get a list of all recipes for a given item.
|
@NotNull BukkitScheduler |
getScheduler() |
Gets the scheduler for managing scheduled events.
|
@Nullable ScoreboardManager |
getScoreboardManager() |
Gets the instance of the scoreboard manager.
|
@Nullable CachedServerIcon |
getServerIcon() |
Gets an instance of the server's default server-icon.
|
@NotNull ServicesManager |
getServicesManager() |
Gets a services manager.
|
@Nullable String |
getShutdownMessage() |
Gets the default message that is displayed when the server is stopped.
|
int |
getSpawnRadius() |
Gets the radius, in blocks, around each worlds spawn point to protect.
|
<T extends Keyed> |
getTag(@NotNull String registry,
@NotNull NamespacedKey tag,
@NotNull Class<T> clazz) |
Gets a tag which has already been defined within the server.
|
<T extends Keyed> |
getTags(@NotNull String registry,
@NotNull Class<T> clazz) |
Gets a all tags which have been defined within the server.
|
int |
getTicksPerAmbientSpawns() |
Gets the default ticks per ambient mob spawns value.
|
int |
getTicksPerAnimalSpawns() |
Gets default ticks per animal spawns value.
|
int |
getTicksPerMonsterSpawns() |
Gets the default ticks per monster spawns value.
|
int |
getTicksPerWaterSpawns() |
Gets the default ticks per water mob spawns value.
|
@NotNull UnsafeValues |
getUnsafe() |
Deprecated.
|
@NotNull String |
getUpdateFolder() |
Gets the name of the update folder.
|
@NotNull File |
getUpdateFolderFile() |
Gets the update folder.
|
@NotNull String |
getVersion() |
Gets the version string of this server implementation.
|
int |
getViewDistance() |
Get the view distance from this server.
|
@NotNull Warning.WarningState |
getWarningState() |
Gets the current warning state for the server.
|
int |
getWaterAnimalSpawnLimit() |
Gets user-specified limit for number of water animals that can spawn in
a chunk.
|
@NotNull Set<OfflinePlayer> |
getWhitelistedPlayers() |
Gets a list of whitelisted players.
|
@Nullable World |
getWorld(@NotNull String name) |
Gets the world with the given name.
|
@Nullable World |
getWorld(@NotNull UUID uid) |
Gets the world from the given Unique ID.
|
@NotNull File |
getWorldContainer() |
Gets the folder that contains all of the various
World s. |
@NotNull List<World> |
getWorlds() |
Gets a list of all worlds on this server.
|
@NotNull String |
getWorldType() |
Get world type (level-type setting) for default world.
|
boolean |
hasWhitelist() |
Gets whether this server has a whitelist or not.
|
boolean |
isHardcore() |
Gets whether the server is in hardcore mode or not.
|
boolean |
isPrimaryThread() |
Checks the current thread against the expected primary thread for the
server.
|
@NotNull CachedServerIcon |
loadServerIcon(@NotNull BufferedImage image) |
Creates a cached server-icon for the specific image.
|
@NotNull CachedServerIcon |
loadServerIcon(@NotNull File file) |
Loads an image from a file, and returns a cached image for the specific
server-icon.
|
@NotNull List<Player> |
matchPlayer(@NotNull String name) |
Attempts to match any players with the given name, and returns a list
of all possibly matches.
|
@NotNull Iterator<Recipe> |
recipeIterator() |
Get an iterator through the list of crafting recipes.
|
void |
reload() |
Reloads the server, refreshing settings and plugin information.
|
void |
reloadData() |
Reload only the Minecraft data for the server.
|
void |
reloadWhitelist() |
Reloads the whitelist from disk.
|
boolean |
removeBossBar(@NotNull NamespacedKey key) |
Removes a
KeyedBossBar specified by this key. |
boolean |
removeRecipe(@NotNull NamespacedKey key) |
Remove a recipe from the server.
|
void |
resetRecipes() |
Resets the list of crafting recipes to the default.
|
void |
savePlayers() |
Writes loaded players to disk.
|
@NotNull List<Entity> |
selectEntities(@NotNull CommandSender sender,
@NotNull String selector) |
Selects entities using the given Vanilla selector.
|
void |
setDefaultGameMode(@NotNull GameMode mode) |
Sets the default
GameMode for new players. |
void |
setIdleTimeout(int threshold) |
Set the idle kick timeout.
|
void |
setSpawnRadius(int value) |
Sets the radius, in blocks, around each worlds spawn point to protect.
|
void |
setWhitelist(boolean value) |
Sets if the server is whitelisted.
|
void |
shutdown() |
Shutdowns the server, stopping everything.
|
@NotNull Server.Spigot |
spigot() |
|
void |
unbanIP(@NotNull String address) |
Unbans the specified address from the server.
|
boolean |
unloadWorld(@NotNull String name,
boolean save) |
Unloads a world with the given name.
|
boolean |
unloadWorld(@NotNull World world,
boolean save) |
Unloads the given world.
|
getListeningPluginChannels, sendPluginMessage
static final String BROADCAST_CHANNEL_ADMINISTRATIVE
For use in broadcast(java.lang.String, java.lang.String)
.
static final String BROADCAST_CHANNEL_USERS
For use in broadcast(java.lang.String, java.lang.String)
.
@NotNull @NotNull String getName()
@NotNull @NotNull String getVersion()
@NotNull @NotNull String getBukkitVersion()
@NotNull @NotNull 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.
int getMaxPlayers()
int getPort()
int getViewDistance()
@NotNull @NotNull String getIp()
@NotNull @NotNull String getWorldType()
boolean getGenerateStructures()
boolean getAllowEnd()
boolean getAllowNether()
boolean hasWhitelist()
void setWhitelist(boolean value)
value
- true for whitelist on, false for off@NotNull @NotNull Set<OfflinePlayer> getWhitelistedPlayers()
void reloadWhitelist()
int broadcastMessage(@NotNull @NotNull String message)
This is the same as calling broadcast(java.lang.String,
java.lang.String)
to BROADCAST_CHANNEL_USERS
message
- the message@NotNull @NotNull String getUpdateFolder()
The update folder name is relative to the plugins folder.
@NotNull @NotNull File getUpdateFolderFile()
long getConnectionThrottle()
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.
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.
int getTicksPerWaterSpawns()
Example Usage:
Note: If set to 0, water mobs spawning will be disabled.
Minecraft default: 1.
int getTicksPerAmbientSpawns()
Example Usage:
Note: If set to 0, ambient mobs spawning will be disabled.
Minecraft default: 1.
@Nullable @Nullable Player getPlayer(@NotNull @NotNull String name)
This method may not return objects for offline players.
name
- the name to look up@Nullable @Nullable Player getPlayerExact(@NotNull @NotNull String name)
name
- Exact name of the player to retrieve@NotNull @NotNull List<Player> matchPlayer(@NotNull @NotNull 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 match@Nullable @Nullable Player getPlayer(@NotNull @NotNull UUID id)
id
- UUID of the player to retrieve@NotNull @NotNull PluginManager getPluginManager()
@NotNull @NotNull BukkitScheduler getScheduler()
@NotNull @NotNull ServicesManager getServicesManager()
@NotNull @NotNull List<World> getWorlds()
@Nullable @Nullable World createWorld(@NotNull @NotNull 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 worldboolean unloadWorld(@NotNull @NotNull String name, boolean save)
name
- Name of the world to unloadsave
- whether to save the chunks before unloadingboolean unloadWorld(@NotNull @NotNull World world, boolean save)
world
- the world to unloadsave
- whether to save the chunks before unloading@Nullable @Nullable World getWorld(@NotNull @NotNull String name)
name
- the name of the world to retrieve@Nullable @Nullable World getWorld(@NotNull @NotNull UUID uid)
uid
- a unique-id of the world to retrieve@Deprecated @Nullable @Nullable MapView getMap(int id)
id
- the id of the map to get@NotNull @NotNull MapView createMap(@NotNull @NotNull World world)
world
- the world the map will belong to@NotNull @NotNull ItemStack createExplorerMap(@NotNull @NotNull World world, @NotNull @NotNull Location location, @NotNull @NotNull StructureType structureType)
StructureType
.
world
- the world the map will belong tolocation
- the origin location to find the nearest structurestructureType
- the type of structure to findWorld.locateNearestStructure(org.bukkit.Location,
org.bukkit.StructureType, int, boolean)
@NotNull @NotNull ItemStack createExplorerMap(@NotNull @NotNull World world, @NotNull @NotNull Location location, @NotNull @NotNull StructureType structureType, int radius, boolean findUnexplored)
StructureType
.
world
- the world the map will belong tolocation
- the origin location to find the nearest structurestructureType
- the type of structure to findradius
- radius to search, see World#locateNearestStructure for more
informationfindUnexplored
- whether to find unexplored structuresWorld.locateNearestStructure(org.bukkit.Location,
org.bukkit.StructureType, int, boolean)
void reload()
void reloadData()
@NotNull @NotNull Logger getLogger()
@Nullable @Nullable PluginCommand getPluginCommand(@NotNull @NotNull String name)
PluginCommand
with the given name or alias.name
- the name of the command to retrievevoid savePlayers()
boolean dispatchCommand(@NotNull @NotNull CommandSender sender, @NotNull @NotNull 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 exception@Contract("null -> false") boolean addRecipe(@Nullable @Nullable Recipe recipe)
recipe
- the recipe to add@NotNull @NotNull List<Recipe> getRecipesFor(@NotNull @NotNull ItemStack result)
result
- the item to match against recipe results@NotNull @NotNull Iterator<Recipe> recipeIterator()
void clearRecipes()
void resetRecipes()
boolean removeRecipe(@NotNull @NotNull NamespacedKey key)
key
- NamespacedKey of recipe to remove.@NotNull @NotNull Map<String,String[]> getCommandAliases()
int getSpawnRadius()
void setSpawnRadius(int value)
value
- new spawn radius, or 0 if noneboolean getOnlineMode()
boolean getAllowFlight()
boolean isHardcore()
void shutdown()
int broadcast(@NotNull @NotNull String message, @NotNull @NotNull String permission)
message
- message to broadcastpermission
- the required permission permissibles
must have to receive the broadcast@Deprecated @NotNull @NotNull OfflinePlayer getOfflinePlayer(@NotNull @NotNull 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)
@NotNull @NotNull OfflinePlayer getOfflinePlayer(@NotNull @NotNull 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 retrieve@NotNull @NotNull Set<String> getIPBans()
void banIP(@NotNull @NotNull String address)
address
- the IP address to banvoid unbanIP(@NotNull @NotNull String address)
address
- the IP address to unban@NotNull @NotNull Set<OfflinePlayer> getBannedPlayers()
@NotNull @NotNull BanList getBanList(@NotNull 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 null@NotNull @NotNull Set<OfflinePlayer> getOperators()
@NotNull @NotNull GameMode getDefaultGameMode()
GameMode
for new players.void setDefaultGameMode(@NotNull @NotNull GameMode mode)
GameMode
for new players.mode
- the new game mode@NotNull @NotNull ConsoleCommandSender getConsoleSender()
ConsoleCommandSender
that may be used as an input source
for this server.@NotNull @NotNull File getWorldContainer()
World
s.@NotNull @NotNull OfflinePlayer[] getOfflinePlayers()
@NotNull @NotNull Messenger getMessenger()
Messenger
responsible for this server.@NotNull @NotNull HelpMap getHelpMap()
HelpMap
providing help topics for this server.@NotNull @NotNull Inventory createInventory(@Nullable @Nullable InventoryHolder owner, @NotNull @NotNull 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 createIllegalArgumentException
- if the InventoryType
cannot be
viewed.InventoryType.isCreatable()
@NotNull @NotNull Inventory createInventory(@Nullable @Nullable InventoryHolder owner, @NotNull @NotNull InventoryType type, @NotNull @NotNull 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.IllegalArgumentException
- if the InventoryType
cannot be
viewed.InventoryType.isCreatable()
@NotNull @NotNull Inventory createInventory(@Nullable @Nullable InventoryHolder owner, int size) throws 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 createIllegalArgumentException
- if the size is not a multiple of 9@NotNull @NotNull Inventory createInventory(@Nullable @Nullable InventoryHolder owner, int size, @NotNull @NotNull String title) throws 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
viewedIllegalArgumentException
- if the size is not a multiple of 9@NotNull @NotNull Merchant createMerchant(@Nullable @Nullable String title)
title
- the title of the corresponding merchant inventory, displayed
when the merchant inventory is viewedint getMonsterSpawnLimit()
int getAnimalSpawnLimit()
int getWaterAnimalSpawnLimit()
int getAmbientSpawnLimit()
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.
@NotNull @NotNull String getMotd()
@Nullable @Nullable String getShutdownMessage()
@NotNull @NotNull Warning.WarningState getWarningState()
@NotNull @NotNull ItemFactory getItemFactory()
ItemMeta
).ItemFactory
@Nullable @Nullable ScoreboardManager getScoreboardManager()
This will only exist after the first world has loaded.
@Nullable @Nullable CachedServerIcon getServerIcon()
@NotNull @NotNull CachedServerIcon loadServerIcon(@NotNull @NotNull File file) throws IllegalArgumentException, 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)
IllegalArgumentException
- if image is nullException
- if the image does not meet current server server-icon
specifications@NotNull @NotNull CachedServerIcon loadServerIcon(@NotNull @NotNull BufferedImage image) throws IllegalArgumentException, 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)
IllegalArgumentException
- if image is nullException
- if the image does not meet current server
server-icon specificationsvoid setIdleTimeout(int threshold)
A value of 0 will disable the idle kick timeout.
threshold
- the idle timeout in minutesint getIdleTimeout()
@NotNull ChunkGenerator.ChunkData createChunkData(@NotNull @NotNull World world)
ChunkGenerator.generateChunkData(org.bukkit.World, java.util.Random, int, int, org.bukkit.generator.ChunkGenerator.BiomeGrid)
world
- the world to create the ChunkData for@NotNull @NotNull BossBar createBossBar(@Nullable @Nullable String title, @NotNull @NotNull BarColor color, @NotNull @NotNull BarStyle style, @NotNull @NotNull 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 bar@NotNull @NotNull KeyedBossBar createBossBar(@NotNull @NotNull NamespacedKey key, @Nullable @Nullable String title, @NotNull @NotNull BarColor color, @NotNull @NotNull BarStyle style, @NotNull @NotNull BarFlag... flags)
key
- the key of the boss bar that is used to access the boss bartitle
- 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 bar@NotNull @NotNull Iterator<KeyedBossBar> getBossBars()
Boss
createBossBar(String, BarColor, BarStyle, BarFlag...)
@Nullable @Nullable KeyedBossBar getBossBar(@NotNull @NotNull NamespacedKey key)
KeyedBossBar
specified by this key.
Boss
createBossBar(String, BarColor, BarStyle, BarFlag...)
key
- unique bossbar keyboolean removeBossBar(@NotNull @NotNull NamespacedKey key)
KeyedBossBar
specified by this key.
Boss
createBossBar(String, BarColor, BarStyle, BarFlag...)
key
- unique bossbar key@Nullable @Nullable Entity getEntity(@NotNull @NotNull UUID uuid)
uuid
- the UUID of the entity@Nullable @Nullable Advancement getAdvancement(@NotNull @NotNull NamespacedKey key)
key
- unique advancement key@NotNull @NotNull Iterator<Advancement> advancementIterator()
@NotNull @NotNull BlockData createBlockData(@NotNull @NotNull Material material)
BlockData
instance for the specified Material, with
all properties initialized to unspecified defaults.material
- the material@NotNull @NotNull BlockData createBlockData(@NotNull @NotNull Material material, @Nullable @Nullable 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 returning@NotNull @NotNull BlockData createBlockData(@NotNull @NotNull String data) throws IllegalArgumentException
BlockData
instance with material and properties
parsed from provided data.data
- data stringIllegalArgumentException
- if the specified data is not valid@NotNull @Contract("null, null -> fail") @NotNull BlockData createBlockData(@Nullable @Nullable Material material, @Nullable @Nullable String data) throws IllegalArgumentException
BlockData
instance for the specified Material, with
all properties initialized to unspecified defaults, except for those
provided in data.
material
is specified, then the data string must not also
contain the material.material
- the materialdata
- data stringIllegalArgumentException
- if the specified data is not valid@Nullable <T extends Keyed> @Nullable Tag<T> getTag(@NotNull @NotNull String registry, @NotNull @NotNull NamespacedKey tag, @NotNull @NotNull 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 entries@NotNull <T extends Keyed> @NotNull Iterable<Tag<T>> getTags(@NotNull @NotNull String registry, @NotNull @NotNull Class<T> clazz)
Tag
.
T
- type of the tagregistry
- the tag registry to look atclazz
- the class of the tag entries@Nullable @Nullable LootTable getLootTable(@NotNull @NotNull NamespacedKey key)
LootTable
.key
- the name of the LootTable@NotNull @NotNull List<Entity> selectEntities(@NotNull @NotNull CommandSender sender, @NotNull @NotNull String selector) throws IllegalArgumentException
sender
- the sender to execute as, must be providedselector
- the selection stringIllegalArgumentException
- if the selector is malformed in any way
or a parameter is null@Deprecated @NotNull @NotNull UnsafeValues getUnsafe()
UnsafeValues
@NotNull @NotNull Server.Spigot spigot()
Copyright © 2020. All rights reserved.