SpecPrefix

SpecPrefix

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

✨ Features

- PlaceholderAPI integration — set different prefixes for chat and player list - PlaceholderAPI integration — Pulse (smooth breathing), Cycle (color transition), Flash (rapid switching) - PlaceholderAPI integration — 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

- Folia / Leaf / Paper / Pufferfish / Purpur — Folia / Leaf / Paper / Pufferfish / Purpur - Folia / Leaf / Paper / Pufferfish / Purpur — recommended - Folia / Leaf / Paper / Pufferfish / Purpur 1.21+

⚠️ Important Notes

Server Software Compatibility

This plugin is designed and tested exclusively on compatibility is NOT guaranteed, compatibility is NOT guaranteed, compatibility is NOT guaranteed, compatibility is NOT guaranteed, compatibility is NOT guaranteed. 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:

- TAB by NEZNAMY, 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:

```yaml 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: ```yaml 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

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