Tags
Tags live in tags/*.yml: every file in the folder is read, so you can keep packs separate. The options are explained at the top of tags/default.yml.
defaults:
small-caps: true
tags:
legend:
text: {en: Legend, es: Leyenda}
display: "★ {text}"
animation: {type: shine, colors: ["#FFB703", "#FFF8DC"], bold: true}
description: {en: "For the very best.", es: "Para los mejores."}
category: legends
rarity: legendary
price: 60000
| Option | What it does |
|---|---|
display |
The look: & codes, &#RRGGBB or MiniMessage (<gradient:...>). {text} is replaced by text. |
text |
One text, or one per language. The chat, the nametag and placeholders use the server's language. |
small-caps |
Writes the text ꜱᴍᴀʟʟ ᴄᴀᴘꜱ. |
animation |
See below. |
name, description |
For the menus; a text, a list or one per language. |
icon |
auto (the rarity's), a material or head:<base64 texture>. Also glow, custom-model-data, item-model. |
category, rarity |
From categories.yml. |
permission |
Empty: roodytags.tag.<id>. none: no permission needed. Or any node. |
price, currency, rental |
0 = not for sale. default, vault, levels or points. How long a purchase lasts, like 30d. |
requirements |
A list, see below. |
available |
from and to: "2026-12-24" once, or "12-24" every year. |
hidden, order, enabled |
Not shown until owned; position in the menus; on or off. |
sound, on-equip, on-unequip |
Instead of the rarity's sound; lines run when it is put on or taken off. |
Command lines (on-equip, category rewards, milestones): [console] (the default), [player], [message], [broadcast], [sound]. With {player}, {tag} and {id}.
A tag with permission: none, no price and no requirements is free for everyone.
Animations
animation.type:
| Type | What it does |
|---|---|
rainbow |
Rainbow colours moving along the text |
wave |
The colors travelling along the text |
pulse |
The whole text fading between the colors |
shine |
The first colour with a band of the second sweeping across |
typing |
The letters appear one by one |
glitch |
The colors with letters that flicker |
frames |
Your own frames, a list of texts |
Also speed (1.0 is normal) and bold. tags.frame-ticks is the base speed of all of them.
Categories and rarities
categories.yml holds both. A category has name, description, icon, color, order, permission (only those players see it) and reward (commands given once, on owning every tag of the category). A rarity has name, color, order, icon, sound and particle.
collection.milestones in config.yml gives rewards for reaching a number of tags.