Installation

MistTags is a Bukkit-family plugin for temporary and permanent player prefixes/suffixes.

Requirements

• Java 17 or newer
• Bukkit, Spigot, Paper, Purpur, or Folia
• Minecraft versions tested/targeted by the beta line: 1.19.x, 1.20.x, 1.21.x, 26.1.x, and 26.2.x

Optional Plugins

MistTags works by itself.

Directly supported:

• PlaceholderAPI
• TAB
• LPC
• LuckPerms

Manual PlaceholderAPI compatibility:

• NametagEdit
• Essentials
• DeluxeTags
• UltraPrefixes
• TitleManager

Manual compatibility means the other plugin must support PlaceholderAPI placeholders, and you may need to add %misttags_display_prefix% / %misttags_display_suffix% yourself.

Setup

1. Download the latest beta jar from the GitHub Releases.
2. Put the jar in your server's plugins folder.
3. Start the server once.
4. Edit plugins/MistTags/config.yml if needed.
5. Restart, or run /mt reload.

First Test

Give yourself a test prefix:

/mt addprefix YourName 10m <green>[VIP]</green>

Preview a tag above your hotbar:

/mt preview <gold>[STAFF]</gold>

Open the staff manage menu:

/mt check YourName

Remove the test prefix:

/mt removeprefix YourName

Storage

By default, player tag data is stored in plugins/MistTags/misttags.db using SQLite.

Legacy data.yml files are imported once if the database is empty, then kept as backups. MistTags no longer writes data.yml for game storage.