feat: add more entity metadata types (#139)

Author: derklaro

api/src/main/java/com/github/juliarn/npclib/api/protocol/meta/DefaultEntityMetadata.java

@@ -27,34 +27,21 @@
 import com.github.juliarn.npclib.api.protocol.enums.EntityPose;
 import com.github.juliarn.npclib.api.protocol.enums.EntityStatus;
 import java.util.Collection;
-import java.util.HashSet;
-import java.util.Set;
+import java.util.function.Function;
 
 interface DefaultEntityMetadata {
 
-  // https://wiki.vg/Entity_metadata#Entity - see index 0
+  // https://minecraft.wiki/w/Java_Edition_protocol/Entity_metadata#Entity - see index 0
   EntityMetadataFactory<Collection<EntityStatus>, Byte> ENTITY_STATUS =
     EntityMetadataFactory.<Collection<EntityStatus>, Byte>metaFactoryBuilder()
       .baseIndex(0)
       .type(Byte.class)
-      .inputConverter(rawEntries -> {
+      .inputConverter(entries -> {
         // if there are no entries the mask is always 0
-        int size = rawEntries.size();
-        if (size == 0) {
+        if (entries.isEmpty()) {
           return (byte) 0;
         }
 
-        // ensure that there are no duplicates
-        Set<EntityStatus> entries;
-        if (rawEntries instanceof Set<?>) {
-          // already a set - nice
-          entries = (Set<EntityStatus>) rawEntries;
-        } else {
-          // copy over the elements
-          entries = new HashSet<>(size + 1, 1f);
-          entries.addAll(rawEntries);
-        }
-
         // calculate the bitmask to send
         byte entryMask = 0;
         for (EntityStatus entry : entries) {
@@ -64,7 +51,16 @@ interface DefaultEntityMetadata {
         return entryMask;
       }).build();
 
-  // https://wiki.vg/Entity_metadata#Entity - see index 0 and 6
+  // https://minecraft.wiki/w/Java_Edition_protocol/Entity_metadata#Entity - see index 6
+  EntityMetadataFactory<EntityPose, EntityPose> ENTITY_POSE =
+    EntityMetadataFactory.<EntityPose, EntityPose>metaFactoryBuilder()
+      .baseIndex(6)
+      .type(EntityPose.class)
+      .inputConverter(Function.identity())
+      .availabilityChecker(versionAccessor -> versionAccessor.atLeast(1, 14, 0))
+      .build();
+
+  // https://minecraft.wiki/w/Java_Edition_protocol/Entity_metadata#Entity - see index 0 and 6
   EntityMetadataFactory<Boolean, Byte> SNEAKING = EntityMetadataFactory.<Boolean, Byte>metaFactoryBuilder()
     .baseIndex(0)
     .type(Byte.class)
@@ -77,7 +73,32 @@ interface DefaultEntityMetadata {
       .build())
     .build();
 
-  // https://wiki.vg/Entity_metadata#Player - see index 10
+  // https://minecraft.wiki/w/Java_Edition_protocol/Entity_metadata#Entity - see index 7
+  EntityMetadataFactory<Boolean, Integer> SHAKING = EntityMetadataFactory.<Boolean, Integer>metaFactoryBuilder()
+    .baseIndex(7)
+    .type(Integer.class)
+    .inputConverter(value -> value ? 250 : 0)
+    .availabilityChecker(versionAccessor -> versionAccessor.atLeast(1, 17, 0))
+    .build();
+
+  // https://minecraft.wiki/w/Java_Edition_protocol/Entity_metadata#Living_Entity - see index 8
+  EntityMetadataFactory<Boolean, Byte> USING_ITEM = EntityMetadataFactory.<Boolean, Byte>metaFactoryBuilder()
+    .baseIndex(5)
+    .type(Byte.class)
+    .indexShiftVersions(10, 14, 17)
+    .inputConverter(value -> (byte) (value ? 0x01 : 0x00))
+    .availabilityChecker(versionAccessor -> versionAccessor.atLeast(1, 9, 0))
+    .build();
+
+  // https://minecraft.wiki/w/Java_Edition_protocol/Entity_metadata#Living_Entity - see index 12
+  EntityMetadataFactory<Integer, Integer> ARROW_COUNT = EntityMetadataFactory.<Integer, Integer>metaFactoryBuilder()
+    .baseIndex(9)
+    .type(Integer.class)
+    .indexShiftVersions(10, 14, 17)
+    .inputConverter(value -> Math.max(0, value))
+    .build();
+
+  // https://minecraft.wiki/w/Java_Edition_protocol/Entity_metadata#Player - see index 17
   EntityMetadataFactory<Boolean, Byte> SKIN_LAYERS = EntityMetadataFactory.<Boolean, Byte>metaFactoryBuilder()
     .baseIndex(10)
     .type(Byte.class)

api/src/main/java/com/github/juliarn/npclib/api/protocol/meta/EntityMetadataFactory.java

@@ -25,6 +25,7 @@
 package com.github.juliarn.npclib.api.protocol.meta;
 
 import com.github.juliarn.npclib.api.PlatformVersionAccessor;
+import com.github.juliarn.npclib.api.protocol.enums.EntityPose;
 import com.github.juliarn.npclib.api.protocol.enums.EntityStatus;
 import java.lang.reflect.Type;
 import java.util.Collection;
@@ -50,6 +51,22 @@ public interface EntityMetadataFactory<I, O> {
     return DefaultEntityMetadata.ENTITY_STATUS;
   }
 
+  static @NotNull EntityMetadataFactory<EntityPose, EntityPose> entityPoseMetaFactory() {
+    return DefaultEntityMetadata.ENTITY_POSE;
+  }
+
+  static @NotNull EntityMetadataFactory<Boolean, Integer> shakingMetaFactory() {
+    return DefaultEntityMetadata.SHAKING;
+  }
+
+  static @NotNull EntityMetadataFactory<Boolean, Byte> usingItemMetaFactory() {
+    return DefaultEntityMetadata.USING_ITEM;
+  }
+
+  static @NotNull EntityMetadataFactory<Integer, Integer> arrowCountMetaFactory() {
+    return DefaultEntityMetadata.ARROW_COUNT;
+  }
+
   @Unmodifiable
   @NotNull Collection<EntityMetadataFactory<I, Object>> relatedMetadata();