From cd6fb23fab3c2be73f889d15cc959514dc09535c Mon Sep 17 00:00:00 2001
From: masmc05 <masmc05@gmail.com>
Date: Sun, 11 Aug 2024 03:01:52 +0300
Subject: [PATCH] Item serialization as json

---
 .../main/java/org/bukkit/UnsafeValues.java    | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/paper-api/src/main/java/org/bukkit/UnsafeValues.java b/paper-api/src/main/java/org/bukkit/UnsafeValues.java
index 98fe2763dc..d0de7ce3c3 100644
--- a/paper-api/src/main/java/org/bukkit/UnsafeValues.java
+++ b/paper-api/src/main/java/org/bukkit/UnsafeValues.java
@@ -168,6 +168,36 @@ public interface UnsafeValues {
 
     ItemStack deserializeItem(byte[] data);
 
+    /**
+     * Serializes this itemstack to json format.
+     * It is safe for data migrations as it will use the built-in data converter instead of bukkit's
+     * dangerous serialization system.
+     * <p>
+     * The emitted json object's format will inherently change across versions and hence should not be used for
+     * non-development purposes like plugin configurations or end-user input.
+     *
+     * @return json object representing this item.
+     * @see #deserializeItemFromJson(com.google.gson.JsonObject)
+     * @throws IllegalArgumentException if the passed itemstack is {@link ItemStack#empty()}.
+     */
+    @NotNull
+    com.google.gson.JsonObject serializeItemAsJson(@NotNull ItemStack itemStack);
+
+    /**
+     * Creates an itemstack from a json object.
+     * <p>
+     * This method expects a json object in the format emitted by {@link #serializeItemAsJson(ItemStack)}.
+     * <p>
+     * The emitted json object's format will inherently change across versions and hence should not be used for
+     * non-development purposes like plugin configurations or end-user input.
+     *
+     * @param data object representing an item in Json format
+     * @return the deserialize item stack, migrated to the latest data version if needed.
+     * @throws IllegalArgumentException if the json object is not a valid item
+     * @see #serializeItemAsJson(ItemStack)
+     */
+    @NotNull ItemStack deserializeItemFromJson(@NotNull com.google.gson.JsonObject data) throws IllegalArgumentException;
+
     byte[] serializeEntity(org.bukkit.entity.Entity entity);
 
     default org.bukkit.entity.Entity deserializeEntity(byte[] data, World world) {