Aethro Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== AethroTags – Install & Run Guide =====
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.
==== Requirements ====
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).
==== Installation (Server) ====
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.
==== Config: config/aethro-tags.cfg ====
One tag per line:
key=&colorCodes[DisplayName]&r
<code> # key=&colorCode[DisplayName]&r 
owner=&6[Owner]&r 
family=&d&o[Family]&r 
beastmaster=&2[Beast Master]&r </code>

Notes
Use & codes; AethroTags converts them to § automatically.
The key is what players type: /vanity set owner.
==== LuckPerms Setup ====
Create tag groups (recommended: use tag.<key> naming):
<code>
/lp creategroup tag.owner
/lp creategroup tag.family
/lp creategroup tag.beastmaster
</code>
Give a player ownership (purchaser) rights by adding the group:
<code>
/lp user <player> parent add tag.owner
</code>
Allow a player distributor (non‑staff) to issue a specific tag by putting group meta on the tag group:
<code>
/lp group tag.owner meta set owner.username <playername>
</code>
Staff override for issuing any tag:
<code>
/lp user <staff> permission set vanity.issue.any true
</code>
==== Commands ====
^ Command ^ Who ^ What it does ^
| **/vanity list** [player] | Anyone (self) / vanity.issue.any (others) | Lists your tags (one per line). Active tag is marked with *. |
| **/vanity set** <tag> | Player | Equips a tag you own. Updates your user prefix immediately based on the config. |
| **/vanity issue** <player> <tag> | vanity.issue.any or tag owner.username distributor | Gives a tag to someone. Never removes any other tags. |
| **/vanity reload** | OP / vanity.reload | Reloads aethro-tags.cfg and refreshes LP groups. |
Tab‑completion
/vanity issue <tag> → all tags from the config.
/vanity set <tag> → only tags you own (and are in the config).
==== Permissions ====
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.
==== How Chat Prefix Updating Works ====
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.
==== Quick Start (Examples) ====
Define tags in config:
<code>
owner=&6[Owner]&r
family=&d&o[Family]&r
</code>
Create LP groups + grant tags:
<code>
/lp creategroup tag.owner
/lp creategroup tag.family
/lp user Alice parent add tag.owner
/lp user Alice parent add tag.family
</code>
Player equips:
<code>
/vanity set owner
</code>
Distributor setup (let Bob issue owner):
<code>
/lp group tag.owner meta set owner.username Bob
</code>
Now Bob can:
<code>
/vanity issue Charlie owner
</code>
Staff override:
<code>
/lp user Admin permission set vanity.issue.any true
/vanity issue Dave family
</code>
==== Store Integration (Buycraft/TEBEX or similar) ====
Sell a tag by executing two commands on purchase:

<code>
lp user {name} parent add tag.owner

</code>

No need to touch chat configs; AethroTags handles the user prefix.
==== Troubleshooting ====
“/vanity set says I don’t own that tag”

You don’t have the LP group. Grant it:
<code>/lp user <player> parent add tag.<key></code>

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**.
==== FAQ ====
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.
Aethro Wiki

User Tools

Site Tools

Page Tools
