   
\n<\/p>\n
## \u2b50**For server owners**<\/p>\n
### **Downloading**
\nClick on download button and select rtag .jar file to download, then put it on plugins folder.<\/p>\n
### **Requirements**<\/p>\n
* At least Minecraft 1.8.8, lower versions may be not compatible.
\n* Minimum Java 11, update your Java version, old MC versions works fine on Java 11.<\/p>\n
### **Compatibility**
\n\u2705 Bukkit<\/p>\n
\u2705 Spigot<\/p>\n
\u2705 Paper<\/p>\n
\u2705 Paper with Mojang Mappings<\/p>\n
\u2705 Folia<\/p>\n
\u2705 Any of above without craftbukkit relocation (see PaperMC announce)<\/p>\n
## \u2693**For developers**<\/p>\n
### \u23e9**What is Rtag?**
\nRtag provides an easy way to edit NBT tags without NMS and avoiding bad performance impact on big servers.
\nSo it’s **completely shadeable**, you can implement rtag directly in your plugin.
\nFor detailed information about Rtag, visit the wiki page.<\/p>\n
Rtag convert any Java object into NBT tag and viceversa:<\/p>\n
“`java
\n\/\/ Using Item
\nRtagItem tag = new RtagItem(item);
\n\/\/ Using Entity
\nRtagEntity tag = new RtagEntity(entity);
\n\/\/ Using block
\nRtagBlock tag = new RtagBlock(block);<\/p>\n
\/\/ — Put values
\n\/\/ Set the value “Custom Text” at “display.Name” path
\ntag.set(“Custom Text”, “display”, “Name”);
\n\/\/ Or set an integer at “someKey” path
\ntag.set(40, “someKey”);
\n\/\/ Including compatibility with any type of object like MyObject
\nMyObject myobject = new MyObject();
\ntag.set(myobject, “any”, “path”);<\/p>\n
\/\/ So you can add lists
\ntag.set(new ArrayList(), “list”, “path”);
\n\/\/ And add values into list
\ntag.add((short) 3, “list”, “path”);
\n\/\/ Or replace the values of existing list
\ntag.set((short) 5, “list”, “path”, 0); \/\/ index 0<\/p>\n
\/\/ — Get values
\n\/\/ Value from path “display” -> “Name”
\nString name = tag.get(“display”, “Name”);
\n\/\/ Safe value get from path “someKey”, or -1 by default
\nint intValue = tag.getOptional(“someKey”).or(-1);
\nint sameValue = tag.getOptional(“someKey”).asInt(-1); \/\/ This method try to convert any type to int
\n\/\/ Explicit value get for custom objects
\nMyObject sameobject = tag.getOptional(“any”, “path”).as(MyObject.class);
\n\/\/ Merge values into tag
\ntag.merge(Map.of(“asd”, 123, “someKey”, 41), true);<\/p>\n
\/\/ Get lists \/\/ Get the entire object tag as Map of Java objects \/\/ — Load changes into object \/\/ — Update current tag if the original object was edited ### \u23e9**Get Rtag** “`groovy dependencies { For Gradle Kotlin project:<\/p>\n “`kt dependencies { For Maven project:<\/p>\n “`xml ## \u2b50**Features** ### 1\ufe0f\u20e3**Easy to understand** The main RtagEditor instances have methods to make tag editing easier. RtagEntity tag = new RtagEntity(entity); RtagBlock tag = new RtagBlock(block); You can edit objects using functions inside RtagEditor instances and return any type of object. ### 2\ufe0f\u20e3**Edit data components! (Experimental)** With RtagItem you can edit components in a simple way as normal Java objects. if (tag.hasComponent(“minecraft:custom_model_data”)) { Object component = tag.getComponent(“minecraft:custom_model_data”); ### 3\ufe0f\u20e3**Store custom objects** rtag.set(compound, myObject, “CustomTagPath”); So you can register (de)serializers in Rtag instance to set and get custom objects with automatic conversion. “`java public MyObjectSerializer(Rtag rtag) { \/\/ MyObject -> Map \/\/ Map -> MyObject @Override @Override Then you can get your custom object without explicit conversion. rtag.set(compound, myObject, “CustomTagPath”); ### 4\ufe0f\u20e3**TagStream instances** String string = tag.toBase64(item); ### 5\ufe0f\u20e3**Textured heads** ### 6\ufe0f\u20e3**Chat Component** \/\/ From component \/\/ Cross-compatibility ### \u2728**Pretty NBT** Format any nbt object into single or multiple lines using default, hex or minimessage color palette. Or use your custom color palette. The “readable tag” Bukkit library, an easy way to handle block, entity, item NBT and data components<\/p>\n","protected":false},"featured_media":134530,"template":"","meta":{"_minecraft_slug":"rtag","_minecraft_project_id":"g7Wa9ba0","_minecraft_author":"Rubenicos","_minecraft_license":"MIT","_minecraft_downloads":1927,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"rtag.zip","_minecraft_size_bytes":5596994,"_minecraft_version_count":21,"_minecraft_updated_at":"2026-05-16T06:28:22.681443Z","_minecraft_date_created":"2023-08-21T06:15:27.498416Z","_minecraft_date_modified":"2026-04-19T17:07:42.221872Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/rtag","_minecraft_icon_attachment_id":134530,"_minecraft_imported_at":"2026-06-07T22:37:40+00:00","_minecraft_import_hash":"742a109391ea5a2ef98029b7eef351d5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,873,127,128,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,30,31,860,861,862,863,864,83,167,163],"class_list":["post-134529","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-library","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nList
\n\/\/ Get list value from index
\nshort listValue = tag.get(“list”, “path”, 0); \/\/ index 0<\/p>\n
\nMap
\n\/\/ Load changes into original object
\ntag.load();
\n\/\/ RtagItem as the option to create an item copy with changes loaded
\nItemStack itemCopy = tag.loadCopy();<\/p>\n
\ntag.update();
\n“`<\/p>\n
\nFor Gradle Groovy project:<\/p>\nbuild.gradle<\/summary>\n
\nrepositories {
\n maven { url ‘https:\/\/jitpack.io’ }
\n}<\/p>\n
\n compileOnly ‘com.saicone.rtag:rtag:VERSION’
\n \/\/ Other modules
\n compileOnly ‘com.saicone.rtag:rtag-block:VERSION’
\n compileOnly ‘com.saicone.rtag:rtag-entity:VERSION’
\n compileOnly ‘com.saicone.rtag:rtag-item:VERSION’
\n}
\n“`<\/p>\n<\/details>\nbuild.gradle.kts<\/summary>\n
\nrepositories {
\n maven(“https:\/\/jitpack.io”)
\n}<\/p>\n
\n compileOnly(“com.saicone.rtag:rtag:VERSION”)
\n \/\/ Other modules
\n compileOnly(“com.saicone.rtag:rtag-block:VERSION”)
\n compileOnly(“com.saicone.rtag:rtag-entity:VERSION”)
\n compileOnly(“com.saicone.rtag:rtag-item:VERSION”)
\n}
\n“`<\/p>\n<\/details>\npom.xml<\/summary>\n
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories><\/p>\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n
\n
\n
\n
\n
\n <\/dependency>
\n
\n
\n
\n
\n
\n <\/dependency>
\n<\/dependencies>
\n“`<\/p>\n<\/details>\n
\nThere are other libraries to edit NBT tags, why should Rtag be used over the others?<\/p>\n
\nYou don’t need to be an expert with NBT tags, just with simple methods you can set and get normal Java objects.
\n“`java
\nRtag rtag = new Rtag();
\nrtag.set(compound, “Normal string”, “CustomTagPath”);
\nString string = rtag.get(compound, “CustomTagPath”);
\n“`<\/p>\n
\n“`java
\nRtagItem tag = new RtagItem(item);
\ntag.setUnbreakable(true);
\ntag.setRepairCost(20);
\nint level = tag.getEnchantmentLevel(“unbreaking”); \/\/ Enchantment enum, name or id<\/p>\n
\ntag.setAttributeBase(“generic.attackDamage”, 0.5);<\/p>\n
\ntag.setCustomName(“\u00a7eColored name”);
\n“`<\/p>\n
\n“`java
\nItemStack item = …;
\n\/\/ Edit original
\nRtagItem.edit(item, tag -> {
\n tag.set(“Custom Text”, “display”, “name”);
\n tag.set(30, “someKey”);
\n});
\n\/\/ Return a copy
\nItemStack copy = RtagItem.edit(item, tag -> {
\n tag.set(30, “someKey”);
\n return tag.loadCopy();
\n});
\n“`<\/p>\n
\nSince Minecraft 1.20.5, items use components to save vanilla data.<\/p>\n
\n“`java
\nRtagItem tag = new RtagItem(item);<\/p>\n
\n tag.removeComponent(“minecraft:custom_model_data”);
\n} else {
\n tag.setComponent(“minecraft:custom_model_data”, 40);
\n}<\/p>\n
\nInteger number = ComponentType.encodeJava(“minecraft:custom_model_data”, component).orElse(null);
\n“`<\/p>\n
\nBy default, Rtag uses the Gson library inside Bukkit to (de)serialize custom objects, but you need to get them using explicit conversion.
\n“`java
\nRtag rtag = new Rtag();
\nMyObject myObject = new MyObject();<\/p>\n
\nMyObject sameObject = rtag.getOptional(compound, “CustomTagPath”).as(MyObject.class);
\n“`<\/p>\n
\nThis conversion put an additional key into your saved tag to detect it using the provided ID.<\/p>\nexample<\/summary>\n
\npublic class MyObjectSerializer implements RtagSerializer
\n rtag.putSerializer(MyObject.class, this);
\n rtag.putDeserializer(this);
\n }<\/p>\n
\n @Override
\n public String getInID() {
\n \/\/ It’s suggested to use a unique namespaced key
\n return “myplugin:MyObject”;
\n }<\/p>\n
\n @Override
\n public String getOutID() {
\n return “myplugin:MyObject”;
\n }<\/p>\n
\n public Map
\n \/\/ Convert your custom object into map
\n }<\/p>\n
\n public MyObject deserialize(Map
\n \/\/ Convert compound into you custom object
\n }
\n}
\n“`<\/p>\n<\/details>\n
\n“`java
\nRtag rtag = new Rtag();
\nnew MyObjectSerializer(rtag);
\nMyObject myObject = new MyObject();<\/p>\n
\nMyObject sameObject = rtag.get(compound, “CustomTagPath”);
\n“`<\/p>\n
\nWith ItemTagStream instance you can convert items into Base64|File|Bytes|Map|String and viceversa.
\nIncluding **cross-version support**! Save an item on any version and get on any version without compatibility problems. Materials, enchantments, potions… etc, all will be converted!
\n“`java
\nItemTagStream tag = ItemTagStream.INSTANCE;<\/p>\n
\nItemStack sameItem = tag.fromBase64(string)[0];
\n“`<\/p>\n
\nWith SkullTexture class you can get textured heads from base64, url, texture ID, player name or uuid.
\n“`java
\n\/\/ Base64
\nItemStack head = SkullTexture.getTexturedHead(“eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmVkZmEyZTBmZGVhMGMwNDIzODA0Y2RiNWI2MmFkMDVhNmU5MTRjMDQ2YzRhM2I3ZTM1NWJmODEyNjkxMjVmZCJ9fQ==”);
\n\/\/ URL
\nItemStack head = SkullTexture.getTexturedHead(“http:\/\/textures.minecraft.net\/texture\/fedfa2e0fdea0c0423804cdb5b62ad05a6e914c046c4a3b7e355bf81269125fd”);
\n\/\/ Texture ID
\nItemStack head = SkullTexture.getTexturedHead(“fedfa2e0fdea0c0423804cdb5b62ad05a6e914c046c4a3b7e355bf81269125fd”);
\n\/\/ Player name
\nItemStack head = SkullTexture.getTexturedHead(“Rubenicos”);
\n\/\/ Player UUID
\nItemStack head = SkullTexture.getTexturedHead(“7ca003dc-175f-4f1f-b490-5651045311ad”);
\n“`<\/p>\n
\nWith ChatComponent class you can convert (json) strings into chat components and viceversa.
\n“`java
\n\/\/ To component
\nObject component = ChatComponent.fromJson(“{“bold”:true,”italic”:false,”color”:”dark_purple”,”text”:”Colored text!”}”);
\nObject sameComponent = ChatComponent.fromString(“\u00a75\u00a7lColored text!”);<\/p>\n
\nString json = ChatComponent.toJson(component);
\nString string = ChatComponent.toString(component);<\/p>\n
\nString json = ChatComponent.toJson(“\u00a75\u00a7lColored text!”);
\nString string = ChatComponent.toString(“{“bold”:true,”italic”:false,”color”:”dark_purple”,”text”:”Colored text!”}”);
\n“`<\/p>\n
\nFor more information, visit the wiki page.<\/p>\n
\n<\/p>\n
\n<\/p>\n","protected":false},"excerpt":{"rendered":"