# PlayerUtils

#### Player Teleportation

<p class="callout info">In version 1.10 BaseIO contains multiple teleport implementations. If you encounter issues regarding teleportations, try switching the implementation in BaseIO's config file</p>

`PlayerUtils.teleportPlayerUnsafe(EntityPlayerMP player, Position position)` teleports a player to the specified position forcibly. If you want to be sure the player doesn't teleport into blocks, use `PlayerUtils.teleportPlayer(EntityPlayerMP player, Position position, boolean noisy)`. When the destination is an unsafe block this method won't teleport the player, returning false and (with noisy = true) printing a message to the player specifying the problem. For convenience teleportPlayer is overloaded with a ICommandSender instead of EntityPlayerMP (other senders than EntityPlayerMP will be discarded).

#### Identifier conversion

You might want to search a player by it's name quite often. For such cases (and many more "conversions") PlayerUtils provides a full set of conversion methods:  
 [![neu0.png](https://wiki.ender.io/uploads/images/gallery/2017-11-Nov/scaled-840-0/neu0.png)](https://wiki.ender.io/uploads/images/gallery/2017-11-Nov/neu0.png)

<table id="bkmrk-%E2%86%93-from-%7C-to%C2%A0%E2%86%92-u"><tbody><tr><td>**↓ From | To →**</td><td>**UUID**</td><td>**Name**</td><td>**GameProfile**</td><td>**EntityPlayer**</td><td>**ICommandSender**</td></tr><tr><td>**UUID**</td><td> </td><td>PlayerUtils:getName</td><td>PlayerUtils:getGameProfile</td><td>PlayerUtils:getPlayer</td><td>PlayerUtils:getPlayer</td></tr><tr><td>**Name**</td><td>PlayerUtils:getUUID</td><td> </td><td>PlayerUtils:getGameProfile</td><td>PlayerUtils:getPlayer</td><td>PlayerUtils:getPlayer</td></tr><tr><td>**GameProfile**</td><td>GameProfile:getId</td><td>GameProfile:getName</td><td> </td><td>PlayerUtils:getPlayer</td><td>PlayerUtils:getPlayer</td></tr><tr><td>**EntityPlayer**</td><td>EntityPlayer:getUniqueId</td><td>ICommandSender:getName</td><td>EntityPlayer:getProfile</td><td> </td><td>typecast</td></tr><tr><td>**ICommandSender**</td><td>PlayerUtils:getUUID</td><td>ICommandSender:getName</td><td>*(only via typecast)*</td><td>typecast</td><td> </td></tr></tbody></table>

If no player is found `null` will be returned.

<p class="callout info">In 1.7, ICommandSender:getName was named ICommandSender:getCommandSenderName</p>

<p class="callout info">PlayerUtils is capable to convert **any** ICommandSender to an UUID, including console and command blocks. This UUID might not be a valid UUID of Minecraft but it can be used to identify it and additionally PlayerUtils:getName supports these UUIDs. Every Command Sender of one class has the same UUID.</p>

##### Ranges

All conversion methods have a range parameter that determines how broad the search should be.

<table id="bkmrk-range-inclusion-full"><tbody><tr><td>**Range**</td><td>**Inclusion**</td><td>**Full search area**</td></tr><tr><td>ONLINE</td><td>Includes online players</td><td>online players</td></tr><tr><td>FAKE</td><td>Includes fake players</td><td>online (fake)players</td></tr><tr><td>SERVER</td><td>Includes offline players</td><td>online/offline (fake)players</td></tr><tr><td>ALL</td><td>Includes players that have never been on the server</td><td>all minecraft players</td></tr></tbody></table>