程序包 org.bukkit

接口 Server

所有超级接口:
PluginMessageRecipient
public interface Server extends PluginMessageRecipient
代表执行插件的服务器.

  • 字段详细资料

  • 方法详细资料

    • getName

      String getName()
      获得服务器名字.

      原文:Gets the name of this server implementation.

      返回:
      服务器名字

    • getVersion

      String getVersion()
      获得服务器版本字符串.

      原文:Gets the version string of this server implementation.

      返回:
      服务器版本字符串

    • getBukkitVersion

      String getBukkitVersion()
      获得服务器运行的Bukkit版本.

      原文:Gets the Bukkit version that this server is running.

      返回:
      Bukkit版本

    • getOnlinePlayers

      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.

      返回:
      当前所有已登录玩家的集合.

    • getMaxPlayers

      int getMaxPlayers()
      获得服务器可同时在线玩家最高人数.

      原文:Get the maximum amount of players which can login to this server.

      返回:
      同时在线玩家最高人数

    • getPort

      int getPort()
      获得服务器端口.

      原文:Get the game port that the server runs on.

      返回:
      服务器端口

    • getViewDistance

      int getViewDistance()
      获得当前设置的视距

      原文:Get the view distance from this server.

      返回:
      服务器当前设置的视距.

    • getIp

      String getIp()
      获得当前服务器绑定的IP,当未设置时返回为空

      原文:Get the IP that this server is bound to, or empty string if not specified.

      返回:
      获得当前服务器绑定的IP,未绑定则为空

    • getServerName

      String getServerName()
      获得服务器名字.

      原文:Get the name of this server.

      返回:
      服务器名字

    • getServerId

      String getServerId()
      获得服务器的ID,该ID通常由数字和字母组成,这个ID可以用于识别服务器

      原文:Get an ID of this server. The ID is a simple generally alphanumeric ID that can be used for uniquely identifying this server.

      返回:
      服务器的ID

    • getWorldType

      String getWorldType()
      获得主世界的世界类型(检测主世界的世界类型).

      原文:Get world type (level-type setting) for default world.

      返回:
      世界类型(比如:DEFAULT, FLAT, DEFAULT_1_1)

    • getGenerateStructures

      boolean getGenerateStructures()
      获得是否允许生成器构造(对应server.properties文件中的generate-structures)

      原文:Get generate-structures setting.

      返回:
      当启用时返回true否则返回false

    • getAllowEnd

      boolean getAllowEnd()
      获取该服务器是否允许末地

      原文:Gets whether this server allows the End or not.

      返回:
      允许则返回true,否则返回false

    • getAllowNether

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

    • hasWhitelist

      boolean hasWhitelist()
      获取该服务器是否有白名单

      原文:Gets whether this server has a whitelist or not.

      返回:
      有则返回true,否则返回false

    • setWhitelist

      void setWhitelist(boolean value)
      设置该服务器是是否开启白名单

      原文:Sets if the server is whitelisted.

      参数:
      value - 为true时则开启白名单,false则关闭白名单

    • getWhitelistedPlayers

      Set<OfflinePlayer> getWhitelistedPlayers()
      获得所有在白名单中的玩家.

      原文:Gets a list of whitelisted players.

      返回:
      白名单中的玩家

    • reloadWhitelist

      void reloadWhitelist()
      重新加载服务器白名单配置.

      原文:Reloads the whitelist from disk.

    • broadcastMessage

      int broadcastMessage(String message)
      广播一条消息到所有玩家.

      这与调用broadcast(java.lang.String, java.lang.String)(第二个参数为BROADCAST_CHANNEL_USERS)相当。

      原文:Broadcast a message to all players.

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

      参数:
      message - 要广播的消息
      返回:
      成功接收此消息的玩家数

    • getUpdateFolder

      String getUpdateFolder()
      获取更新文件夹的名字. 系统将会在插件加载时选择适当的时机利用此文件夹来安全地更新插件.

      更新文件夹相对于插件文件夹.

      Tips：如何使用更新文件夹来实现更新您的插件呢？（服主和开发者都可以了解下)：

      1. 创建更新文件夹，已有则跳过此步.
      2. 下载您要更新的插件到此目录 (注意：jar文件名必须和在插件目录下的jar文件名一样，否则不起作用。).
      3. 重载/重启服务器.
      4. OK，看效果吧.
      原文: 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.

      返回:
      更新文件夹的名字

    • getUpdateFolderFile

      File getUpdateFolderFile()
      获取表示更新文件夹的 File 实例. 系统将会在插件加载时选择适当的时机利用此文件夹来安全地更新插件.

      原文: Gets the update folder. The update folder is used to safely update plugins at the right moment on a plugin load.

      返回:
      表示更新文件夹的 File 实例

    • getConnectionThrottle

      long getConnectionThrottle()
      获取玩家重连服务器的间隔(-1则为无限制)

      原文:Gets the value of the connection throttle setting.

      返回:
      返回玩家重连服务器的间隔

    • getTicksPerAnimalSpawns

      int getTicksPerAnimalSpawns()
      获得每隔多少ticks生成动物

      原文:Gets default ticks per animal spawns value.

      示例:

      • 值为1时服务器将尝试每tick都生成动物
      • 值为400服务器将每400tick尝试生成一次动物
      • 一个低于0的值将会被重置设为默认值(默认为400)

      注意:如果设置为0,动物生成将会被禁止,我们推荐使用spawn-animals代替用于控制动物生成

      返回:
      返回生成动物间隔的tick

    • getTicksPerMonsterSpawns

      int getTicksPerMonsterSpawns()
      获得每隔多少ticks生成怪物

      原文:Gets the default ticks per monster spawns value.

      示例:

      • 值为1时服务器将尝试每tick都生成怪物
      • 值为400服务器将每400tick尝试生成一次怪物
      • 一个低于0的值将会被重重设为默认值(默认为1)

      注意:如果设置为0,动物生成将会被禁止,我们推荐使用spawn-monsters代替用于控制动物生成

      返回:
      返回生成怪物间隔的tick

    • getPlayer

      @Deprecated Player getPlayer(String name)
      已过时。
      请使用 getPlayer(UUID) 用玩家名查找无法保证唯一性
      根据玩家的名字来获取一个玩家的实例

      原文:Gets a player object by the given username.

      这个方法不会返回不在线玩家的实例(意思就是说获取的玩家必须在线,否则返回null)

      参数:
      name - 被查找玩家的名字
      返回:
      一个在线玩家实例或者null

    • getPlayerExact

      @Deprecated Player getPlayerExact(String name)
      已过时。
      请使用 getPlayer(UUID) 用玩家名查找无法保证唯一性
      通过玩家名准确的查找来获得一个玩家实例,避免大小写问题(译注:该方法使用频率极低)

      原文:Gets the player with the exact given name, case insensitive.

      参数:
      name - 被查找玩家的准确名字
      返回:
      一个在线玩家的实例或者null

    • matchPlayer

      @Deprecated List<Player> matchPlayer(String name)
      已过时。
      请使用 getPlayer(UUID) 用玩家名查找无法保证唯一性
      尝试用name匹配所有玩家并且返回一个所有匹配玩家的List

      原文:Attempts to match any players with the given name, and returns a list of all possibly matches.

      该list未排序,如果准确匹配到某个玩家则该List仅包含该玩家

      原文: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 - 匹配玩家名
      返回:
      所有匹配玩家的List(译注:遍历该List时记得检测玩家是否在线)

    • getPlayer

      Player getPlayer(UUID id)
      通过UUID获取玩家的实例

      原文:Gets the player with the given UUID.

      参数:
      id - 用于检索玩家的UUID
      返回:
      一个在线玩家的实例或者null

    • getPluginManager

      PluginManager getPluginManager()
      获取PluginManager接口的实例

      原文:Gets the plugin manager for interfacing with plugins.

      返回:
      返回PluginManager接口的实例

    • getScheduler

      BukkitScheduler getScheduler()
      获取BukkitScheduler接口的实例用来安排任务

      原文:Gets the scheduler for managing scheduled events.

      返回:
      BukkitScheduler接口的实例

    • getServicesManager

      ServicesManager getServicesManager()
      获取ServicesManager

      原文:Gets a services manager.

      返回:
      返回ServicesManager

    • getWorlds

      List<World> getWorlds()
      获取服务器以List封装的所有World

      原文:Gets a list of all worlds on this server.

      返回:
      一个包含服务器所有World的List

    • createWorld

      World createWorld(WorldCreator creator)
      使用给定的名字和配置来创建或者加载一个World

      原文:Creates or loads a world with the given name using the specified options.

      如果该World已经被加载,它相当于返回getWorld(creator.name())

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

      参数:
      creator - 世界生成器
      返回:
      返回新建的World或者已被服务器加载的World实例

    • unloadWorld

      boolean unloadWorld(String name, boolean save)
      通过给定的名字从服务器卸载一个World

      原文:Unloads a world with the given name.

      参数:
      name - 需要被卸载的世界的名字
      save - 是否在卸载World前保存区块数据
      返回:
      成功则返回true否则返回fasle

    • unloadWorld

      boolean unloadWorld(World world, boolean save)
      通过给定的Wrold实例从服务器卸载一个World

      原文:Unloads the given world.

      参数:
      world - 被卸载的World实例
      save - 是否在卸载World前保存区块数据
      返回:
      成功则返回true否则返回fasle

    • getWorld

      World getWorld(String name)
      通过给定的name获取一个World实例

      原文:Gets the world with the given name.

      参数:
      name - 被获取世界的name
      返回:
      World实例,当世界不存在时将返回null

    • getWorld

      World getWorld(UUID uid)
      通过UUID获取World实例

      原文:Gets the world from the given Unique ID.

      参数:
      uid - 被获取的World的UUID
      返回:
      World实例,当世界不存在时将返回null

    • getMap

      @Deprecated MapView getMap(short id)
      已过时。
      不安全的参数
      通过给定的item ID获取MapView实例

      原文:Gets the map from the given item ID.

      参数:
      id - 需要被获取的Map的id
      返回:
      MapView实例,当Map不存在时将返回null

    • createMap

      MapView createMap(World world)
      创建一个新的MapView实例并且自动分配ID

      Create a new map with an automatically assigned ID.

      参数:
      world - 该Map所属的World
      返回:
      一个新的MapView实例

    • reload

      void reload()
      重新加载服务器并刷新设置和插件信息.

      原文:Reloads the server, refreshing settings and plugin information.

    • reloadData

      void reloadData()
      只重载Minecraft游戏数据. 这包括自定义的进度和掉落表.

      原文:Reload only the Minecraft data for the server. This includes custom advancements and loot tables.

    • getLogger

      Logger getLogger()
      返回此服务器的日志记录.

      原文:Returns the primary logger associated with this server instance.

      返回:
      服务器日志

    • getPluginCommand

      PluginCommand getPluginCommand(String name)
      获取一个PluginCommand通过给定的name或者别称

      原文:Gets a PluginCommand with the given name or alias.

      参数:
      name - 命令名
      返回:
      如果找到该名字的Command则返回PluginCommand实例,否则返回null

    • savePlayers

      void savePlayers()
      将以记载的玩家储存到硬盘

      原文:Writes loaded players to disk.

    • dispatchCommand

      boolean dispatchCommand(CommandSender sender, String commandLine) throws CommandException
      在服务器执行一个命令

      原文:Dispatches a command on this server, and executes it if found.

      参数:
      sender - 执行该命令的对象
      commandLine - sender执行的命令,由命令和参数组成. 示例: test abc 123
      返回:
      如果无法找到目标则返回false,否则返回true
      抛出:
      CommandException - 抛出执行期间出现的未捕获的异常

    • addRecipe

      boolean addRecipe(Recipe recipe)
      向服务器添加一个配方

      原文:Adds a recipe to the crafting manager.

      参数:
      recipe - 被添加的配方
      返回:
      当配方成功添加时返回true,否则返回false

    • getRecipesFor

      List<Recipe> getRecipesFor(ItemStack result)
      获取一个合成ItemStack的所有配方,如果副ID为-1将匹配所有的数据值

      原文: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.

      参数:
      result - 被获取配方的ItemStack
      返回:
      配方的List实例

    • recipeIterator

      Iterator<Recipe> recipeIterator()
      获取配方迭代器

      原文:Get an iterator through the list of crafting recipes.

      返回:
      配方的迭代器

    • clearRecipes

      void clearRecipes()
      清空配方

      原文:Clears the list of crafting recipes.

    • resetRecipes

      void resetRecipes()
      重置配方

      原文:Resets the list of crafting recipes to the default.

    • getCommandAliases

      Map<String,String[]> getCommandAliases()
      获取一个定义于服务器配置文件中的命令别名列表

      原文:Gets a list of command aliases defined in the server properties.

      返回:
      储存有命令及其别名List的Map实例

    • getSpawnRadius

      int getSpawnRadius()
      获得此世界的出生点保护半径.

      原文:Gets the radius, in blocks, around each worlds spawn point to protect.

      返回:
      半径(如果没有则返回0)

    • setSpawnRadius

      void setSpawnRadius(int value)
      设置这个世界的出生点保护半径.

      原文:Sets the radius, in blocks, around each worlds spawn point to protect.

      参数:
      value - 新的半径(若没有则设置0)

    • getOnlineMode

      boolean getOnlineMode()
      获得服务器是否开启了正版模式.

      原文:Gets whether the Server is in online mode or not.

      返回:
      true则开启/false反之

    • getAllowFlight

      boolean getAllowFlight()
      获得服务器是否开启了飞行模式.

      原文:Gets whether this server allows flying or not.

      返回:
      true则开启/false反之

    • isHardcore

      boolean isHardcore()
      获得服务器是否开启了极限生存模式.

      原文:Gets whether the server is in hardcore mode or not.

      返回:
      true则开启/false反之

    • shutdown

      void shutdown()
      彻底关闭服务器.

      原文:Shutdowns the server, stopping everything.

    • broadcast

      int broadcast(String message, String permission)
      向具有给定权限的玩家发送一条信息

      原文:Broadcasts the specified message to every user with the given permission name.

      参数:
      message - 需要公告的信息
      permission - 需要的权限permissibles
      返回:
      收到公告的玩家数量

    • getOfflinePlayer

      @Deprecated OfflinePlayer getOfflinePlayer(String name)
      已过时。
      UUID将会在不久后代替name
      通过给定的name获取OfflinePlayer实例

      原文:Gets the player by the given name, regardless if they are offline or online.

      该方法将会阻塞式调用一个网络请求用于获取给定name的UUID

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

      对于该方法而言所有玩家都是存在的,即使玩家从未登录过服务器也会返回一个OfflinePlayer实例

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

      参数:
      name - 玩家的name
      返回:
      OfflinePlayer实例
      另请参阅:

    • getOfflinePlayer

      OfflinePlayer getOfflinePlayer(UUID id)
      通过UUID获取OfflinePlayer实例

      原文:Gets the player by the given UUID, regardless if they are offline or online.

      对于该方法而言所有玩家都是存在的,即使玩家从未登录过服务器也会返回一个OfflinePlayer实例

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

      参数:
      id - 玩家的UUID
      返回:
      OfflinePlayer实例

    • getIPBans

      Set<String> getIPBans()
      获取一个被ban的IP的Set实例

      原文:Gets a set containing all current IPs that are banned.

      返回:
      一个包含被ban的IP的set实例

    • banIP

      void banIP(String address)
      设置禁止此ip地址登陆到服务器.

      原文:Bans the specified address from the server.

      参数:
      address - 禁止登陆的IP地址

    • unbanIP

      void unbanIP(String address)
      解除禁止此ip地址登陆到服务器.

      原文:Unbans the specified address from the server.

      参数:
      address - 解除禁止登陆的IP地址

    • getBannedPlayers

      Set<OfflinePlayer> getBannedPlayers()
      获得一组所有被服务器封禁的玩家.

      原文:Gets a set containing all banned players.

      返回:
      一组玩家

    • getBanList

      BanList getBanList(BanList.Type type)
      通过提供的BanList.Type来获取一个BanList

      原文:Gets a ban list for the supplied type.

      ban玩家name将不会受到支持,ban UUID更好

      原文: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 - 需要获取的BanList的类型
      返回:
      BanList实例

    • getOperators

      Set<OfflinePlayer> getOperators()
      获取一个包含所有OP的Set实例

      原文:Gets a set containing all player operators.

      返回:
      一个包含所有OP的Set实例

    • getDefaultGameMode

      GameMode getDefaultGameMode()
      获得新玩家的默认 GameMode.

      原文:Gets the default GameMode for new players.

      返回:
      默认游戏模式

    • setDefaultGameMode

      void setDefaultGameMode(GameMode mode)
      设置新玩家的默认 GameMode.

      原文:Sets the default GameMode for new players.

      参数:
      mode - 新的游戏模式

    • getConsoleSender

      ConsoleCommandSender getConsoleSender()
      获取一个ConsoleCommandSender 将被作为服务器的标准输入(译注:该方法用于获取控制台)
      返回:
      控制台对象

    • getWorldContainer

      File getWorldContainer()
      获取 World的文件夹的File实例.
      返回:
      包含所有World的文件夹的File实例

    • getOfflinePlayers

      OfflinePlayer[] getOfflinePlayers()
      获取所有登陆过服务器的玩家

      原文:Gets every player that has ever played on this server.

      返回:
      包含所有登录过的玩家的数组

    • getMessenger

      Messenger getMessenger()
      获取Messenger实例

      原文:Gets the Messenger responsible for this server.

      返回:
      负责该服务器的Messenger

    • getHelpMap

      HelpMap getHelpMap()
      获取该服务器用于提供帮助的HelpMap

      原文:Gets the HelpMap providing help topics for this server.

      返回:
      HelpMap实例

    • createInventory

      Inventory createInventory(InventoryHolder owner, InventoryType type)
      通过一个特定的类型来创建一个空的物品栏,如果这个类型是InventoryType.CHEST,那么这个物品栏 的大小为27格(即0-26的slot可用),每个物品栏类型拥有其默认的大小

      原文:Creates an empty inventory of 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.

      参数:
      owner - 该物品栏的拥有者,为null则表明无拥有者
      type - 被创建的Inventory的类型
      返回:
      Inventory实例

    • createInventory

      Inventory createInventory(InventoryHolder owner, InventoryType type, String title)
      通过一个特定的类型和标题来创建一个空的物品栏,如果这个类型是InventoryType.CHEST,那么这个物品栏 的大小为27格(即0-26的slot可用),每个物品栏类型拥有其默认的大小

      原文: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.
      注意:某些Inventory不支持标题,这些不支持标题的Inventory将不会在客户端渲染标题(即设置标题对这类Inventory无效)

      原文:It should be noted that some inventory types do not support titles and may not render with said titles on the Minecraft client.

      参数:
      owner - 该物品栏的拥有者,为null则表明无拥有者
      type - 被创建的Inventory的类型
      title - 被创建的Inventory的标题
      返回:
      Inventory实例

    • createInventory

      Inventory createInventory(InventoryHolder owner, int size) throws IllegalArgumentException
      使用InventoryType.CHEST创建一个给定大小的Inventory

      原文:Creates an empty inventory of type InventoryType.CHEST with the specified size.

      参数:
      owner - 该物品栏的拥有者,为null则表明无拥有者
      size - 被创建的Inventory的大小,该值应为9的倍数
      返回:
      Inventory实例
      抛出:
      IllegalArgumentException - 如果size不为9的倍数

    • createInventory

      Inventory createInventory(InventoryHolder owner, int size, String title) throws IllegalArgumentException
      通过一个特定的大小和标题使用InventoryType.CHEST来创建一个空的物品栏

      原文:Creates an empty inventory of type InventoryType.CHEST with the specified size and title.

      参数:
      owner - 该物品栏的拥有者,为null则表明无拥有者
      size - 被创建的Inventory的大小,该值应为9的倍数
      title - 被创建的Inventory的标题
      返回:
      Inventory实例
      抛出:
      IllegalArgumentException - 如果size不为9的倍数

    • createMerchant

      Merchant createMerchant(String title)
      Creates an empty merchant.
      参数:
      title - the title of the corresponding merchant inventory, displayed when the merchant inventory is viewed
      返回:
      a new merchant

    • getMonsterSpawnLimit

      int getMonsterSpawnLimit()
      获取一个区块最大可生成怪物数

      原文:Gets user-specified limit for number of monsters that can spawn in a chunk.

      返回:
      生成限制数

    • getAnimalSpawnLimit

      int getAnimalSpawnLimit()
      获取一个区块最大可生成动物数

      原文:Gets user-specified limit for number of animals that can spawn in a chunk.

      返回:
      生成限制数

    • getWaterAnimalSpawnLimit

      int getWaterAnimalSpawnLimit()
      获取一个区块最大可生成水生生物数

      原文:Gets user-specified limit for number of water animals that can spawn in a chunk.

      返回:
      生成限制数

    • getAmbientSpawnLimit

      int getAmbientSpawnLimit()
      获取一个区块最大生成环境怪物数(疑惑) Gets user-specified limit for number of ambient mobs that can spawn in a chunk.
      返回:
      生成限制数

    • isPrimaryThread

      boolean isPrimaryThread()
      检查当前方法是否在主线程执行

      原文:Checks the current thread against the expected primary thread for the server.

      注意: 该方法不应该用于检查当前同步状态,当前线程为主线程表明它确实为同步,但是不能排除其他原因.

      返回:
      为主线程返回true否则返回false

    • getMotd

      String getMotd()
      获得服务器列表中服务器所显示的消息(服务器MOTD).

      原文:Gets the message that is displayed on the server list.

      返回:
      服务器MOTD

    • getShutdownMessage

      String getShutdownMessage()
      获取服务器关闭时给玩家发送的默认消息

      原文:Gets the default message that is displayed when the server is stopped.

      返回:
      关服消息

    • getWarningState

      Warning.WarningState getWarningState()
      获取当前警告状态

      原文:Gets the current warning state for the server.

      返回:
      被配置的警告状态

    • getItemFactory

      ItemFactory getItemFactory()
      获取ItemFactory的实例(用于 ItemMeta)

      原文:Gets the instance of the item factory (for ItemMeta).

      返回:
      ItenFactory实例
      另请参阅:

    • getScoreboardManager

      ScoreboardManager getScoreboardManager()
      获取ScoreboardManager实例

      原文:Gets the instance of the scoreboard manager.

      该实例在至少有一个世界被加载后才会创建

      原文:This will only exist after the first world has loaded.

      返回:
      有任何世界被加载则返回ScoreboardManager实例,否则返回null.

    • getServerIcon

      CachedServerIcon getServerIcon()
      获取服务器默认图标

      原文:Gets an instance of the server's default server-icon.

      返回:
      服务器默认图标,当未定义服务器图标时将返回null(该行为无法担保)

    • loadServerIcon

      CachedServerIcon loadServerIcon(File file) throws IllegalArgumentException, Exception
      从文件中缓存图片为CachedServerIcon

      原文:Loads an image from a file, and returns a cached image for the specific server-icon.

      大小和类型必须在允许范围内,否则将会抛出Exception.

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

      参数:
      file - 需要被加载的文件
      返回:
      一个已缓存的CachedServerIcon实例,可用于 ServerListPingEvent.setServerIcon(CachedServerIcon)
      抛出:
      IllegalArgumentException - 如果图片为null
      Exception - 如果图片规格不适用作为服务器图标

    • loadServerIcon

      CachedServerIcon loadServerIcon(BufferedImage image) throws IllegalArgumentException, Exception
      从image中缓存为CachedServerIcon

      原文:Creates a cached server-icon for the specific image.

      大小和类型必须在允许范围内,否则将会抛出Exception.

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

      参数:
      image - 用于缓存的图片
      返回:
      一个已缓存的CachedServerIcon实例,可用于 ServerListPingEvent.setServerIcon(CachedServerIcon)
      抛出:
      IllegalArgumentException - 如果图片为null
      Exception - 如果图片规格不适用作为服务器图标

    • setIdleTimeout

      void setIdleTimeout(int threshold)
      设置自动踢出闲置玩家的时间.

      原文:Set the idle kick timeout. Any players idle for the specified amount of time will be automatically kicked.

      值为0时将不会踢出玩家

      参数:
      threshold - 闲置超时的分钟数

    • getIdleTimeout

      int getIdleTimeout()
      获取自动踢出闲置玩家的时间.

      原文:Gets the idle kick timeout.

      返回:
      the 闲置超时的分钟数

    • createChunkData

      ChunkGenerator.ChunkData createChunkData(World world)
      创建一个 ChunkData 实例，以用于区块生成。

      原文: Create a ChunkData for use in a generator. See ChunkGenerator.generateChunkData(org.bukkit.World, java.util.Random, int, int, org.bukkit.generator.ChunkGenerator.BiomeGrid)

      参数:
      world - ChunkData对应的世界
      返回:
      这个世界的新ChunkData实例

    • createBossBar

      BossBar createBossBar(String title, BarColor color, BarStyle style, BarFlag... flags)
      创建一个Boos血量条实例。血量条的进度默认为1.0。

      原文: Creates a boss bar instance to display to players. The progress defaults to 1.0

      参数:
      title - 血量条的标题
      color - 血量条的颜色
      style - 血量条的样式
      flags - 创建的Boss血量条实例
      返回:
      创建的Boss血量条实例

    • getEntity

      Entity getEntity(UUID uuid)
      用UUID获取实体.

      原文:Gets an entity on the server by its UUID

      参数:
      uuid - 实体的UUID
      返回:
      该UUID代表的实体，如果找不到为null

    • getAdvancement

      Advancement getAdvancement(NamespacedKey key)
      Get the advancement specified by this key.
      参数:
      key - unique advancement key
      返回:
      advancement or null if not exists

    • advancementIterator

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

    • getUnsafe

      @Deprecated UnsafeValues getUnsafe()
      已过时。
      返回:
      UnsafeValues实例
      另请参阅: