Supported Minecraft Versions:

• 1.9, 1.10, 1.11

TagAPI​

Description

TagAPI gives you easy access to Mojang's scoreboard tag system which was introduced in 1.9. These tags allow you to permanently store up to 1024 text tags on an entity. Tags, like metadata from Skellett or RandomSk, are unique to an entity and can be checked or remove at any later point, but as they are stored directly in the entity's NBT, they are permanent and will persist through server restarts, chunk reloading, etc. -- all without using Skript variables.


Requirements

• Minecraft 1.9 or above (this is when scoreboard tags were added)
• SkStuff

Usage

The following basic functions are made available to you by TagAPI:

Spoiler: Basic Usage

Code (Skript):

1. # Adds a tag ("tag") to an entity ("entityToTag").
2. addTag(entityToTag, tag)
3.  
4. # Removes a tag ("tag") from an entity ("entityToUntag").
5. removeTag(entityToUntag, tag)
6.  
7. # Gets a list of all tags on an entity ("entityToCheck").
8. # This is returned as a Skript list of texts.
9. getTags(entityToCheck)
10.  
11. # Returns true if "entityToCheck" has the tag "tag", or false if not
12. hasTag(entityToCheck, tag)

These are the only features that directly use vanilla tag functionality. However, in my testing I found I often wanted to be able to use tags more like variables by having a key or "variable name" of sorts to reference tags by. So, I created the concept of key-value tags, which aid in getting and setting tags with a key=value setup, essentially allowing you to treat the tag as a variable named 'key' with a value of 'value'.

Spoiler: Key-Value Tags

Code (Skript):

1. # Returns true if the entity has a key-value tag with the given key
2. # This essentially is like checking if a variable named 'key' exists
3. hasKeyValueTag(entityToCheck, key)
4.  
5. # Stores a tag on "entityToTag" as "key=value"
6. # This literally maps directly to addTag(entityToTag, "key=value"), but it
7. # feels better to use a keyValueTag function when working with them
8. setKeyValueTag(entityToTag, key, value)
9.  
10. # Returns the value associated with the tag with key "key", e.g.:
11. # setKeyValueTag(player's target, "Owner", "%player%")
12. # getKeyValueTag(player's target, "Owner")
13. # Would return the "%player%" value set by setKeyValueTag
14. getKeyValueTag(entityToCheck, key)
15.  
16. # Removes the key-value tag with key "key" from "entityToUntag"
17. removeKeyValueTag(entityToUntag, key)

Reviews