DiscordSRV Ultimate

I will be leaving Modrinth. Please go to my GitHub instead.

🥏 DiscordSRV Ultimate adds:

• Its own placeholders for making text bold, underline, italic or smallcaps
• Post-processed placeholders from both DiscordSRV and PlaceholderAPI
• An ability to make gradients in combination with other tools

📒 Dependencies (must-install)

• DiscordSRV
• PlaceholderAPI

ℹ️ Information

• ⚠️ The plugin doesn't work on non-Paper Bukkit forks!
• A GitHub is not available, but the project is not obfuscated, you can decompile it freely.
• The plugin is licensed with CC-BY-NC 4.0, but you do NOT need to credit me.

🤔 Usage

DiscordSRV Ultimate extends the possibilities of the DiscordToChatMessage format (DiscordToMinecraftChatMessageFormat and DiscordToMinecraftChatMessageFormatNoRole fields), by post-processing the output. For example, to make the role gradiented, you can use this:

[[gradient_message_$[[toprolecolor]]_#000000_[[toprolealias]]]]&8 » &7%name%%reply%:&f %message%

The example might look hard, but here's what it does:

• Get the top user role alias
• Make a gradient from the user role color (converted from §x§r§r§g§g§b§b to #rrggbb) to #000000 with this text

To make it work, you must also have the Gradient PAPI Expansion installed:

• /papi ecloud download Gradient
• /papi reload

The plugin replaces both [[ and ]] with %, as if just % was used, it would be parsed during pre-processing. Why am I post-processing it? Because I have no idea how to make all this during pre-processing (DiscordSRV events are... weird).

As mentioned earlier, $§x§r§r§g§g§b§b converts to #rrggbb. This is for the gradients (and other color manipulation) to work.

🧩 Merging

If you want to mix some of the things, e.g. smallcaps and gradient, you would have to use the Utils PAPI Expansion for that. The installation is also straightforward:

• /papi ecloud download Utils
• /papi reload

And the usage is... a bit complex:

[[utils_parse_gradient_message_$[[toprolecolor]]_#000000_{dsu_smallcaps_[[toprolealias]]}]]&8 » &7%name%%reply%:&f %message%

The DSU placeholders come from this plugin and stand for DiscordSRV Ultimate.

---

Sadly, the plugin doesn't yet support mixing the color itself without external tools. I am planning to implement that in the next release.