2.7.0 Release

Update .all-contributorsrc

.all-contributorsrc

@@ -139,6 +139,7 @@
       "avatar_url": "https://www.spigotmc.org/data/avatars/l/88/88296.jpg?1563463602",
       "profile": "https://www.spigotmc.org/members/lonedev.88296",
       "contributions": [
+        "code",
         "ideas",
         "financial"
       ],

README.md

@@ -10,13 +10,16 @@ Add custom NBT tags to Items/Tiles/Entities without NMS! Modify NBT and store it
 ### SpigotMC Status
 [![Version](https://badges.spiget.org/resources/version/Version-yellow-7939.svg)](https://www.spigotmc.org/resources/item-entity-tile-nbt-api.7939/)[![Rating](https://badges.spiget.org/resources/rating/Rating-yellow-7939.svg)](https://www.spigotmc.org/resources/item-entity-tile-nbt-api.7939/)[![Rating](https://badges.spiget.org/resources/downloads/SpigotDownloads-yellow-7939.svg)](https://www.spigotmc.org/resources/item-entity-tile-nbt-api.7939/)[![bStats Servers](https://img.shields.io/bstats/servers/1058.svg?color=green&label=OnlineServers&style=plastic)](https://bstats.org/plugin/bukkit/ItemNBTAPI)[![bStats Players](https://img.shields.io/bstats/players/1058.svg?color=green&label=OnlinePlayers&style=plastic)](https://bstats.org/plugin/bukkit/ItemNBTAPI)[![All Contributors](https://img.shields.io/badge/all_contributors-13-green.svg?style=plastic)](#contributors-%e2%9c%a8)
 
-[![bStats Stats](https://bstats.org/signatures/bukkit/ItemNBTAPI.svg)](https://bstats.org/plugin/bukkit/ItemNBTAPI)
-
-<img src="https://starchart.cc/tr7zw/Item-NBT-API.svg" alt="stargazers" width="800"/>
-
 ## Getting started
 Import the API [using Maven](https://github.com/tr7zw/Item-NBT-API/wiki/Using-Maven), then check out the [basic usage](https://github.com/tr7zw/Item-NBT-API/wiki/Using-the-NBT-API) or code examples like [working with Skulls](https://github.com/tr7zw/Item-NBT-API/wiki/Set-a-skull's-skin-using-NBT-API).
 
+### bStats
+
+[![bStats Stats](https://bstats.org/signatures/bukkit/ItemNBTAPI.svg)](https://bstats.org/plugin/bukkit/ItemNBTAPI)
+
+### Github Stargazers
+<img src="https://starchart.cc/tr7zw/Item-NBT-API.svg" alt="stargazers" width="800"/>
+
 ## Contributors ✨
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
@@ -38,7 +41,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://github.com/MrDienns"><img src="https://avatars3.githubusercontent.com/u/15938901?s=460&v=4" width="100px;" alt=""/><br /><sub><b>Dennis van der Veeke</b></sub></a><br /><a href="https://tr7zw.dev/donate/" title="Financial Support">💵</a></td>
     <td align="center"><a href="https://github.com/iGabyTM"><img src="https://avatars2.githubusercontent.com/u/32105478?s=460&v=4" width="100px;" alt=""/><br /><sub><b>Gabriel Dumitru</b></sub></a><br /><a href="#discord-iGabyTM" title="Discord help">🤝</a></td>
     <td align="center"><a href="https://github.com/TauCubed"><img src="https://avatars0.githubusercontent.com/u/35522873?s=460&v=4" width="100px;" alt=""/><br /><sub><b>TauCubed</b></sub></a><br /><a href="#discord-TauCubed" title="Discord help">🤝</a></td>
-    <td align="center"><a href="https://www.spigotmc.org/members/lonedev.88296"><img src="https://www.spigotmc.org/data/avatars/l/88/88296.jpg?1563463602" width="100px;" alt=""/><br /><sub><b>LoneDev</b></sub></a><br /><a href="https://www.spigotmc.org/threads/nbt-api.70503/page-7#post-3652832" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://tr7zw.dev/donate/" title="Financial Support">💵</a></td>
+    <td align="center"><a href="https://www.spigotmc.org/members/lonedev.88296"><img src="https://www.spigotmc.org/data/avatars/l/88/88296.jpg?1563463602" width="100px;" alt=""/><br /><sub><b>LoneDev</b></sub></a><br /><a href="https://github.com/tr7zw/Item-NBT-API/commits?author=LoneDev" title="Code">💻</a> <a href="https://www.spigotmc.org/threads/nbt-api.70503/page-7#post-3652832" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://tr7zw.dev/donate/" title="Financial Support">💵</a></td>
     <td align="center"><a href="https://www.spigotmc.org/members/gc.25090"><img src="https://www.spigotmc.org/data/avatars/l/25/25090.jpg?1502396477" width="100px;" alt=""/><br /><sub><b>GC.</b></sub></a><br /><a href="https://tr7zw.dev/donate/" title="Financial Support">💵</a></td>
     <td align="center"><a href="https://www.spigotmc.org/members/peaches_mlg100.194338/"><img src="https://www.spigotmc.org/data/avatars/l/194/194338.jpg?1561235996" width="100px;" alt=""/><br /><sub><b>Peaches_MLG</b></sub></a><br /><a href="https://tr7zw.dev/donate/" title="Financial Support">💵</a></td>
   </tr>

curseforge.md

@@ -0,0 +1,17 @@
+# (Item)-NBT-API
+Add custom NBT tags to Items/Tiles/Entities without NMS! Modify NBT and store it Files, other NBT or as String in yaml/json/SQL/Redis.
+[Server Owner/Developer Wiki](https://github.com/tr7zw/Item-NBT-API/wiki)
+
+### Build/Maven/Sonar Status
+[![Build Status](https://github.com/tr7zw/Item-NBT-API/workflows/Java%20CI/badge.svg)](https://ci.codemc.org/job/Tr7zw/job/Item-NBT-API/)[![](https://sonarcloud.io/api/project_badges/measure?project=de.tr7zw%3Aitem-nbt-parent&metric=alert_status)](https://sonarcloud.io/dashboard?id=de.tr7zw%3Aitem-nbt-parent)[![](https://sonarcloud.io/api/project_badges/measure?project=de.tr7zw%3Aitem-nbt-parent&metric=ncloc)](https://sonarcloud.io/dashboard?id=de.tr7zw%3Aitem-nbt-parent)[![](https://sonarcloud.io/api/project_badges/measure?project=de.tr7zw%3Aitem-nbt-parent&metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=de.tr7zw%3Aitem-nbt-parent)[![](https://sonarcloud.io/api/project_badges/measure?project=de.tr7zw%3Aitem-nbt-parent&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=de.tr7zw%3Aitem-nbt-parent)
+Discord:[![Discord](https://img.shields.io/discord/342814924310970398?color=%237289DA&label=Discord&logo=discord&logoColor=white)](https://discordapp.com/invite/yk4caxM)
+[![Patreon](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dtr7zw%26type%3Dpatrons&style=for-the-badge)](https://www.patreon.com/tr7zw)
+
+### SpigotMC Status
+[![Version](https://badges.spiget.org/resources/version/Version-yellow-7939.svg)](https://www.spigotmc.org/resources/item-entity-tile-nbt-api.7939/)[![Rating](https://badges.spiget.org/resources/rating/Rating-yellow-7939.svg)](https://www.spigotmc.org/resources/item-entity-tile-nbt-api.7939/)[![Rating](https://badges.spiget.org/resources/downloads/SpigotDownloads-yellow-7939.svg)](https://www.spigotmc.org/resources/item-entity-tile-nbt-api.7939/)[![bStats Servers](https://img.shields.io/bstats/servers/1058.svg?color=green&label=OnlineServers&style=plastic)](https://bstats.org/plugin/bukkit/ItemNBTAPI)[![bStats Players](https://img.shields.io/bstats/players/1058.svg?color=green&label=OnlinePlayers&style=plastic)](https://bstats.org/plugin/bukkit/ItemNBTAPI)
+
+## Getting started
+Import the API [using Maven](https://github.com/tr7zw/Item-NBT-API/wiki/Using-Maven), then check out the [basic usage](https://github.com/tr7zw/Item-NBT-API/wiki/Using-the-NBT-API) or code examples like [working with Skulls](https://github.com/tr7zw/Item-NBT-API/wiki/Set-a-skull's-skin-using-NBT-API).
+
+### bStats
+[![bStats Stats](https://bstats.org/signatures/bukkit/ItemNBTAPI.svg)](https://bstats.org/plugin/bukkit/ItemNBTAPI)

item-nbt-api/pom.xml

@@ -7,7 +7,7 @@
 	<parent>
 		<groupId>de.tr7zw</groupId>
 		<artifactId>item-nbt-parent</artifactId>
-		<version>2.6.0</version>
+		<version>${nbt.version}</version>
 	</parent>
 
 	<artifactId>item-nbt-api</artifactId>

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/NBTBlock.java

@@ -0,0 +1,26 @@
+package de.tr7zw.changeme.nbtapi;
+
+import org.bukkit.block.Block;
+
+import de.tr7zw.changeme.nbtapi.utils.MinecraftVersion;
+
+public class NBTBlock {
+
+	private final Block block;
+	private final NBTChunk nbtChunk;
+	
+	public NBTBlock(Block block) {
+		this.block = block;
+		if(!MinecraftVersion.isAtLeastVersion(MinecraftVersion.MC1_16_R3)) {
+			throw new NbtApiException("NBTBlock is only working for 1.16.4+!");
+		}
+		nbtChunk = new NBTChunk(block.getChunk());
+	}
+	
+	
+	public NBTCompound getData() {
+		return nbtChunk.getPersistentDataContainer().getOrCreateCompound("blocks").getOrCreateCompound(block.getX() + "_" + block.getY() + "_" + block.getZ());
+	}
+
+
+}

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/NBTChunk.java

@@ -0,0 +1,30 @@
+package de.tr7zw.changeme.nbtapi;
+
+import org.bukkit.Chunk;
+
+import de.tr7zw.annotations.FAUtil;
+import de.tr7zw.changeme.nbtapi.utils.MinecraftVersion;
+import de.tr7zw.changeme.nbtapi.utils.annotations.AvaliableSince;
+import de.tr7zw.changeme.nbtapi.utils.annotations.CheckUtil;
+
+public class NBTChunk {
+
+	private final Chunk chunk;
+	
+	public NBTChunk(Chunk chunk) {
+		this.chunk = chunk;
+	}
+	
+	/**
+	 * Gets the NBTCompound used by spigots PersistentDataAPI. This method is only
+	 * available for 1.16.4+!
+	 * 
+	 * @return NBTCompound containing the data of the PersistentDataAPI
+	 */
+	@AvaliableSince(version = MinecraftVersion.MC1_16_R3)
+	public NBTCompound getPersistentDataContainer() {
+		FAUtil.check(this::getPersistentDataContainer, CheckUtil::isAvaliable);
+		return new NBTPersistentDataContainer(chunk.getPersistentDataContainer());
+	}
+	
+}

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/NBTCompound.java

@@ -2,6 +2,8 @@ package de.tr7zw.changeme.nbtapi;
 
 import java.io.OutputStream;
 import java.io.Serializable;
+import java.util.Arrays;
+import java.util.Objects;
 import java.util.Set;
 import java.util.UUID;
 import java.util.concurrent.locks.Lock;
@@ -544,7 +546,7 @@ public class NBTCompound {
 	}
 
 	/**
-	 * Creates a subCompound
+	 * Creates a subCompound, or returns it if already provided
 	 * 
 	 * @param name Key to use
 	 * @return The subCompound Object
@@ -582,6 +584,16 @@ public class NBTCompound {
 			readLock.unlock();
 		}
 	}
+	
+	/**
+	 * The same as addCompound, just with a name that better reflects what it does
+	 * 
+	 * @param name
+	 * @return
+	 */
+	public NBTCompound getOrCreateCompound(String name) {
+		return addCompound(name);
+	}
 
 	/**
 	 * @param name
@@ -657,6 +669,23 @@ public class NBTCompound {
 			writeLock.unlock();
 		}
 	}
+	
+	/**
+	 * Returns the type of the list, null if not a list
+	 * 
+	 * @param name
+	 * @return
+	 */
+	public NBTType getListType(String name) {
+		try {
+			readLock.lock();
+			if (getType(name) != NBTType.NBTTagList)
+				return null;
+			return NBTReflectionUtil.getListType(this, name);
+		} finally {
+			readLock.unlock();
+		}
+	}
 
 	/**
 	 * @param name
@@ -754,8 +783,7 @@ public class NBTCompound {
 	}
 
 	/**
-	 * Uses the nbt-string to match this compound with another object. This allows
-	 * two "technically" different Compounds to match, if they have the same content
+	 * Does a deep compare to check if everything is the same
 	 */
 	@Override
 	public boolean equals(Object obj) {
@@ -763,7 +791,49 @@ public class NBTCompound {
 			return true;
 		if (obj == null)
 			return false;
-		return toString().equals(obj.toString());
+		if(obj instanceof NBTCompound) {
+			NBTCompound other = (NBTCompound) obj;
+			if(getKeys().equals(other.getKeys())) {
+				for(String key : getKeys()) {
+					if(!isEqual(this, other, key)) {
+						return false;
+					}
+					return true;
+				}
+			}
+		}
+		return false;
+	}
+	
+	protected static boolean isEqual(NBTCompound compA, NBTCompound compB, String key) {
+		if(compA.getType(key) != compB.getType(key))return false;
+		switch(compA.getType(key)) {
+		case NBTTagByte:
+			return compA.getByte(key).equals(compB.getByte(key));
+		case NBTTagByteArray:
+			return Arrays.equals(compA.getByteArray(key), compB.getByteArray(key));
+		case NBTTagCompound:
+			return compA.getCompound(key).equals(compB.getCompound(key));
+		case NBTTagDouble:
+			return compA.getDouble(key).equals(compB.getDouble(key));
+		case NBTTagEnd:
+			return true; //??
+		case NBTTagFloat:
+			return compA.getFloat(key).equals(compB.getFloat(key));
+		case NBTTagInt:
+			return compA.getInteger(key).equals(compB.getInteger(key));
+		case NBTTagIntArray:
+			return Arrays.equals(compA.getIntArray(key), compB.getIntArray(key));
+		case NBTTagList:
+			return NBTReflectionUtil.getEntry(compA, key).toString().equals(NBTReflectionUtil.getEntry(compB, key).toString()); // Just string compare the 2 lists
+		case NBTTagLong:
+			return compA.getLong(key).equals(compB.getLong(key));
+		case NBTTagShort:
+			return compA.getShort(key).equals(compB.getShort(key));
+		case NBTTagString:
+			return compA.getString(key).equals(compB.getString(key));
+		}
+		return false;
 	}
 
 }

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/NBTEntity.java

@@ -49,15 +49,7 @@ public class NBTEntity extends NBTCompound {
 	@AvaliableSince(version = MinecraftVersion.MC1_14_R1)
 	public NBTCompound getPersistentDataContainer() {
 		FAUtil.check(this::getPersistentDataContainer, CheckUtil::isAvaliable);
-		if (hasKey("BukkitValues")) {
-			return getCompound("BukkitValues");
-		} else {
-			NBTContainer container = new NBTContainer();
-			container.addCompound("BukkitValues").setString("__nbtapi",
-					"Marker to make the PersistentDataContainer have content");
-			mergeCompound(container);
-			return getCompound("BukkitValues");
-		}
+		return new NBTPersistentDataContainer(ent.getPersistentDataContainer());
 	}
 
 }

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/NBTPersistentDataContainer.java

@@ -0,0 +1,31 @@
+package de.tr7zw.changeme.nbtapi;
+
+import java.util.Map;
+
+import org.bukkit.persistence.PersistentDataContainer;
+
+import de.tr7zw.changeme.nbtapi.utils.nmsmappings.ReflectionMethod;
+
+public class NBTPersistentDataContainer extends NBTCompound {
+
+	private final PersistentDataContainer container;
+	
+	protected NBTPersistentDataContainer(PersistentDataContainer container) {
+		super(null, null);
+		this.container = container;
+	}
+
+	@Override
+	public Object getCompound() {
+		return ReflectionMethod.CRAFT_PERSISTENT_DATA_CONTAINER_TO_TAG.run(container);
+	}
+
+	@Override
+	protected void setCompound(Object compound) {
+		@SuppressWarnings("unchecked")
+		Map<Object, Object> map = (Map<Object, Object>) ReflectionMethod.CRAFT_PERSISTENT_DATA_CONTAINER_GET_MAP.run(container);
+		map.clear();
+		ReflectionMethod.CRAFT_PERSISTENT_DATA_CONTAINER_PUT_ALL.run(container, compound);
+	}
+	
+}

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/NBTReflectionUtil.java

@@ -459,6 +459,40 @@ public class NBTReflectionUtil {
 			throw new NbtApiException("Exception while getting a list with the type '" + type + "'!", ex);
 		}
 	}
+	
+	public static NBTType getListType(NBTCompound comp, String key) {
+		Object rootnbttag = comp.getCompound();
+		if (rootnbttag == null) {
+			rootnbttag = ObjectCreator.NMS_NBTTAGCOMPOUND.getInstance();
+		}
+		if (!valideCompound(comp))
+			return null;
+		Object workingtag = gettoCompount(rootnbttag, comp);
+		try {
+			Object nbt = ReflectionMethod.COMPOUND_GET.run(workingtag, key);
+			Field f = nbt.getClass().getDeclaredField("type");
+			f.setAccessible(true);
+			return NBTType.valueOf(f.getByte(nbt));
+		} catch (Exception ex) {
+			throw new NbtApiException("Exception while getting the list type!", ex);
+		}
+	}
+	
+	public static Object getEntry(NBTCompound comp, String key) {
+		Object rootnbttag = comp.getCompound();
+		if (rootnbttag == null) {
+			rootnbttag = ObjectCreator.NMS_NBTTAGCOMPOUND.getInstance();
+		}
+		if (!valideCompound(comp))
+			return null;
+		Object workingtag = gettoCompount(rootnbttag, comp);
+		try {
+			Object nbt = ReflectionMethod.COMPOUND_GET.run(workingtag, key);
+			return nbt;
+		} catch (Exception ex) {
+			throw new NbtApiException("Exception while getting an Entry!", ex);
+		}
+	}
 
 	/**
 	 * Uses Gson to set a {@link Serializable} value in a Compound

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/utils/MinecraftVersion.java

@@ -30,7 +30,7 @@ public enum MinecraftVersion {
 	private static Logger logger = Logger.getLogger("NBTAPI");
 
 	// NBT-API Version
-	protected static final String VERSION = "2.6.0";
+	protected static final String VERSION = "2.7.0";
 
 	private final int versionId;
 

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/utils/VersionChecker.java

@@ -53,7 +53,7 @@ public class VersionChecker {
 				MinecraftVersion.getLogger().log(Level.INFO, "[NBTAPI] The NBT-API seems to be up-to-date!");
 			} else if (versionDifference == 1) {
 				MinecraftVersion.getLogger().log(Level.WARNING, "[NBTAPI] The NBT-API at '" + NBTItem.class.getPackage()
-						+ "' seems to be a future Version, not yet released on Spigot!");
+						+ "' seems to be a future Version, not yet released on Spigot/CurseForge!");
 				MinecraftVersion.getLogger().log(Level.WARNING, "[NBTAPI] Current Version: '" + MinecraftVersion.VERSION
 						+ "' Newest Version: " + latest.get("name").getAsString() + "'");
 			}

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/utils/nmsmappings/ClassWrapper.java

@@ -18,6 +18,7 @@ CRAFT_ITEMSTACK(PackageWrapper.CRAFTBUKKIT, "inventory.CraftItemStack"),
 CRAFT_METAITEM(PackageWrapper.CRAFTBUKKIT, "inventory.CraftMetaItem"),
 CRAFT_ENTITY(PackageWrapper.CRAFTBUKKIT, "entity.CraftEntity"),
 CRAFT_WORLD(PackageWrapper.CRAFTBUKKIT, "CraftWorld"),
+CRAFT_PERSISTENTDATACONTAINER(PackageWrapper.CRAFTBUKKIT, "persistence.CraftPersistentDataContainer", MinecraftVersion.MC1_14_R1, null),
 NMS_NBTBASE(PackageWrapper.NMS, "NBTBase"),
 NMS_NBTTAGSTRING(PackageWrapper.NMS, "NBTTagString"),
 NMS_NBTTAGINT(PackageWrapper.NMS, "NBTTagInt"),

item-nbt-api/src/main/java/de/tr7zw/changeme/nbtapi/utils/nmsmappings/ReflectionMethod.java

@@ -108,7 +108,12 @@ public enum ReflectionMethod {
     REGISTRYMATERIALS_GETKEY (ClassWrapper.NMS_REGISTRYMATERIALS.getClazz(), new Class[]{Object.class}, MinecraftVersion.MC1_13_R2, new Since(MinecraftVersion.MC1_13_R2, "getKey")),
 
     GAMEPROFILE_DESERIALIZE (ClassWrapper.NMS_GAMEPROFILESERIALIZER.getClazz(), new Class[]{ClassWrapper.NMS_NBTTAGCOMPOUND.getClazz()}, MinecraftVersion.MC1_7_R4, new Since(MinecraftVersion.MC1_7_R4, "deserialize")),
-    GAMEPROFILE_SERIALIZE (ClassWrapper.NMS_GAMEPROFILESERIALIZER.getClazz(), new Class[]{ClassWrapper.NMS_NBTTAGCOMPOUND.getClazz(), ClassWrapper.GAMEPROFILE.getClazz()}, MinecraftVersion.MC1_8_R3, new Since(MinecraftVersion.MC1_8_R3, "serialize"));
+    GAMEPROFILE_SERIALIZE (ClassWrapper.NMS_GAMEPROFILESERIALIZER.getClazz(), new Class[]{ClassWrapper.NMS_NBTTAGCOMPOUND.getClazz(), ClassWrapper.GAMEPROFILE.getClazz()}, MinecraftVersion.MC1_8_R3, new Since(MinecraftVersion.MC1_8_R3, "serialize")),
+    
+    CRAFT_PERSISTENT_DATA_CONTAINER_TO_TAG (ClassWrapper.CRAFT_PERSISTENTDATACONTAINER.getClazz(), new Class[]{}, MinecraftVersion.MC1_14_R1, new Since(MinecraftVersion.MC1_14_R1, "toTagCompound")),
+    CRAFT_PERSISTENT_DATA_CONTAINER_GET_MAP (ClassWrapper.CRAFT_PERSISTENTDATACONTAINER.getClazz(), new Class[]{}, MinecraftVersion.MC1_14_R1, new Since(MinecraftVersion.MC1_14_R1, "getRaw")),
+    CRAFT_PERSISTENT_DATA_CONTAINER_PUT_ALL (ClassWrapper.CRAFT_PERSISTENTDATACONTAINER.getClazz(), new Class[]{ClassWrapper.NMS_NBTTAGCOMPOUND.getClazz()}, MinecraftVersion.MC1_14_R1, new Since(MinecraftVersion.MC1_14_R1, "putAll")),
+    ;
     
     private MinecraftVersion removedAfter;
     private Since targetVersion;

item-nbt-plugin/pom.xml

@@ -4,7 +4,7 @@
   <parent>
     <groupId>de.tr7zw</groupId>
     <artifactId>item-nbt-parent</artifactId>
-    <version>2.6.0</version>
+    <version>${nbt.version}</version>
   </parent>
   <artifactId>item-nbt-api-plugin</artifactId>
   <packaging>jar</packaging>
@@ -12,19 +12,19 @@
     <dependency>
       <groupId>de.tr7zw</groupId>
       <artifactId>item-nbt-api</artifactId>
-      <version>2.6.0</version>
+      <version>${nbt.version}</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>de.tr7zw</groupId>
       <artifactId>nbt-injector</artifactId>
-      <version>2.6.0</version>
+      <version>${nbt.version}</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>de.tr7zw</groupId>
       <artifactId>nbt-data-api</artifactId>
-      <version>2.6.0</version>
+      <version>${nbt.version}</version>
       <scope>compile</scope>
     </dependency>
   </dependencies>
@@ -81,7 +81,7 @@
         <configuration>
           <!-- 1.8.8-R0.1-SNAPSHOT-latest, 1.9.2-R0.1-SNAPSHOT-latest, 1.9.4-R0.1-SNAPSHOT-latest, 1.10.2-R0.1-SNAPSHOT-latest,1.11.2,1.12.2,1.13.2,1.14.4,1.15.1,1.16.1,1.16.2 -->
           <versions>
-          1.8.8-R0.1-SNAPSHOT-latest,
+          https://yivesmirror.com/files/paper/PaperSpigot-1.8.8-R0.1-SNAPSHOT-latest.jar,
           1.9.2-R0.1-SNAPSHOT-latest, 1.9.4-R0.1-SNAPSHOT-latest,
           1.10.2-R0.1-SNAPSHOT-latest,
           1.11.2,
@@ -89,7 +89,7 @@
           1.13.2,
           1.14.4,
           1.15.1,
-          1.16.1,1.16.2,https://yivesmirror.com/files/paper/Paper-1.16.4-latest.jar
+          https://yivesmirror.com/files/paper/Paper-1.16.4-latest.jar
           </versions>
           <works>Success! This version of NBT-API</works>
           <error>WARNING! This version of NBT-API</error>

item-nbt-plugin/src/main/java/de/tr7zw/nbtapi/plugin/NBTAPI.java

@@ -14,6 +14,8 @@ import de.tr7zw.changeme.nbtapi.utils.nmsmappings.ClassWrapper;
 import de.tr7zw.changeme.nbtapi.utils.nmsmappings.ReflectionMethod;
 import de.tr7zw.nbtapi.plugin.tests.GameprofileTest;
 import de.tr7zw.nbtapi.plugin.tests.NBTFileTest;
+import de.tr7zw.nbtapi.plugin.tests.blocks.BlockNBTTest;
+import de.tr7zw.nbtapi.plugin.tests.chunks.ChunkNBTPersistentTest;
 import de.tr7zw.nbtapi.plugin.tests.compounds.EqualsTest;
 import de.tr7zw.nbtapi.plugin.tests.compounds.ForEachTest;
 import de.tr7zw.nbtapi.plugin.tests.compounds.GetterSetterTest;
@@ -113,6 +115,12 @@ public class NBTAPI extends JavaPlugin {
 		apiTests.add(new TileTest());
 		apiTests.add(new TilesCustomNBTPersistentTest());
 
+		// Chunks
+		apiTests.add(new ChunkNBTPersistentTest());
+		
+		// Blocks
+		apiTests.add(new BlockNBTTest());
+		
 		// Files
 		apiTests.add(new NBTFileTest());
 		

item-nbt-plugin/src/main/java/de/tr7zw/nbtapi/plugin/tests/blocks/BlockNBTTest.java

@@ -0,0 +1,40 @@
+package de.tr7zw.nbtapi.plugin.tests.blocks;
+
+import org.bukkit.Bukkit;
+import org.bukkit.Chunk;
+import org.bukkit.World;
+import org.bukkit.block.Block;
+
+import de.tr7zw.changeme.nbtapi.NBTBlock;
+import de.tr7zw.changeme.nbtapi.NbtApiException;
+import de.tr7zw.changeme.nbtapi.utils.MinecraftVersion;
+import de.tr7zw.nbtapi.plugin.tests.Test;
+
+public class BlockNBTTest implements Test {
+
+	@Override
+	public void test() throws Exception {
+		if(MinecraftVersion.getVersion().getVersionId() < MinecraftVersion.MC1_16_R3.getVersionId())return;
+		if (!Bukkit.getWorlds().isEmpty()) {
+			World world = Bukkit.getWorlds().get(0);
+			try {
+				if (world.getLoadedChunks().length > 1) {
+					Chunk chunk = world.getLoadedChunks()[0];
+					Block block = chunk.getBlock(0, 254, 0);
+					NBTBlock comp = new NBTBlock(block);
+					comp.getData().removeKey("Too");
+					if(comp.getData().hasKey("Too")) {
+						throw new NbtApiException("Unable to remove key from Block!");
+					}
+					comp.getData().setString("Too", "Bar");
+					if (!new NBTBlock(block).getData().getString("Too").equals("Bar")) {
+						throw new NbtApiException("Custom Data did not save to a Block!");
+					}
+				}
+			} catch (Exception ex) {
+				throw new NbtApiException("Wasn't able to use NBTBlocks!", ex);
+			}
+		}
+	}
+
+}

item-nbt-plugin/src/main/java/de/tr7zw/nbtapi/plugin/tests/chunks/ChunkNBTPersistentTest.java

@@ -0,0 +1,40 @@
+package de.tr7zw.nbtapi.plugin.tests.chunks;
+
+import org.bukkit.Bukkit;
+import org.bukkit.Chunk;
+import org.bukkit.World;
+
+import de.tr7zw.changeme.nbtapi.NBTChunk;
+import de.tr7zw.changeme.nbtapi.NBTCompound;
+import de.tr7zw.changeme.nbtapi.NbtApiException;
+import de.tr7zw.changeme.nbtapi.utils.MinecraftVersion;
+import de.tr7zw.nbtapi.plugin.tests.Test;
+
+public class ChunkNBTPersistentTest implements Test {
+
+	@Override
+	public void test() throws Exception {
+		if(MinecraftVersion.getVersion().getVersionId() < MinecraftVersion.MC1_16_R3.getVersionId())return;
+		if (!Bukkit.getWorlds().isEmpty()) {
+			World world = Bukkit.getWorlds().get(0);
+			try {
+				if (world.getLoadedChunks().length > 1) {
+					Chunk chunk = world.getLoadedChunks()[0];
+					NBTChunk comp = new NBTChunk(chunk);
+					NBTCompound persistentData = comp.getPersistentDataContainer();
+					persistentData.removeKey("Foo");
+					if(persistentData.hasKey("Foo")) {
+						throw new NbtApiException("Unable to remove key from Chunk!");
+					}
+					persistentData.setString("Foo", "Bar");
+					if (!new NBTChunk(chunk).getPersistentDataContainer().getString("Foo").equals("Bar")) {
+						throw new NbtApiException("Custom Data did not save to the Chunk!");
+					}
+				}
+			} catch (Exception ex) {
+				throw new NbtApiException("Wasn't able to use NBTChunks!", ex);
+			}
+		}
+	}
+
+}

item-nbt-plugin/src/main/java/de/tr7zw/nbtapi/plugin/tests/compounds/EqualsTest.java

@@ -1,5 +1,7 @@
 package de.tr7zw.nbtapi.plugin.tests.compounds;
 
+import java.util.Arrays;
+
 import org.bukkit.Material;
 import org.bukkit.inventory.ItemStack;
 
@@ -17,6 +19,7 @@ public class EqualsTest implements Test{
 		cont.setString("hello", "world");
 		cont.setInteger("theAnswer", 42);
 		cont.addCompound("sub").setString("me", "too");
+		cont.getStringList("somelist").addAll(Arrays.asList("a", "b", "c"));
 		ItemStack item = new ItemStack(Material.STONE);
 		NBTItem nbti = new NBTItem(item);
 		NBTCompound customData = nbti.addCompound("customData");
@@ -24,6 +27,7 @@ public class EqualsTest implements Test{
 		customData.addCompound("sub").setString("me", "too");
 		customData.setInteger("theAnswer", 42);
 		customData.setString("hello", "world");
+		customData.getStringList("somelist").addAll(Arrays.asList("a", "b", "c"));
 		if(!customData.equals(cont)) {
 			throw new NbtApiException("Compounds did not match! " + customData + " " + cont);
 		}

item-nbt-plugin/src/main/java/de/tr7zw/nbtapi/plugin/tests/compounds/ListTest.java

@@ -67,6 +67,10 @@ public class ListTest implements Test {
 		} else {
 			throw new NbtApiException("Taglist is empty! The Item-NBT-API may not work!");
 		}
+		
+		if(comp.getListType("complist") != NBTType.NBTTagCompound) {
+			throw new NbtApiException("complist had the wrong type! The Item-NBT-API may not work!");
+		}
 
 		// Integer
 		NBTList<Integer> intlist = comp.getIntegerList("inttest");
@@ -77,6 +81,10 @@ public class ListTest implements Test {
 		} else {
 			throw new NbtApiException("IntList is not correct! " + Arrays.toString(intlist.toArray(new Integer[0])));
 		}
+		
+		if(comp.getListType("inttest") != NBTType.NBTTagInt) {
+			throw new NbtApiException("inttest had the wrong type! The Item-NBT-API may not work!");
+		}
 
 		// Double
 		NBTList<Double> doublelist = comp.getDoubleList("doubletest");
@@ -87,6 +95,10 @@ public class ListTest implements Test {
 		} else {
 			throw new NbtApiException("DoubleList is not correct! " + Arrays.toString(doublelist.toArray(new Double[0])));
 		}
+		
+		if(comp.getListType("doubletest") != NBTType.NBTTagDouble) {
+			throw new NbtApiException("doubletest had the wrong type! The Item-NBT-API may not work!");
+		}
 
 		// Float
 		NBTList<Float> floatlist = comp.getFloatList("floattest");
@@ -97,6 +109,10 @@ public class ListTest implements Test {
 		} else {
 			throw new NbtApiException("FloatList is not correct! " + Arrays.toString(floatlist.toArray(new Float[0])));
 		}
+		
+		if(comp.getListType("floattest") != NBTType.NBTTagFloat) {
+			throw new NbtApiException("floattest had the wrong type! The Item-NBT-API may not work!");
+		}
 
 		// Long
 		NBTList<Long> longlist = comp.getLongList("longtest");
@@ -108,6 +124,10 @@ public class ListTest implements Test {
 			throw new NbtApiException("LongList is not correct! " + Arrays.toString(longlist.toArray(new Long[0])));
 		}
 
+		if(comp.getListType("longtest") != NBTType.NBTTagLong) {
+			throw new NbtApiException("longtest had the wrong type! The Item-NBT-API may not work!");
+		}
+		
 	}
 
 }

item-nbt-plugin/src/main/java/de/tr7zw/nbtapi/plugin/tests/compounds/SubCompoundsTest.java

@@ -45,6 +45,12 @@ public class SubCompoundsTest implements Test {
 				|| comp.getBoolean(BOOLEAN_TEST_KEY) == BOOLEAN_TEST_VALUE) {
 			throw new NbtApiException("One key does not equal the original compound value!");
 		}
+		
+		// Using getOrCreateCompound twice
+		comp.getOrCreateCompound("someName").setString("test", "abc");
+		if(!comp.getOrCreateCompound("someName").getString("test").equals("abc")) {
+			throw new NbtApiException("getOrCreateCompound did not return the same compound!");
+		}
 	}
 
 }

item-nbt-plugin/src/main/java/de/tr7zw/nbtapi/plugin/tests/tiles/TilesCustomNBTPersistentTest.java

@@ -26,7 +26,7 @@ public class TilesCustomNBTPersistentTest implements Test {
 					NBTTileEntity comp = new NBTTileEntity(block.getState());
 					NBTCompound persistentData = comp.getPersistentDataContainer();
 					persistentData.setString("Foo", "Bar");
-					if (!new NBTTileEntity(block.getState()).getPersistentDataContainer().toString().contains("Foo:\"Bar\"")) {
+					if (!new NBTTileEntity(block.getState()).getPersistentDataContainer().getString("Foo").equals("Bar")) {
 						block.setType(Material.AIR);
 						throw new NbtApiException("Custom Data did not save to the Tile!");
 					}

nbt-data-api/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>de.tr7zw</groupId>
         <artifactId>item-nbt-parent</artifactId>
-        <version>2.6.0</version>
+        <version>${nbt.version}</version>
     </parent>
 
     <artifactId>nbt-data-api</artifactId>
@@ -16,7 +16,7 @@
     <dependency>
       <groupId>de.tr7zw</groupId>
       <artifactId>item-nbt-api</artifactId>
-      <version>2.6.0</version>
+      <version>${nbt.version}</version>
       <scope>compile</scope>
     </dependency>
   </dependencies>

nbt-injector/pom.xml

@@ -4,7 +4,7 @@
   <parent>
     <groupId>de.tr7zw</groupId>
     <artifactId>item-nbt-parent</artifactId>
-    <version>2.6.0</version>
+    <version>${nbt.version}</version>
   </parent>
   <artifactId>nbt-injector</artifactId>
   <packaging>jar</packaging>
@@ -12,7 +12,7 @@
     <dependency>
       <groupId>de.tr7zw</groupId>
       <artifactId>item-nbt-api</artifactId>
-      <version>2.6.0</version>
+      <version>${nbt.version}</version>
       <scope>compile</scope>
     </dependency>
     <dependency>

pom.xml

@@ -3,22 +3,23 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>de.tr7zw</groupId>
   <artifactId>item-nbt-parent</artifactId>
-  <version>2.6.0</version>
+  <version>${nbt.version}</version>
   <packaging>pom</packaging>
   <modules>
     <module>item-nbt-api</module>
     <module>nbt-injector</module>
-	<module>nbt-data-api</module>
+	  <module>nbt-data-api</module>
     <module>item-nbt-plugin</module>
   </modules>
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <nbt.version>2.7.0</nbt.version>
   </properties>
   <dependencies>
     <dependency>
       <groupId>org.spigotmc</groupId>
       <artifactId>spigot-api</artifactId>
-      <version>1.14.2-R0.1-SNAPSHOT</version>
+      <version>1.16.4-R0.1-SNAPSHOT</version>
       <scope>provided</scope>
     </dependency>
     <dependency>

spigot.bb

@@ -0,0 +1,289 @@
+[B][SIZE=6](Item/Entity/Tile) NBT API[/SIZE][/B]
+[URL='https://ci.codemc.io/job/Tr7zw/job/Item-NBT-API/'][IMG]https://ci.codemc.org/buildStatus/icon?job=Tr7zw%2FItem-NBT-API[/IMG][/URL]  [URL='https://sonarcloud.io/dashboard?id=de.tr7zw%3Aitem-nbt-parent'][IMG]https://sonarcloud.io/api/project_badges/measure?project=de.tr7zw%3Aitem-nbt-parent&metric=ncloc[/IMG][/URL] [URL='https://bstats.org/plugin/bukkit/ItemNBTAPI'][IMG]https://img.shields.io/bstats/servers/1058.svg?color=green&label=OnlineServers&style=plastic[/IMG][/URL] [URL='https://bstats.org/plugin/bukkit/ItemNBTAPI'][IMG]https://img.shields.io/bstats/players/1058.svg?color=green&label=OnlinePlayers&style=plastic[/IMG] [/URL][URL='https://discordapp.com/invite/yk4caxM'][IMG]https://img.shields.io/discord/342814924310970398?color=%237289DA&label=Discord&logo=discord&logoColor=white[/IMG][/URL] [IMG]https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.vercel.app%2Fapi%3Fusername%3Dtr7zw%26type%3Dpatrons&style=for-the-badge[/IMG]
+The NBT API allows you to add custom NBT tags to Itemstacks, TileEntities and Entities, or modify excisting ones!
+It completely uses reflections to interact with NMS code and works with all the latest versions. On server start the plugin checks all reflections.
+
+Tested on Spigot
+[LIST]
+[*](1.7*)1.8.8-1.16.4
+[*]The NBTInjector will not work with: 1.12.0, 1.12.1, 1.13.0 (Please just update to the final release of your chosen version)
+
+[*]On startup you will get a notification if there is a version problem!
+[/LIST]
+* 1.7 Notes: Use a 1.7 with R4 (1.7.10), NBTLists may not work, everything using Gson is disabled(Add Gson before the NBTAPI loads, to turn it back on), and you can't get the NBTTypes, because 1.7 is missing this feature. TLDR: 1.7.10 is somewhat broken and not everything might work due to 1.7.10 limitations.
+
+[B]What do I have to do as a server owner?[/B]
+Just download the jar and drop it in the plugins folder. Done.
+Note that outdated plugins may ask for "ItemNBTAPI". In this case download version 1.8.3 from the versions tab. The outdated "ItemNBTAPI" and "NBTApi" can be used at the same time.
+[B]Important for version 2.0.0:[/B] Don't reload while using the NBTInjector. Reloading, in general, is a horrible thing and it will break the NBTInjector in horrible ways! When updating plugins/changing configs always restart the server normally!
+
+[B]How can I use the API as developer?[/B]
+Create the NBT Wrapper:
+[CODE]NBTItem nbti = new NBTItem(item);
+NBTEntity nbtent = new NBTEntity(zombie); //Only for vanilla tags!
+NBTTileEntity tent = new NBTTileEntity(block.getState()); //Only for vanilla tags!
+NBTFile file = new NBTFile(new File(getDataFolder(), "test.nbt"));
+NBTContainer container =  new NBTContainer(json); //Parse in json
+[/CODE]
+
+Add/Get/Override NBT tags:
+[CODE]//Set
+nbti.setString("Stringtest", "Teststring");
+nbti.setInteger("Inttest", 42);
+nbti.setDouble("Doubletest", 1.5d);
+nbti.setBoolean("Booleantest", true);
+//More are avaible!
+//Get
+nbti.getString("Stringtest");
+nbti.getInteger("Inttest");
+nbti.getDouble("Doubletest");
+nbti.getBoolean("Booleantest");
+//Get all Tags
+nbti.getKeys();
+//Check for an tag
+nbti.hasKey("Key");
+//Remove a tag
+nbti.removeKey("Key");
+//or
+nbti.setString("Stringtest", null);
+//Create NBTTagCombounds(Imagine folders)
+nbti.addCompound("subtag");
+//Get Compound
+NBTCompound comp = nbti.getCompound("subtag");
+//Get Compound parent(null at root)
+comp.getParent();
+//Save Objects via Gson
+nbti.setObject("myobject", new SimpleJsonTestObject());
+//Get Objects
+SimpleJsonTestObject simpleObject = nbti.getObject("myobject", SimpleJsonTestObject.class);
+//Merge the data from compound A into B (Like the /data merge command)
+B.mergeCompound(A);
+//Get the nbt as json
+comp.asNBTString();
+
+//Access/create lists
+nbtent.getCompoundList("Attributes");
+nbtent.getStringList("Attributes");
+[/CODE]
+
+And finally get back the Bukkit Itemstack(Changes on Tiles/Entities will happen directly):
+[CODE]nbti.getItem();[/CODE]
+Saving the NBTFile:
+[CODE]file.save();[/CODE]
+
+[B]Important note regarding Tiles/Entities
+[B]Starting with 1.14+ you can use the getPersistentDataContainer() (for NBT(Tile)-Entity's) to save custom tags. This replaces the now mentioned NBT-Injector.[/B][/B]
+Non-vanilla tags can't usually be added to to Tiles/Entities. Thanks to
+[URL='https://www.spigotmc.org/members/inventivetalent.6643/'][IMG]https://tr7zw.dev/nbtapi/spigotPeople.php?id=6643[/IMG][/URL] the NBTAPI now includes a tool called "NBTInjector", that compiles custom (Tile-)Entity classes during runtime to allow custom nbt. The custom data will remain during chunk unloads/server restarts. [B]Data will be lost when chunks get loaded without the NBTAPI loaded! Since 2.1.0 the NBTInjector won't be enabled by default! Please enable it during onLoad with NBTInjector.inject(); if you are using it![/B]
+Adding custom nbt to tiles:
+[CODE]
+NBTCompound comp = NBTInjector.getNbtData(block.getState());
+comp.setString("Foo", "Bar");
+[/CODE]
+Adding custom nbt to entities:
+[CODE]
+Entity ent = world.getEntitiesByClasses(Animals.class, Monster.class).iterator().next();
+ent = NBTInjector.patchEntity(ent); //This needs to be called at least once on the entity to enable custom nbt!
+NBTCompound comp = NBTInjector.getNbtData(ent);
+comp.setString("Hello", "World");
+[/CODE]
+[B]Note[/B]: Before NBTInjector.getNbtData can be used on an Entity, NBTInjector.patchEntity has to be used on it at least once. This method will check if the entity is patched, and if not remove the entity and respawn it with the correct class. This destroys the original entity reference(the new one is returned) and the entity will blink once ingame. Bestcase you call this method right when the entity is spawned to prevent unwanted behavior(the blink, entities interacting with the Entity beeing patched like riding/leashes/combat may have problems).
+
+[B]Maven[/B]
+(Historicly it was Jitpack. Don't use it anymore!)
+NBTApi is hosted and compiled by CodeMC.
+[URL='https://ci.codemc.org/job/Tr7zw/job/Item-NBT-API/']JenkinsBuild[/URL] [URL='https://github.com/CodeMC/CI-Documentation']CodeMC-Info[/URL]
+[code]<repositories>
+...
+<!-- CodeMC -->
+<repository>
+<id>codemc-repo</id>
+<url>https://repo.codemc.org/repository/maven-public/</url>
+<layout>default</layout>
+</repository>
+...
+</repositories>
+[/code]
+The API can be used in different ways:
+[SPOILER="Normal Plugin dependency"]
+Just use the Plugin as Maven dependency and remember to add "NBTAPI" as dependency into the plugin.yml. This way server owners will have to install the api and keep it updated.
+[CODE]
+<dependency>
+  <groupId>de.tr7zw</groupId>
+  <artifactId>item-nbt-api-plugin</artifactId>
+  <version>2.6.0</version>
+</dependency>
+[/CODE]
+[/SPOILER]
+[SPOILER="Shading the API into your plugin"]
+Using this method the API gets copied into your plugin. Server owners don't have to install the API on their own, but you need to keep it updated. Also [B]relocating is required[/B]!
+[CODE]
+<dependency>
+  <groupId>de.tr7zw</groupId>
+  <artifactId>item-nbt-api</artifactId>
+  <version>2.6.0</version>
+</dependency>
+...
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-shade-plugin</artifactId>
+        <version>3.2.1</version>
+        <executions>
+          <execution>
+            <id>shade</id>
+            <phase>package</phase>
+            <goals>
+              <goal>shade</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <relocations>
+            <relocation>
+              <pattern>de.tr7zw.changeme.nbtapi</pattern>
+              <shadedPattern>YOUR PACKGE WHERE THE API SHOULD END UP</shadedPattern>
+            </relocation>
+          </relocations>
+        </configuration>
+      </plugin>
+   </plugins>
+[/CODE]
+[/SPOILER]
+
+[B]Example Code[/B]
+[SPOILER="Zombie that will pickup loot and does 0.5 Hearts of damage"]
+[CODE]
+ Zombie z = (Zombie) b.getWorld().spawnEntity(b.getLocation().add(0, 1, 0), EntityType.ZOMBIE);
+                NBTEntity nbtent = new NBTEntity(z);
+                nbtent.setByte("CanPickUpLoot", (byte) 1);
+                NBTList list = nbtent.getCompoundList("Attributes");
+                for(int i = 0; i < list.size(); i++){
+                    NBTListCompound lc = list.getCompound(i);
+                    if(lc.getString("Name").equals("generic.attackDamage")){
+                        lc.setDouble("Base", 0.5d);
+                    }
+                }
+[/CODE]
+[/SPOILER]
+
+[SPOILER="Simulate the command /data merge entity @e[type=zombie] {Silent:1b,Invulnerable:1b,Glowing:1b,IsBaby:1b}"]
+[CODE]
+                NBTEntity nbtent = new NBTEntity(zombie);
+                nbtent.mergeCompound(new NBTContainer("{Silent:1b,Invulnerable:1b,Glowing:1b,IsBaby:1b}"));
+[/CODE]
+[/SPOILER]
+
+[SPOILER="Creating a Head with texture, healthboost and some more tags"]
+[CODE]
+        ItemStack head = new ItemStack(Material.SKULL_ITEM, 1, (short) 3);
+        NBTItem nbti = new NBTItem(head);
+        NBTCompound disp = nbti.addCompound("display");
+        disp.setString("Name", "Testitem");
+        List<String> l = disp.getStringList("Lore");
+        l.add("Some lore");
+        NBTCompound skull = nbti.addCompound("SkullOwner");
+        skull.setString("Name", "tr7zw");
+        skull.setString("Id", "fce0323d-7f50-4317-9720-5f6b14cf78ea");
+        NBTListCompound texture = skull.addCompound("Properties").getCompoundList("textures").addCompound();
+        texture.setString("Signature", "XpRfRz6/vXE6ip7/vq+40H6W70GFB0yjG6k8hG4pmFdnJFR+VQhslE0gXX/i0OAGThcAVSIT+/W1685wUxNofAiy+EhcxGNxNSJkYfOgXEVHTCuugpr+EQCUBI6muHDKms3PqY8ECxdbFTUEuWxdeiJsGt9VjHZMmUukkGhk0IobjQS3hjQ44FiT1tXuUU86oAxqjlKFpXG/iXtpcoXa33IObSI1S3gCKzVPOkMGlHZqRqKKElB54I2Qo4g5CJ+noudIDTzxPFwEEM6XrbM0YBi+SOdRvTbmrlkWF+ndzVWEINoEf++2hkO0gfeCqFqSMHuklMSgeNr/YtFZC5ShJRRv7zbyNF33jZ5DYNVR+KAK9iLO6prZhCVUkZxb1/BjOze6aN7kyN01u3nurKX6n3yQsoQQ0anDW6gNLKzO/mCvoCEvgecjaOQarktl/xYtD4YvdTTlnAlv2bfcXUtc++3UPIUbzf/jpf2g2wf6BGomzFteyPDu4USjBdpeWMBz9PxVzlVpDAtBYClFH/PFEQHMDtL5Q+VxUPu52XlzlUreMHpLT9EL92xwCAwVBBhrarQQWuLjAQXkp3oBdw6hlX6Fj0AafMJuGkFrYzcD7nNr61l9ErZmTWnqTxkJWZfZxmYBsFgV35SKc8rkRSHBNjcdKJZVN4GA+ZQH5B55mi4=");
+        texture.setString("Value", "eyJ0aW1lc3RhbXAiOjE0OTMwNDkwMTcxNTIsInByb2ZpbGVJZCI6ImZjZTAzMjNkN2Y1MDQzMTc5NzIwNWY2YjE0Y2Y3OGVhIiwicHJvZmlsZU5hbWUiOiJ0cjd6dyIsInNpZ25hdHVyZVJlcXVpcmVkIjp0cnVlLCJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYTI3NDZlNWU5OGMwZWRmZTU1YTI3ZGRjNjUxMmJmNjllYzJiYmNlNmM3ZmNhNTQ5YmEzNjZkYThiNTRjZTRkYiJ9fX0=");
+
+        NBTCompoundList attribute = nbti.getCompoundList("AttributeModifiers");
+        NBTListCompound mod1 = attribute.addCompound();
+        mod1.setInteger("Amount", 10);
+        mod1.setString("AttributeName", "generic.maxHealth");
+        mod1.setString("Name", "generic.maxHealth");
+        mod1.setInteger("Operation", 0);
+        mod1.setInteger("UUIDLeast", 59664);
+        mod1.setInteger("UUIDMost", 31453);
+
+        nbti.setInteger("HideFlags", 4);
+        nbti.setBoolean("Unbreakable", true);
+        head = nbti.getItem();
+        e.getPlayer().getInventory().addItem(head);
+[/CODE]
+[/SPOILER]
+
+[SPOILER="Printing the NBT tags"]
+[CODE]
+                Ocelot m = (Ocelot) e.getPlayer().getWorld().spawnEntity(e.getPlayer().getLocation(), EntityType.OCELOT);
+                NBTEntity ent = new NBTEntity(m);
+                System.out.println(ent);
+[/CODE]
+Output:
+[CODE]
+-AgeLocked: 0b
+-HurtByTimestamp: 0
+-CatType: 0
+-Leashed: 0b
+-Health: 10.0f
+-Sitting: 0b
+-Attributes: [0:{Base:10.0d,Name:"generic.maxHealth"},1:{Base:0.0d,Name:"generic.knockbackResistance"},2:{Base:0.30000001192092896d,Name:"generic.movementSpeed"},3:{Base:0.0d,Name:"generic.armor"},4:{Base:0.0d,Name:"generic.armorToughness"},5:{Base:16.0d,Modifiers:[0:{UUIDMost:-8783172028836920024L,UUIDLeast:-6820414278857408689L,Amount:-0.030166473586416633d,Operation:1,Name:"Random spawn bonus"}],Name:"generic.followRange"}]
+-FallFlying: 0b
+-LeftHanded: 0b
+-ForcedAge: 0
+-AbsorptionAmount: 0.0f
+-HandItems: [0:{},1:{}]
+-ArmorDropChances: [0:0.085f,1:0.085f,2:0.085f,3:0.085f]
+-OwnerUUID: ""
+-InLove: 0
+-DeathTime: 0s
+-ArmorItems: [0:{},1:{},2:{},3:{}]
+-CanPickUpLoot: 0b
+-HandDropChances: [0:0.085f,1:0.085f]
+-PersistenceRequired: 0b
+-HurtTime: 0s
+-Age: 0
+[/CODE]
+[/SPOILER]
+
+[SPOILER="Locking Chests"]
+[CODE]                NBTTileEntity tent = new NBTTileEntity(b.getState());
+                tent.setString("Lock", "test");[/CODE]
+[/SPOILER]
+
+[B]More Infos:[/B]
+[LIST]
+[*][URL]https://www.spigotmc.org/threads/override-base-item-attribute-value.236434/#post-2387235[/URL]
+[/LIST]
+
+[B]This API can't be used for:[/B]
+[LIST]
+[*][I][SIZE=4][S]Adding custom tags to TileEntities/Entities[/S] [/SIZE][/I][SIZE=4]Not true anymore, check the NBTInjector examples above[/SIZE]
+[/LIST]
+Git: [URL='https://github.com/tr7zw/Item-NBT-API']Github[/URL]
+Maven Repo: [URL='https://repo.codemc.org/#browse/browse:maven-public:de%2Ftr7zw%2Fitem-nbt-api-plugin']CodeMC[/URL]
+Jenkins: [URL='https://ci.codemc.org/job/Tr7zw/job/Item-NBT-API/']Jenkins[/URL]
+Discord server for help: [URL='https://discord.gg/yk4caxM']Discord[/URL]
+Feel free to create forks for your need! (Send me a message on [S]Spigot[/S] the Discord server if you want stuff to be added/need help)
+Yes you are allowed to integrate the API into your plugin(remember to shade)! (Send me a link to your project so I can check it out ;))
+
+[B][SIZE=5]Projects using the API(That I know of)[/SIZE]
+[U][SIZE=4]Plugins[/SIZE][/U][/B]
+[URL='https://www.spigotmc.org/resources/crazy-enchantments.16470/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=16470&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/backpacks.45622/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=45622&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/gravy.45288/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=45288&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/interactivebooks.45604/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=45604&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/vouchers.13654/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=13654&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/itemcommands.49543/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=49543&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/comparable-hoppers-2.45058/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=45058&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/nottooexpensive.62680/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=62680&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/papermoney.70361/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=70361&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/blockstackerx-plugin-for-askyblock.71514/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=71514&[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/blockstackerx-recoded.73749/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=73749[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/63020/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=63020&reload[/IMG][/URL]
+[URL='https://www.spigotmc.org/resources/72810/'][IMG]https://tr7zw.dev/nbtapi/linkedProjects.php?id=72810&reload[/IMG][/URL]
+[U][B]Server/Networks[/B][/U]
+[URL='http://Timolia.de'][IMG]http://status.mclive.eu/Timolia.de/timolia.de/25565/banner.png[/IMG][/URL]
+[U][B]Other[/B][/U]
+- [URL='https://github.com/LogisticsCraft/Logistics-API']Logistics-API[/URL]
+
+If you like this Resource, donate me a Coffee or become a Patreon for cool perks! [URL='https://tr7zw.dev/donate/']Donating[/URL]
+[SIZE=4][SIZE=4][U][B]Donators[/B][/U]
+[U][B][URL='https://www.spigotmc.org/members/mrdienns.35704/'][IMG]https://tr7zw.dev/nbtapi/spigotPeople.php?id=35704[/IMG][/URL] [/B][/U]
+[U][B][URL='https://www.spigotmc.org/members/mraxetv.27720/'][IMG]https://tr7zw.dev/nbtapi/spigotPeople.php?id=27720[/IMG][/URL] [/B][/U]
+[URL='https://www.spigotmc.org/members/lonedev.88296/'][IMG]https://tr7zw.dev/nbtapi/spigotPeople.php?id=88296[/IMG][/URL] 
+[URL='https://www.spigotmc.org/members/gc.25090/'][IMG]https://tr7zw.dev/nbtapi/spigotPeople.php?id=25090[/IMG][/URL]
+[URL='https://www.spigotmc.org/members/peaches_mlg100.194338/'][IMG]https://tr7zw.dev/nbtapi/spigotPeople.php?id=194338[/IMG][/URL][/SIZE][/SIZE]
+[IMG]https://bstats.org/signatures/bukkit/ItemNBTAPI.svg[/IMG]