Aethro Wiki

User Tools

Site Tools

Trace: • vanity_tag_system
vanity_tag_system

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
vanity_tag_system [2025/08/13 21:52] – [Store Integration (Buycraft/TEBEX or similar)] paulvanity_tag_system [2025/08/14 14:37] (current) – [Requirements] paul
Line 1: Line 1:
 ===== AethroTags – Install & Run Guide ===== ===== AethroTags – Install & Run Guide =====
 Version: 1.0.0 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. 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 ==== ==== Requirements ====
 Minecraft server with LuckPerms installed (mod or plugin). Minecraft server with LuckPerms installed (mod or plugin).
 +
 A chat formatter that respects LuckPerms user prefixes (EssentialsX Chat, VentureChat, TAB, ChatControl, etc.). A chat formatter that respects LuckPerms user prefixes (EssentialsX Chat, VentureChat, TAB, ChatControl, etc.).
-Java 17+ (for modern MC).+ 
 +Java 17+ (for modern MC). Java 21+ (for Paper 1.21)
 ==== Installation (Server) ==== ==== Installation (Server) ====
 Drop AethroTags.jar into your server’s mods/ (or loaders folder). Drop AethroTags.jar into your server’s mods/ (or loaders folder).
Line 94: Line 97:
 ==== Store Integration (Buycraft/TEBEX or similar) ==== ==== Store Integration (Buycraft/TEBEX or similar) ====
 Sell a tag by executing two commands on purchase: Sell a tag by executing two commands on purchase:
 +
 <code> <code>
 lp user {name} parent add tag.owner lp user {name} parent add tag.owner
  
 </code> </code>
 +
 No need to touch chat configs; AethroTags handles the user prefix. No need to touch chat configs; AethroTags handles the user prefix.
 ==== Troubleshooting ==== ==== Troubleshooting ====
 “/vanity set says I don’t own that tag” “/vanity set says I don’t own that tag”
 +
 You don’t have the LP group. Grant it: You don’t have the LP group. Grant it:
 <code>/lp user <player> parent add tag.<key></code> <code>/lp user <player> parent add tag.<key></code>
 +
 Also make sure the key exists in aethro-tags.cfg. Also make sure the key exists in aethro-tags.cfg.
 +
 +
 “Tag shows in list but colors don’t appear in chat” “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. 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” “/vanity issue says unknown tag”
 Add the tag key to config/aethro-tags.cfg and **/vanity reload**. Add the tag key to config/aethro-tags.cfg and **/vanity reload**.
 +
 +
 “Distributor can’t issue a tag” “Distributor can’t issue a tag”
 Ensure the tag group has group meta owner.username=<theirname> (exact, lower/upper doesn’t matter). 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” “After adding new tags, tab-complete doesn’t show them”
 Run **/vanity reload**. Run **/vanity reload**.
 ==== FAQ ==== ==== FAQ ====
 Does AethroTags remove other tags when issuing or setting? Does AethroTags remove other tags when issuing or setting?
 +
 No. Issuing only adds ownership. Setting only changes your active prefix + user meta. No. Issuing only adds ownership. Setting only changes your active prefix + user meta.
 +
 +
 Do I have to name groups tag.<key>? Do I have to name groups tag.<key>?
 Recommended, but bare group names work if they exist. The plugin checks both. Recommended, but bare group names work if they exist. The plugin checks both.
 +
 +
 Can I migrate existing tags from another system? 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. Yes. Create the LP groups, add players to them, and mirror your display strings in aethro-tags.cfg.
vanity_tag_system.1755121956.txt.gz · Last modified: by paul

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki