SpecPrefix

A simple yet powerful prefix plugin with RGB animations for Minecraft servers.

✨ Features

• Separate chat and tab prefixes — set different prefixes for chat and player list
• Multiple animation types — Pulse (smooth breathing), Cycle (color transition), Flash (rapid switching)
• Flexible configuration — adjustable prefix length, symbol whitelist, color restrictions
• PlaceholderAPI integration — %specprefix_prefixchat%, %specprefix_prefixtab%, %specprefix_lastcolor%

🔑 Permissions

All permissions are disabled by default for regular players. Operators automatically get all permissions. Use LuckPerms or any permission plugin to manage access.

Permission	Description
specprefix.use	Access to /prefix command
specprefix.colorlegacy	Use legacy color codes
specprefix.colorhex	Use HEX color codes
specprefix.symbols	Use special symbols
specprefix.animation	Use prefix animations
specprefix.ignorelength	Bypass prefix length limit
specprefix.admin	Full access

📦 Requirements

• PlaceholderAPI — REQUIRED
• LuckPerms — recommended
• Folia / Leaf / Paper / Pufferfish / Purpur 1.21+

⚠️ Important Notes

Server Software Compatibility

This plugin is designed and tested exclusively on Folia, Leaf, Pufferfish, Paper, Purpur. It may work on other forks or server software, but compatibility is NOT guaranteed.

Not supported:

• ❌ Any Minecraft Bedrock
• ❌ Any Minecraft server without PlaceholderAPI
• ❌ Cardboard (Spigot-Fabric compatibility layer)
• ❌ Hybrid server software (Arclight, Magma, Mohist and etc)
• ❌ Mod loaders (Fabric, Forge, LegacyFabric, LiteLoader, NeoForge, Quilt and etc)
• ❌ Proxy servers (BungeeCord, Velocity, Waterfall and etc)
• ❌ Spigot, CraftBukkit and any non-Paper forks
• ❌ Vanilla Minecraft Java

Plugin Ecosystem

This plugin does NOT display anything by itself. It registers PlaceholderAPI placeholders and the /prefix command. To actually see prefixes in-game, you need a compatible chat/tab plugin:

• ChatEx, EssentialsX Chat, CMI — for chat prefixes
• TAB by NEZNAMY, CMI — for tab prefixes
• Any other PAPI-compatible chat/tab plugin

Without a PAPI-compatible plugin, prefixes won't appear! You must configure your chat/tab plugin to use SpecPrefix placeholders.

Animation Lag Fix

If RGB animations in tab appear choppy or laggy, increase the placeholder refresh rate in your tab plugin. For TAB by NEZNAMY, add to its config:

placeholder-refresh-intervals: 
  "%specprefix_prefixtab%": 50

Placeholders

Placeholder	Returns
%specprefix_prefixchat%	Chat prefix (or LuckPerms fallback)
%specprefix_prefixtab%	Tab prefix (or LuckPerms fallback)
%specprefix_lastcolor%	Last HEX/legacy color from chat prefix

ChatEx example:

message-format: '&eⓁ&r %specprefix_prefixchat% %displayname&e →&r %specprefix_lastcolor%%message'

📄 License

This project is licensed under the MIT License — you are free to use, modify, and distribute it.

💬 Support

If you encounter issues or have questions:

1. Make sure you have PlaceholderAPI installed
2. Check that your chat/tab plugin supports PlaceholderAPI
3. Verify your server is running Folia / Leaf / Paper / Pufferfish / Purpur
4. Read the console for error messages

🌐 Contacts

• Telegram: @MrSpectrumYT
• Bug reports & feature requests: Contact via Telegram