PlayerSpawnLocationEvent

PlayerSpawnLocationEvent

继承关系

=> org.bukkit.event.Event
​
=> org.bukkit.event.player.PlayerEvent
​
=> org.spigotmc.event.player.PlayerSpawnLocationEvent

类描述

Called when player is about to spawn in a world after joining the server.
当玩家成功登录服务器后,服务器即将生成玩家实体时触发。
译注:在 AsyncPlayerPreLoginEvent 、PlayerPreLoginEvent 、PlayerLoginEvent 事件触发时,服务器里还不存在玩家实体。这几个事件是在客户端尝试与服务端建立联系时触发的,插件可以通过事件所提供的 disallow() 等方法拒绝客户端登录。这样拒绝时,服务端内不会出现玩家实体。玩家登录过程将会尽早被切断。而 PlayerSpawnLocationEvent 触发时玩家已经成功加入了服务器,即将生成玩家实体。该事件不可取消,也无法将玩家踢出服务器。PlayerJoinEvent 事件触发时,服务器内已经生成了玩家实体。可通过 Player#kickPlayer(String) 方法将玩家踢出服务器。

方法列表

getSpawnLocation

方法声明: public Location getSpawnLocation()
方法签名: ()Lorg/bukkit/Location;
Gets player's spawn location.
If the player {@link Player#hasPlayedBefore()}, it's going to default to the location inside player.dat file.
For new players, the default spawn location is spawn of the main Bukkit world.
@return the spawn location
该方法用于获取将要生成玩家实体的位置。
如果 Player#hasPlayedBefore() 方法返回 true ,则可知玩家曾经上线过,此时将返回 player.dat 存档文件中记录的玩家上次离线时所在的位置。
如果玩家从未进入过服务器,则返回服务端主世界的世界重生点位置。
@return 将要生成玩家实体的位置。

setSpawnLocation

方法声明: public void setSpawnLocation(@NotNull Location location)
方法签名: (Lorg/bukkit/Location;)V
Sets player's spawn location.
@param location the spawn location
该方法用于设置将要生成玩家实体的位置。
@param location 将要生成玩家实体的位置。

getHandlers

方法声明: public HandlerList getHandlers()
方法签名: ()Lorg/bukkit/event/HandlerList;

getHandlerList

方法声明: public static HandlerList getHandlerList()
方法签名: ()Lorg/bukkit/event/HandlerList;