feature: expose mannequin poses and provide pose argument

Author: yannicklamprecht

paper-api/src/main/java/io/papermc/paper/InternalAPIBridge.java

@@ -5,6 +5,7 @@
 import io.papermc.paper.datacomponent.item.ResolvableProfile;
 import io.papermc.paper.world.damagesource.CombatEntry;
 import io.papermc.paper.world.damagesource.FallLocationType;
+import java.util.Set;
 import java.util.function.Function;
 import java.util.function.Predicate;
 import net.kyori.adventure.text.Component;
@@ -14,6 +15,7 @@
 import org.bukkit.damage.DamageEffect;
 import org.bukkit.damage.DamageSource;
 import org.bukkit.entity.LivingEntity;
+import org.bukkit.entity.Pose;
 import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.Contract;
 import org.jspecify.annotations.NullMarked;
@@ -100,4 +102,6 @@ class Holder {
     Component defaultMannequinDescription();
 
     <MODERN, LEGACY> GameRule<LEGACY> legacyGameRuleBridge(GameRule<MODERN> rule, Function<LEGACY, MODERN> fromLegacyToModern, Function<MODERN, LEGACY> toLegacyFromModern, Class<LEGACY> legacyClass);
+
+    Set<Pose> validMannequinPoses();
 }

paper-api/src/main/java/org/bukkit/entity/Mannequin.java

@@ -3,6 +3,7 @@
 import com.destroystokyo.paper.SkinParts;
 import io.papermc.paper.InternalAPIBridge;
 import io.papermc.paper.datacomponent.item.ResolvableProfile;
+import java.util.Set;
 import net.kyori.adventure.text.Component;
 import org.bukkit.inventory.EntityEquipment;
 import org.bukkit.inventory.MainHand;
@@ -12,6 +13,15 @@
 @NullMarked
 public interface Mannequin extends LivingEntity {
 
+    /**
+     * Returns the valid poses for a mannequin.
+     *
+     * @return the valid poses
+     */
+    static Set<Pose> validPoses() {
+        return InternalAPIBridge.get().validMannequinPoses();
+    }
+
     /**
      * Returns the default mannequin profile.
      *

paper-server/src/main/java/io/papermc/paper/PaperServerInternalAPIBridge.java

@@ -10,8 +10,10 @@
 import io.papermc.paper.world.damagesource.FallLocationType;
 import io.papermc.paper.world.damagesource.PaperCombatEntryWrapper;
 import io.papermc.paper.world.damagesource.PaperCombatTrackerWrapper;
+import java.util.Set;
 import java.util.function.Function;
 import java.util.function.Predicate;
+import java.util.stream.Collectors;
 import net.kyori.adventure.text.Component;
 import net.minecraft.Optionull;
 import net.minecraft.commands.Commands;
@@ -27,13 +29,17 @@
 import org.bukkit.damage.DamageEffect;
 import org.bukkit.damage.DamageSource;
 import org.bukkit.entity.LivingEntity;
+import org.bukkit.entity.Pose;
 import org.jspecify.annotations.NullMarked;
 import org.jspecify.annotations.Nullable;
 
 @NullMarked
 public class PaperServerInternalAPIBridge implements InternalAPIBridge {
     public static final PaperServerInternalAPIBridge INSTANCE = new PaperServerInternalAPIBridge();
 
+    private static final Set<Pose> validMannequinPoses = Mannequin.VALID_POSES.stream()
+        .map(pose -> Pose.values()[pose.ordinal()]).collect(Collectors.toSet());
+
     @Override
     public DamageEffect getDamageEffect(final String key) {
         return CraftDamageEffect.getById(key);
@@ -116,4 +122,9 @@ public Component defaultMannequinDescription() {
     public <MODERN, LEGACY> GameRule<LEGACY> legacyGameRuleBridge(GameRule<MODERN> rule, Function<LEGACY, MODERN> fromLegacyToModern, Function<MODERN, LEGACY> toLegacyFromModern, Class<LEGACY> legacyClass) {
         return CraftGameRule.wrap(rule, fromLegacyToModern, toLegacyFromModern, legacyClass);
     }
+
+    @Override
+    public Set<Pose> validMannequinPoses() {
+        return validMannequinPoses;
+    }
 }

paper-server/src/main/java/org/bukkit/craftbukkit/entity/CraftMannequin.java

@@ -31,15 +31,14 @@ public net.minecraft.world.entity.decoration.Mannequin getHandle() {
     @Override
     public void setPose(Pose pose, boolean fixed) {
         Preconditions.checkArgument(pose != null, "pose cannot be null");
-        net.minecraft.world.entity.Pose internalPose = net.minecraft.world.entity.Pose.values()[pose.ordinal()];
-        if (!net.minecraft.world.entity.decoration.Mannequin.VALID_POSES.contains(internalPose)) {
+        if (!Mannequin.validPoses().contains(pose)) {
             throw new IllegalArgumentException("Invalid pose '%s', expected one of: %s".formatted(
                 pose.name(),
-                net.minecraft.world.entity.decoration.Mannequin.VALID_POSES.stream().map(p -> Pose.values()[p.ordinal()]).toList() // name doesn't match
+                Mannequin.validPoses().stream().toList() // name doesn't match
             ));
         }
 
-        this.setPose0(internalPose, fixed);
+        this.setPose0(net.minecraft.world.entity.Pose.values()[pose.ordinal()], fixed);
     }
 
     @Override