RoodyDonations v1.0.0 is outSee what’s new →
RoodyTags
v1.0.0 Paper 1.20.4+ Free
Guides · 4 / 15

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.