Aethro Wiki

Version: 1.0.0 What it is: A clean, LuckPerms‑powered vanity chat tag system. Define tags + colors in one config, give players tags via commands, let them equip what they own. Instant chat prefix swap. No nonsense.

Minecraft server with LuckPerms installed (mod or plugin). A chat formatter that respects LuckPerms user prefixes (EssentialsX Chat, VentureChat, TAB, ChatControl, etc.). Java 17+ (for modern MC).

Drop AethroTags.jar into your server’s mods/ (or loaders folder). Start the server once. It generates: config/aethro-tags.cfg Edit the config to define your tags (see below). Restart or run /vanity reload. That’s it. Done.

One tag per line: key=&colorCodes[DisplayName]&r

 # key=&colorCode[DisplayName]&r 
owner=&6[Owner]&r 
family=&d&o[Family]&r 
beastmaster=&2[Beast Master]&r 

Notes Use & codes; AethroTags converts them to § automatically. The key is what players type: /vanity set owner.

Create tag groups (recommended: use tag.<key> naming):

/lp creategroup tag.owner
/lp creategroup tag.family
/lp creategroup tag.beastmaster

Give a player ownership (purchaser) rights by adding the group:

/lp user <player> parent add tag.owner

Allow a player distributor (non‑staff) to issue a specific tag by putting group meta on the tag group:

/lp group tag.owner meta set owner.username <playername>

Staff override for issuing any tag:

/lp user <staff> permission set vanity.issue.any true

Tab‑completion /vanity issue <tag> → all tags from the config. /vanity set <tag> → only tags you own (and are in the config).

vanity.issue.any — issue any tag to anyone. vanity.reload — run /vanity reload. Distributor logic (no node needed): if the tag group has meta owner.username=<player>, that player can issue that specific tag.

When a player runs /vanity set <tag>: AethroTags writes user meta: vanity.active=<tag>. AethroTags also sets the player’s LuckPerms user prefix to the color string from the config, with a high priority so it wins. Result: their chat prefix flips immediately (no relog). Your chat plugin must read user prefixes from LuckPerms. Most do out of the box.

Define tags in config:

owner=&6[Owner]&r
family=&d&o[Family]&r

Create LP groups + grant tags:

/lp creategroup tag.owner
/lp creategroup tag.family
/lp user Alice parent add tag.owner
/lp user Alice parent add tag.family

Player equips:

/vanity set owner

Distributor setup (let Bob issue owner):

/lp group tag.owner meta set owner.username Bob

Now Bob can:

/vanity issue Charlie owner

Staff override:

/lp user Admin permission set vanity.issue.any true
/vanity issue Dave family

Sell a tag by executing two commands on purchase:

lp user {name} parent add tag.owner

No need to touch chat configs; AethroTags handles the user prefix.

“/vanity set says I don’t own that tag”

You don’t have the LP group. Grant it:

/lp user <player> parent add tag.<key>

Also make sure the key exists in aethro-tags.cfg.

“Tag shows in list but colors don’t appear in chat” Your chat plugin isn’t reading LuckPerms user prefixes. Enable that or disable conflicting prefix sources. AethroTags sets the user prefix directly.

“/vanity issue says unknown tag” Add the tag key to config/aethro-tags.cfg and /vanity reload.

“Distributor can’t issue a tag” Ensure the tag group has group meta owner.username=<theirname> (exact, lower/upper doesn’t matter).

“After adding new tags, tab-complete doesn’t show them” Run /vanity reload.

Does AethroTags remove other tags when issuing or setting?

No. Issuing only adds ownership. Setting only changes your active prefix + user meta.

Do I have to name groups tag.<key>? Recommended, but bare group names work if they exist. The plugin checks both.

Can I migrate existing tags from another system? Yes. Create the LP groups, add players to them, and mirror your display strings in aethro-tags.cfg.