ItemTag.item_model/max_durability/max_stack_size/rarity (#2734)

* Components :o

- Added support for the `item_model`, `max_durability`, `food`, `max_stack_size`, and `rarity` item components.

- Additionally made sure that the paper `ItemTag.rarity` didn't conflict with the new >1.20 rarity component mech.

* Updated name + corrected registration

* Addressed comments

* Addressed comments.

* Max durability tag for <=1.19

* Update ItemDurability.java

* Reverted changes.

* Forgot to revert item extensions file.

* New item component registry system

* toString --> asMinimalString

* Addressed comments

* tern

* Update PaperModule.java

* moved version check into paperitemextension file

* Removed legacy tag meta

Author: heypr

paper/src/main/java/com/denizenscript/denizen/paper/datacomponents/ComponentAdaptersRegistry.java

@@ -5,5 +5,9 @@ public class ComponentAdaptersRegistry {
     public static void register() {
         DataComponentAdapter.register(new FoodAdapter());
         DataComponentAdapter.register(new GliderAdapter());
+        DataComponentAdapter.register(new ItemModelAdapter());
+        DataComponentAdapter.register(new MaxDurabilityAdapter());
+        DataComponentAdapter.register(new MaxStackSizeAdapter());
+        DataComponentAdapter.register(new RarityAdapter());
     }
 }

paper/src/main/java/com/denizenscript/denizen/paper/datacomponents/ItemModelAdapter.java

@@ -0,0 +1,36 @@
+package com.denizenscript.denizen.paper.datacomponents;
+
+import com.denizenscript.denizen.utilities.Utilities;
+import com.denizenscript.denizencore.objects.Mechanism;
+import com.denizenscript.denizencore.objects.core.ElementTag;
+import io.papermc.paper.datacomponent.DataComponentTypes;
+import net.kyori.adventure.key.Key;
+
+public class ItemModelAdapter extends DataComponentAdapter.Valued<ElementTag, Key> {
+
+    // <--[property]
+    // @object ItemTag
+    // @name item_model
+    // @input ElementTag
+    // @description
+    // Controls an item's model <@link language Item Components> in namespaced key format.
+    // The default namespace is "minecraft", so for example an input of "stone" becomes "minecraft:stone", and will set the item model to a stone block.
+    // This can also be used to display item models from your own custom resource packs.
+    // @mechanism
+    // Provide no input to reset the item to its default value.
+    // -->
+
+    public ItemModelAdapter() {
+        super(ElementTag.class, DataComponentTypes.ITEM_MODEL, "item_model");
+    }
+
+    @Override
+    public ElementTag toDenizen(Key value) {
+        return new ElementTag(value.asMinimalString(), true);
+    }
+
+    @Override
+    public Key fromDenizen(ElementTag value, Mechanism mechanism) {
+        return Utilities.parseNamespacedKey(value.asString());
+    }
+}

paper/src/main/java/com/denizenscript/denizen/paper/datacomponents/MaxDurabilityAdapter.java

@@ -0,0 +1,32 @@
+package com.denizenscript.denizen.paper.datacomponents;
+
+import com.denizenscript.denizencore.objects.Mechanism;
+import com.denizenscript.denizencore.objects.core.ElementTag;
+import io.papermc.paper.datacomponent.DataComponentTypes;
+
+public class MaxDurabilityAdapter extends DataComponentAdapter.Valued<ElementTag, Integer> {
+
+    // <--[property]
+    // @object ItemTag
+    // @name max_durability
+    // @input ElementTag(Number)
+    // @description
+    // Controls an item's max durability <@link language Item Components>.
+    // @mechanism
+    // Provide no input to reset the item to its default value.
+    // -->
+
+    public MaxDurabilityAdapter() {
+        super(ElementTag.class, DataComponentTypes.MAX_DAMAGE, "max_durability");
+    }
+
+    @Override
+    public ElementTag toDenizen(Integer value) {
+        return new ElementTag(value);
+    }
+
+    @Override
+    public Integer fromDenizen(ElementTag value, Mechanism mechanism) {
+        return mechanism.requireInteger() ? value.asInt() : null;
+    }
+}

paper/src/main/java/com/denizenscript/denizen/paper/datacomponents/MaxStackSizeAdapter.java

@@ -0,0 +1,32 @@
+package com.denizenscript.denizen.paper.datacomponents;
+
+import com.denizenscript.denizencore.objects.Mechanism;
+import com.denizenscript.denizencore.objects.core.ElementTag;
+import io.papermc.paper.datacomponent.DataComponentTypes;
+
+public class MaxStackSizeAdapter extends DataComponentAdapter.Valued<ElementTag, Integer> {
+
+    // <--[property]
+    // @object ItemTag
+    // @name max_stack_size
+    // @input ElementTag(Number)
+    // @description
+    // Controls an item's max stack size <@link language Item Components>.
+    // @mechanism
+    // Provide no input to reset the item to its default value.
+    // -->
+
+    public MaxStackSizeAdapter() {
+        super(ElementTag.class, DataComponentTypes.MAX_STACK_SIZE, "max_stack_size");
+    }
+
+    @Override
+    public ElementTag toDenizen(Integer value) {
+        return new ElementTag(value);
+    }
+
+    @Override
+    public Integer fromDenizen(ElementTag value, Mechanism mechanism) {
+        return mechanism.requireInteger() ? value.asInt() : null;
+    }
+}

paper/src/main/java/com/denizenscript/denizen/paper/datacomponents/RarityAdapter.java

@@ -0,0 +1,34 @@
+package com.denizenscript.denizen.paper.datacomponents;
+
+import com.denizenscript.denizencore.objects.Mechanism;
+import com.denizenscript.denizencore.objects.core.ElementTag;
+import io.papermc.paper.datacomponent.DataComponentTypes;
+import org.bukkit.inventory.ItemRarity;
+
+public class RarityAdapter extends DataComponentAdapter.Valued<ElementTag, ItemRarity> {
+
+    // <--[property]
+    // @object ItemTag
+    // @name rarity
+    // @input ElementTag
+    // @description
+    // Controls an item's rarity <@link language Item Components>.
+    // See <@link url https://jd.papermc.io/paper/org/bukkit/inventory/ItemRarity.html> for valid rarity values.
+    // @mechanism
+    // Provide no input to reset the item to its default value.
+    // -->
+
+    public RarityAdapter() {
+        super(ElementTag.class, DataComponentTypes.RARITY, "rarity");
+    }
+
+    @Override
+    public ElementTag toDenizen(ItemRarity value) {
+        return new ElementTag(value);
+    }
+
+    @Override
+    public ItemRarity fromDenizen(ElementTag value, Mechanism mechanism) {
+        return mechanism.requireEnum(ItemRarity.class) ? value.asEnum(ItemRarity.class) : null;
+    }
+}

paper/src/main/java/com/denizenscript/denizen/paper/properties/PaperItemExtensions.java

@@ -1,22 +1,18 @@
 package com.denizenscript.denizen.paper.properties;
 
+import com.denizenscript.denizen.nms.NMSHandler;
+import com.denizenscript.denizen.nms.NMSVersion;
 import com.denizenscript.denizen.objects.ItemTag;
 import com.denizenscript.denizencore.objects.core.ElementTag;
 
 public class PaperItemExtensions {
 
     public static void register() {
 
-        // <--[tag]
-        // @attribute <ItemTag.rarity>
-        // @returns ElementTag
-        // @group paper
-        // @Plugin Paper
-        // @description
-        // Returns the rarity of an item, as "common", "uncommon", "rare", or "epic".
-        // -->
-        ItemTag.tagProcessor.registerTag(ElementTag.class, "rarity", (attribute, item) -> {
-            return new ElementTag(item.getItemStack().getRarity());
-        });
+        if (NMSHandler.getVersion().isAtMost(NMSVersion.v1_20)) {
+            ItemTag.tagProcessor.registerTag(ElementTag.class, "rarity", (attribute, item) -> {
+                return new ElementTag(item.getItemStack().getRarity());
+            });
+        }
     }
 }

plugin/src/main/java/com/denizenscript/denizen/objects/properties/item/ItemCustomModel.java

@@ -15,6 +15,7 @@ public class ItemCustomModel extends ItemProperty<ElementTag> {
     // @description
     // Controls the custom model data ID number of the item.
     // Use with no input to remove the custom model data.
+    // Prefer <@link property ItemTag.item_model> on MC 1.21+.
     // See also <@link tag ItemTag.has_custom_model_data>
     // -->
     public static boolean describes(ItemTag item) {
@@ -56,6 +57,7 @@ public static void register() {
         // @group properties
         // @description
         // Returns whether the item has a custom model data ID number set on it.
+        // Prefer <@link property ItemTag.item_model> on MC 1.21+.
         // See also <@link tag ItemTag.custom_model_data>.
         // -->
         PropertyParser.registerTag(ItemCustomModel.class, ElementTag.class, "has_custom_model_data", (attribute, prop) -> {