2021-06-11 14:02:28 +02:00
|
|
|
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
|
|
From: Aikar <aikar@aikar.co>
|
|
|
|
Date: Wed, 4 May 2016 23:55:48 -0400
|
|
|
|
Subject: [PATCH] ensureServerConversions API
|
|
|
|
|
|
|
|
This will take a Bukkit ItemStack and run it through any conversions a server process would perform on it,
|
|
|
|
to ensure it meets latest minecraft expectations.
|
|
|
|
|
|
|
|
diff --git a/src/main/java/org/bukkit/inventory/ItemFactory.java b/src/main/java/org/bukkit/inventory/ItemFactory.java
|
2024-05-11 23:48:37 +02:00
|
|
|
index aea393247c60037fb70cd8d5b8814c9849c85e03..b6b90f2ef735407ac41efa21371cfd6b07c2c66e 100644
|
2021-06-11 14:02:28 +02:00
|
|
|
--- a/src/main/java/org/bukkit/inventory/ItemFactory.java
|
|
|
|
+++ b/src/main/java/org/bukkit/inventory/ItemFactory.java
|
2024-01-14 10:46:04 +01:00
|
|
|
@@ -251,4 +251,18 @@ public interface ItemFactory {
|
2022-01-17 01:53:26 +01:00
|
|
|
@Deprecated
|
2021-06-12 13:18:01 +02:00
|
|
|
String getI18NDisplayName(@Nullable ItemStack item);
|
2023-08-06 02:21:59 +02:00
|
|
|
// Paper end - add getI18NDisplayName
|
2021-06-11 14:02:28 +02:00
|
|
|
+
|
2023-08-06 02:21:59 +02:00
|
|
|
+ // Paper start - ensure server conversions API
|
2021-06-11 14:02:28 +02:00
|
|
|
+ /**
|
2023-08-06 02:21:59 +02:00
|
|
|
+ * Minecraft's updates are converting simple item stacks into more complex NBT oriented Item Stacks.
|
2021-06-11 14:02:28 +02:00
|
|
|
+ *
|
2023-03-31 06:09:13 +02:00
|
|
|
+ * Use this method to ensure any desired data conversions are processed.
|
2021-06-11 14:02:28 +02:00
|
|
|
+ * The input itemstack will not be the same as the returned itemstack.
|
|
|
|
+ *
|
|
|
|
+ * @param item The item to process conversions on
|
2023-08-06 02:21:59 +02:00
|
|
|
+ * @return A potentially Data-Converted-ItemStack
|
2021-06-11 14:02:28 +02:00
|
|
|
+ */
|
|
|
|
+ @NotNull
|
|
|
|
+ ItemStack ensureServerConversions(@NotNull ItemStack item);
|
2023-08-06 02:21:59 +02:00
|
|
|
+ // Paper end - ensure server conversions API
|
2021-06-11 14:02:28 +02:00
|
|
|
}
|
|
|
|
diff --git a/src/main/java/org/bukkit/inventory/ItemStack.java b/src/main/java/org/bukkit/inventory/ItemStack.java
|
2024-05-11 23:48:37 +02:00
|
|
|
index 551f31fc91b91702b3093bec20113bee9660a3ec..76b6c21c68bc55d28b77dd53c988b40c9ae41258 100644
|
2021-06-11 14:02:28 +02:00
|
|
|
--- a/src/main/java/org/bukkit/inventory/ItemStack.java
|
|
|
|
+++ b/src/main/java/org/bukkit/inventory/ItemStack.java
|
2024-05-11 23:48:37 +02:00
|
|
|
@@ -559,7 +559,7 @@ public class ItemStack implements Cloneable, ConfigurationSerializable, Translat
|
2021-06-11 14:02:28 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
- return result;
|
|
|
|
+ return result.ensureServerConversions(); // Paper
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
2024-05-11 23:48:37 +02:00
|
|
|
@@ -641,6 +641,19 @@ public class ItemStack implements Cloneable, ConfigurationSerializable, Translat
|
2021-06-11 14:02:28 +02:00
|
|
|
return Bukkit.getServer().getItemFactory().displayName(this);
|
|
|
|
}
|
2021-06-12 13:18:01 +02:00
|
|
|
|
2021-06-11 14:02:28 +02:00
|
|
|
+ /**
|
|
|
|
+ * Minecraft updates are converting simple item stacks into more complex NBT oriented Item Stacks.
|
|
|
|
+ *
|
2023-03-31 06:09:13 +02:00
|
|
|
+ * Use this method to ensure any desired data conversions are processed.
|
2021-06-11 14:02:28 +02:00
|
|
|
+ * The input itemstack will not be the same as the returned itemstack.
|
|
|
|
+ *
|
|
|
|
+ * @return A potentially Data Converted ItemStack
|
|
|
|
+ */
|
|
|
|
+ @NotNull
|
|
|
|
+ public ItemStack ensureServerConversions() {
|
|
|
|
+ return Bukkit.getServer().getItemFactory().ensureServerConversions(this);
|
|
|
|
+ }
|
2021-06-12 13:18:01 +02:00
|
|
|
+
|
|
|
|
/**
|
|
|
|
* Gets the Display name as seen in the Client.
|
|
|
|
* Currently the server only supports the English language. To override this,
|