From 6df1eea3118148d343e2ba943ed0e79e3272e981 Mon Sep 17 00:00:00 2001 From: Aikar Date: Fri, 19 Jan 2018 00:29:28 -0500 Subject: [PATCH] Add setPlayerProfile API for Skulls This allows you to create already filled textures on Skulls to avoid texture lookups which commonly cause rate limit issues with Mojang API diff --git a/src/main/java/org/bukkit/block/Skull.java b/src/main/java/org/bukkit/block/Skull.java index 499a153e..3c75341e 100644 --- a/src/main/java/org/bukkit/block/Skull.java +++ b/src/main/java/org/bukkit/block/Skull.java @@ -4,6 +4,8 @@ import org.bukkit.Material; import org.bukkit.OfflinePlayer; import org.bukkit.SkullType; import org.bukkit.block.data.BlockData; +import com.destroystokyo.paper.profile.PlayerProfile; +import javax.annotation.Nullable; /** * Represents a captured state of a skull block. @@ -55,6 +57,20 @@ public interface Skull extends BlockState { */ public void setOwningPlayer(OfflinePlayer player); + // Paper start + /** + * Sets this skull to use the supplied Player Profile, which can include textures already prefilled. + * @param profile The profile to set this Skull to use, may not be null + */ + void setPlayerProfile(PlayerProfile profile); + + /** + * If the skull has an owner, per {@link #hasOwner()}, return the owners {@link PlayerProfile} + * @return The profile of the owner, if set + */ + @Nullable PlayerProfile getPlayerProfile(); + // Paper end + /** * Gets the rotation of the skull in the world (or facing direction if this * is a wall mounted skull). diff --git a/src/main/java/org/bukkit/inventory/meta/SkullMeta.java b/src/main/java/org/bukkit/inventory/meta/SkullMeta.java index 15c1dfd9..a458000f 100644 --- a/src/main/java/org/bukkit/inventory/meta/SkullMeta.java +++ b/src/main/java/org/bukkit/inventory/meta/SkullMeta.java @@ -1,7 +1,10 @@ package org.bukkit.inventory.meta; +import com.destroystokyo.paper.profile.PlayerProfile; +import javax.annotation.Nullable; import org.bukkit.OfflinePlayer; + /** * Represents a skull that can have an owner. */ @@ -36,6 +39,20 @@ public interface SkullMeta extends ItemMeta { @Deprecated boolean setOwner(String owner); + // Paper start + /** + * Sets this skull to use the supplied Player Profile, which can include textures already prefilled. + * @param profile The profile to set this Skull to use, or null to clear owner + */ + void setPlayerProfile(@Nullable PlayerProfile profile); + + /** + * If the skull has an owner, per {@link #hasOwner()}, return the owners {@link PlayerProfile} + * @return The profile of the owner, if set + */ + @Nullable PlayerProfile getPlayerProfile(); + // Paper end + /** * Gets the owner of the skull. * -- 2.20.1