BetterTags+ | Tag System & Menu v1.0

BetterTags+ | Advanced Tags & Interactive Menu for Hytale

Give your server a premium tag system with a fully interactive UI, gradient support, clean chat formatting, admin control tools, and persistent player data.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FEATURES

Interactive Tags Menu
• Modern full custom UI menu (/tag, /tags)
• Smooth hover states on cards and buttons
• Page navigation with Previous/Next controls
• Visual selected state + click again to deselect
• Rounded framed design with custom assets included

Advanced Tag Styling
• Supports classic color codes (&a, &6, etc.)
• Supports HEX and gradient formats (<gradient:#AABBCC:#DDEEFF>)
• Colored/gradient preview shown directly in the menu
• Tag display and order fully editable in tags.yml

Default Tag Pack Included (48)
• [LORD], [ELITE], [ROYAL], [LEGEND], [TITAN], [ALPHA], [OMEGA], [SUPREME]
• [REKT], [CLUTCH], [SWEAT], [TRYHARD], [KILLER], [BEAST], [HUNTER], [DOMINATOR]
• [GOD], [DEMON], [SAVAGE], [MAD], [SHADOW], [VENOM], [BLAZE], [VOID]
• [KNIGHT], [KING], [QUEEN], [WIZARD], [DRAGON], [PHANTOM], [RUNE], [TEMPLAR]
• [VIBE], [FLEX], [WAVE], [NOVA], [GHOST], [NEON], [LUX], [PRIME]
• [IMMORTAL], [CELESTIAL], [INFERNO], [OBSIDIAN], [ECLIPSE], [TEMPEST], [VORTEX], [ABYSS]

Smart Data Behavior
• Default tags are generated only on first startup
• If you edit/remove tags in tags.yml, your custom setup is preserved
• Persistent player data in players.yml (selected + unlocked tags)

Chat Integration
• Built-in chat formatting with placeholders:
%tag%, %tag_id%, %player%, %message%
• Configurable chat format and empty-tag behavior
• Optional auto-space after tag

Permission & Unlock System
• Optional per-tag permission requirement
• Optional unlock-based progression (require-unlock)
• Default unlocked tags configurable
• Full admin management commands

Placeholder Integrations
• WiFlow PlaceholderAPI support (auto-detect)
• HelpChat/CreeperFace PlaceholderAPI support (auto-detect)
• Registered identifiers: bettertags, tag, tags
• Placeholder keys:
tag, tag_display, prefix, tag_raw, tag_text, tag_id, selected_tag_id, selected_tag, selected_tag_raw, name_with_tag, has_tag_<id>

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

COMMANDS

Player:
• /tag - Open tags menu
• /tags - Alias of /tag
• /tag help
• /tag list
• /tag select <id>
• /tag clear
• /tag menu / /tag gui

Admin:
• /tag create <id> <display...>
• /tag delete <id>
• /tag setdisplay <id> <display...>
• /tag setpermission <id> <perm|none>
• /tag toggle <id>
• /tag setorder <id> <number>
• /tag give <player> <id>
• /tag take <player> <id>
• /tag set <player> <id|none>
• /tag reload

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PERMISSIONS
• bettertags.use - Access player commands/menu
• bettertags.admin - Access admin commands
• bettertags.* - Global wildcard support
• Per-tag permission: each tag can require its own permission node via tags.yml (permission:) or /tag setpermission <id> <perm|none>

Example:
• /tag setpermission lord bettertags.tag.lord
• Then grant bettertags.tag.lord to the group/player you want.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FILES
• config.yml - Main settings
• language.yml - Fully editable messages
• tags.yml - Tag definitions (display, permission, enabled, order)
• players.yml - Player selected/unlocked data

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

WHAT’S INCLUDED
• BetterTags main plugin jar
• Built-in custom UI assets (no external asset pack needed)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SUPPORT
Need setup help?
Discord: https://discord.gg/FbdFH86yVV