WHSTags — Tag system with multi-server sync · Java & Bedrock
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overview
WHSTags is a visual tag system built for Minecraft networks with multiple game modes. Players browse and equip custom tags from a fully configurable in-game GUI — and those tags sync automatically across every server in your network through a shared MySQL database. One system, every mode covered.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Features
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OverviewWHSTags is a visual tag system built for Minecraft networks with multiple game modes. Players browse and equip custom tags from a fully configurable in-game GUI — and those tags sync automatically across every server in your network through a shared MySQL database. One system, every mode covered.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Features
- Tags with full MiniMessage, HEX and legacy & color support
- Fully configurable GUI — categories, pagination, custom items, slots and lore
- "My Tags" category — automatically shows only the tags each player has unlocked
- Tag saved per player, per game mode — different tag on each server, independently
- Per-tag permission nodes — tie tags to ranks, store purchases, or events via LuckPerms
- PlaceholderAPI integration — display tags in chat, TAB, holograms and more
- Player heads and banner items supported in any menu slot
- Hot-reload — config, language and tags refresh without restarting
- All admin commands executable from server console
- Multilingual — English, Spanish, French, German and Portuguese included out of the box
- Native Bedrock support via Geyser + Floodgate — zero extra config
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Multi-server SyncWHSTags runs on a Lobby / Client architecture:
- The Lobby creates and manages all tags, storing them in MySQL
- Client servers read from the database and load each player's active tag on join
- GUI menus can be uploaded from the lobby and downloaded by clients with a single command — no manual file transfers needed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GUI & CustomizationEverything is defined in config files — categories, items, slots, lore, enchants, player heads, and banner patterns. Each tag can override its display item individually. A gui-layout: hub mode lets you build a hub menu that organizes game modes with their own tag categories, all without duplicating files.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PlaceholderAPI%whstags_tag% → Tag display with colors
%whstags_tag_plain% → Tag display without colors
%whstags_tag_id% → Internal tag ID
%whstags_has_tag% → true / false
Compatible with EssentialsX, CMI, TAB, DecentHolograms, and any PAPI-supported plugin.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
IntegrationsPlaceholderAPI
LuckPerms
Geyser / Floodgate
MySQL
Required━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CompatibilityPaper / Spigot · 1.20 – 1.21.x · Java 21
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DocumentationFull setup, config reference, command list, permission nodes and GUI guide:
https://whstags-doc.web.app/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
