Add get|set_entity_pose() functions

Author: PseudoKnight

src/main/java/com/laytonsmith/abstraction/MCEntity.java

@@ -3,6 +3,7 @@
 import com.laytonsmith.PureUtilities.Vector3D;
 import com.laytonsmith.abstraction.enums.MCEntityEffect;
 import com.laytonsmith.abstraction.enums.MCEntityType;
+import com.laytonsmith.abstraction.enums.MCPose;
 import com.laytonsmith.abstraction.enums.MCTeleportCause;
 import com.laytonsmith.abstraction.events.MCEntityDamageEvent;
 import java.util.List;
@@ -122,4 +123,9 @@ public interface MCEntity extends MCMetadatable {
 	boolean isVisibleByDefault();
 
 	void setVisibleByDefault(boolean visible);
+
+	MCPose getPose();
+
+	void setPose(MCPose pose);
+
 }

src/main/java/com/laytonsmith/abstraction/bukkit/entities/BukkitMCEntity.java

@@ -15,8 +15,10 @@
 import com.laytonsmith.abstraction.bukkit.events.BukkitEntityEvents;
 import com.laytonsmith.abstraction.enums.MCEntityEffect;
 import com.laytonsmith.abstraction.enums.MCEntityType;
+import com.laytonsmith.abstraction.enums.MCPose;
 import com.laytonsmith.abstraction.enums.MCTeleportCause;
 import com.laytonsmith.abstraction.enums.bukkit.BukkitMCEntityType;
+import com.laytonsmith.abstraction.enums.bukkit.BukkitMCPose;
 import com.laytonsmith.abstraction.events.MCEntityDamageEvent;
 import io.papermc.paper.entity.TeleportFlag;
 import org.bukkit.EntityEffect;
@@ -437,4 +439,14 @@ public void setVisibleByDefault(boolean visible) {
 			// probably before 1.19.3
 		}
 	}
+
+	@Override
+	public MCPose getPose() {
+		return BukkitMCPose.getConvertor().getAbstractedEnum(e.getPose());
+	}
+
+	@Override
+	public void setPose(MCPose pose) {
+		e.setPose(BukkitMCPose.getConvertor().getConcreteEnum(pose));
+	}
 }

src/main/java/com/laytonsmith/abstraction/enums/MCPose.java

@@ -0,0 +1,25 @@
+package com.laytonsmith.abstraction.enums;
+
+import com.laytonsmith.annotations.MEnum;
+
+@MEnum("com.commandhelper.Pose")
+public enum MCPose {
+	CROAKING,
+	DIGGING,
+	DYING,
+	EMERGING,
+	FALL_FLYING,
+	INHALING,
+	LONG_JUMPING,
+	ROARING,
+	SHOOTING,
+	SITTING,
+	SLEEPING,
+	SLIDING,
+	SNEAKING,
+	SNIFFING,
+	SPIN_ATTACK,
+	STANDING,
+	SWIMMING,
+	USING_TONGUE
+}

src/main/java/com/laytonsmith/abstraction/enums/bukkit/BukkitMCPose.java

@@ -0,0 +1,24 @@
+package com.laytonsmith.abstraction.enums.bukkit;
+
+import com.laytonsmith.abstraction.Implementation;
+import com.laytonsmith.abstraction.enums.EnumConvertor;
+import com.laytonsmith.abstraction.enums.MCPose;
+import com.laytonsmith.annotations.abstractionenum;
+import org.bukkit.entity.Pose;
+
+@abstractionenum(
+		implementation = Implementation.Type.BUKKIT,
+		forAbstractEnum = MCPose.class,
+		forConcreteEnum = Pose.class
+)
+public class BukkitMCPose extends EnumConvertor<MCPose, Pose> {
+
+	private static BukkitMCPose instance;
+
+	public static BukkitMCPose getConvertor() {
+		if(instance == null) {
+			instance = new BukkitMCPose();
+		}
+		return instance;
+	}
+}

src/main/java/com/laytonsmith/core/functions/EntityManagement.java

@@ -113,6 +113,7 @@
 import com.laytonsmith.abstraction.enums.MCMushroomCowType;
 import com.laytonsmith.abstraction.enums.MCParrotType;
 import com.laytonsmith.abstraction.enums.MCParticle;
+import com.laytonsmith.abstraction.enums.MCPose;
 import com.laytonsmith.abstraction.enums.MCPotionType;
 import com.laytonsmith.abstraction.enums.MCProfession;
 import com.laytonsmith.abstraction.enums.MCRabbitType;
@@ -5784,4 +5785,107 @@ public Version since() {
 			return MSVersion.V3_3_5;
 		}
 	}
+
+	@api
+	@seealso(set_entity_pose.class)
+	public static class get_entity_pose extends EntityGetterFunction {
+
+		@Override
+		public String getName() {
+			return "get_entity_pose";
+		}
+
+		@Override
+		public String docs() {
+			return """
+					string {entityUUID} Returns the pose of an entity. Poses are desynchronized from entity state,
+					as the pose is set at the end of a tick and can be set to anything by a plugin.
+					----
+					Known poses:
+					{| class="wikitable"
+					|-
+					! scope="col" width="20%" | Entity Types
+					! scope="col" width="80%" | Poses
+					|-
+					! All Entities
+					| STANDING (default pose)
+					|-
+					! Living Entities
+					| DYING, SLEEPING
+					|-
+					! Most Humanoid Entities
+					| SNEAKING, SWIMMING, FALL_FLYING
+					|-
+					! Breeze
+					| INHALING, LONG_JUMPING, SHOOTING, SLIDING
+					|-
+					! Camel
+					| SITTING
+					|-
+					! Cat/Ocelot
+					| SNEAKING
+					|-
+					! Frog
+					| CROAKING, LONG_JUMPING, USING_TONGUE
+					|-
+					! Goat
+					| LONG_JUMPING
+					|-
+					! Player
+					| SPIN_ATTACK
+					|-
+					! Warden
+					| DIGGING, EMERGING, ROARING, SNIFFING
+					|}
+					""";
+		}
+
+		@Override
+		public Mixed exec(Target t, Environment env, Mixed... args) throws ConfigRuntimeException {
+			MCEntity entity = Static.getEntity(args[0], t);
+			return new CString(entity.getPose().name(), t);
+		}
+
+		@Override
+		public Version since() {
+			return MSVersion.V3_3_5;
+		}
+	}
+
+	@api
+	@seealso(get_entity_pose.class)
+	public static class set_entity_pose extends EntitySetterFunction {
+
+		@Override
+		public String getName() {
+			return "set_entity_pose";
+		}
+
+		@Override
+		public String docs() {
+			return """
+					void {entityUUID, pose} Sets an entity's pose. While you can set any pose to any entity, only
+					certain poses will result in a visual change for a particular entity type. Poses can affect entity
+					hitboxes but do not change entity state. See {{function|get_entity_pose}} for a list of poses.
+					""";
+		}
+
+		@Override
+		public Mixed exec(Target t, Environment env, Mixed... args) throws ConfigRuntimeException {
+			MCEntity entity = Static.getEntity(args[0], t);
+			MCPose pose;
+			try {
+				pose = MCPose.valueOf(args[1].val().toUpperCase());
+			} catch(IllegalArgumentException ex) {
+				throw new CREFormatException("Invalid pose: " + args[1].val(), t);
+			}
+			entity.setPose(pose);
+			return CVoid.VOID;
+		}
+
+		@Override
+		public Version since() {
+			return MSVersion.V3_3_5;
+		}
+	}
 }