Skip to content

SnowbirdTags (plugin)

Runs chat tags across the whole network: which tags a player owns, which one they show, and the /tags menu to pick one. It also handles rank badges, the chat name hover card, and custom join, leave and AFK messages.

What it does

  • Chat tags. A catalog of tags in tags.yml. Players unlock tags, then pick one to show in chat with /tags. Unlocks and the active tag are saved in a shared MariaDB, so they follow the player to every server.
  • Rank badges. Players pick which rank badge shows before their name with /ranktags. Access comes from LuckPerms. If they pick nothing, their highest badge shows.
  • Hover card. Players pick up to three lines (for example Pokedex completion) that show when someone hovers their name in chat, with /hover.
  • Custom messages. Players with permission can set their own join, leave, AFK and back-from-AFK messages with /custommessage. Each one is checked by ChatControl's chat rules first.
  • Tag shop. A safe purchase path for EconomyShopGUI buttons, charged through Vault.
  • Placeholders for the chat format, and a Java API for other plugins to grant tags.

It does not format or send chat itself. ChatControl owns chat and reads this plugin's placeholders. Placeholders read from memory only, so chat never waits on the database.

The plugin runs on every backend, all pointed at the same database. If it were only on main, tags would vanish when a player chats from another server.

How players use it

Chat tags:

/tags

Opens a menu of every tag. Owned tags can be clicked to equip or unequip. Locked tags show a gray icon and a "How to unlock" line.

Rank badges:

/ranktags            open the badge menu (only badges you have access to)
/ranktags rank2fire  pick a badge by id
/ranktags off        go back to your highest badge

/ranktag works too. The active badge glows in the menu. The bottom-center button returns to your default.

Hover card:

/hover               open the picker: click a row, then click what it shows
/hover set 1 dex     show Pokedex completion on row 1
/hover set 2 livingdex
/hover show          list what your card shows now
/hover clear 2       clear row 2
/hover clear all     clear the whole card

Two lines ship: dex (Pokedex caught percent) and livingdex (unique species you own right now in your party and PC, not counting eggs or rental teams). The "Click to message." line always sits under your choices. If a row has no value yet, the picker says so and the chat tooltip leaves it out.

Custom messages (only if you have snowbirdtags.custommessages.use):

/custommessage set join is here to catch them all!
/custommessage preview join
/custommessage status
/custommessage clear afk

Types are join, leave, afk and back. Up to 80 characters. No colors, links or IP addresses. There is a 60-second cooldown per type. Your message is checked by ChatControl's chat rules: if it passes, it goes live right away. If it breaks a rule, it is not saved, and ChatControl may warn or punish you just as if you had typed it in chat.

More pages