diff options
Diffstat (limited to 'src/main/java/org')
-rw-r--r-- | src/main/java/org/bukkit/entity/Player.java | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java index 73a9ea4e..d287d78a 100644 --- a/src/main/java/org/bukkit/entity/Player.java +++ b/src/main/java/org/bukkit/entity/Player.java @@ -569,4 +569,27 @@ public interface Player extends HumanEntity, Conversable, CommandSender, Offline * @return The current allowed speed, from -1 to 1 */ public float getWalkSpeed(); + + /** + * Request that the player's client download and switch texture packs. + * <p /> + * The player's client will download the new texture pack asynchronously in the background, and + * will automatically switch to it once the download is complete. If the client has downloaded + * and cached the same texture pack in the past, it will perform a quick timestamp check over + * the network to determine if the texture pack has changed and needs to be downloaded again. + * When this request is sent for the very first time from a given server, the client will first + * display a confirmation GUI to the player before proceeding with the download. + * <p /> + * Notes: + * <ul> + * <li>Players can disable server textures on their client, in which case this method will have no affect on them.</li> + * <li>There is no concept of resetting texture packs back to default within Minecraft, so players will have to relog to do so.</li> + * </ul> + * + * @param url The URL from which the client will download the texture pack. The string must contain + * only US-ASCII characters and should be encoded as per RFC 1738. + * @throws IllegalArgumentException Thrown if the URL is null. + * @throws IllegalArgumentException Thrown if the URL is too long. + */ + public void setTexturePack(String url); } |