Rtag

[](https://saic.one/discord) [!(https://img.shields.io/codefactor/grade/github/saicone/rtag?style=flat-square&logo=codefactor&logoColor=white&label=codefactor&color=00b16a )](https://www.codefactor.io/repository/github/saicone/rtag) [!(https://app.codacy.com/project/badge/Grade/8357004e11cb4dca884e05dbfb440c66)](https://app.codacy.com/gh/saicone/rtag/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=badge_grade) [!(https://img.shields.io/github/languages/code-size/saicone/rtag?logo=github&logoColor=white)](https://github.com/saicone/rtag) [!(https://img.shields.io/maven-central/v/com.saicone/rtag?style=flat-square)](https://central.sonatype.com/artifact/com.saicone/rtag)

## ⭐For server owners

### Downloading Click on download button and select rtag .jar file to download, then put it on plugins folder.

### Requirements

At least Minecraft 1. 8. 8, lower versions may be not compatible. Minimum Java 11, update your Java version, old MC versions works fine on Java 11.

### Compatibility ✅ Bukkit

✅ Paper with Mojang Mappings

✅ Any of above without craftbukkit relocation (see (https://forums.papermc.io/threads/paper-velocity-1-20-2. 920/))

## ⚓For developers

### ⏩What is Rtag? Rtag provides an easy way to edit NBT tags without NMS and avoiding bad performance impact on big servers. So it's completely shadeable, you can implement rtag directly in your plugin. For detailed information about Rtag, visit (https://docs.saicone.com/rtag).

Rtag convert any Java object into NBT tag and viceversa:

```java // Using Item RtagItem tag = new RtagItem(item); // Using Entity RtagEntity tag = new RtagEntity(entity); // Using block RtagBlock tag = new RtagBlock(block);

// --- Put values // Set the value "Custom Text" at "display. Name" path tag.set("Custom Text", "display", "Name"); // Or set an integer at "someKey" path tag.set(40, "someKey"); // Including compatibility with any type of object like MyObject MyObject myobject = new MyObject(); tag.set(myobject, "any", "path");

// So you can add lists tag.set(new ArrayList(), "list", "path"); // And add values into list tag.add((short) 3, "list", "path"); // Or replace the values of existing list tag.set((short) 5, "list", "path", 0); // index 0

// --- Get values // Value from path "display" -> "Name" String name = tag.get("display", "Name"); // Safe value get from path "someKey", or -1 by default int intValue = tag.getOptional("someKey").or(-1); int sameValue = tag.getOptional("someKey").asInt(-1); // This method try to convert any type to int // Explicit value get for custom objects MyObject sameobject = tag.getOptional("any", "path").as(MyObject.class); // Merge values into tag tag.merge(Map.of("asd", 123, "someKey", 41), true);

// Get lists List list = tag.get("list", "path"); // Get list value from index short listValue = tag.get("list", "path", 0); // index 0

// Get the entire object tag as Map of Java objects Map map = tag.get();

// --- Load changes into object // Load changes into original object tag.load(); // RtagItem as the option to create an item copy with changes loaded ItemStack itemCopy = tag.loadCopy();

// --- Update current tag if the original object was edited tag.update(); ```

### ⏩Get Rtag For Gradle Groovy project: