Features

Macro Strings

Macro Strings are a utility for logic like conditions and maths.

With them, you can simply evaluate complex conditions and use ternary.

Condition Evaluation

If you want to display conditions like <player> == Admin and you tried it, you got a result like Ontey == Admin.

But you probably don’t want that, but rather a boolean, displaying the condition.

You achieve it by using a Macro Strings:

message: Admin = $(<player> == Admin)
# output: Admin = true/false

Now, you do not always want just a boolean, but rather a nice text.

That is achieved by using Ternary, which follows this Syntax: $(<condition> ? <true_output> : <false_output>)

The true and false output are trimmed; spaces on the left and right are removed

Extension of the example before:

message: $(<player> == Admin ? &aYou are an admin! : &cYou are not an admin!)

Math operations

With them, you can evaluate simple maths.

For more complex calculations, use the PlaceholderAPI maths extension

Math operations expect the format number + op + number and won't be recognized as such otherwise.

allowed characters

Operator	Description
*	Multiplication
/	Division
%	Remainder of division
+	Addition
^	Exponentiation
-	Subtraction

Example:

10 + 10 to 20

Advanced Coloring

Legacy

Format: \<symbol>\<char>

The symbol can be either & or §.

The char determines the color. For example, e is yellow and a is green.

If the symbol is an ampersand &, you can escape them with either \&e or &&e.

That is not the case for §, as it is the official mojang way of adding colors.

Mini Message

This format can do way more than just colors, check out their wiki for more information.

Legacy Hex

Format: \<symbol>#\<hex>

The symbol can be & or §.

The hex can be upper case (FF00AA) or lowercase (ff00aa).

You can escape these with \<symbol>#\<hex>

End-Codes

You can also end colors, which is a native mini-message feature I implemented into all coloring methods.

without end codes:
&l&o&e Hello, &r&l&o World

with end codes:
&l&o&e Hello, &/e World

Format

• &/e
• §/e
• &/#ff00ff
• §/#ff00ff
• </yellow>
• </#ff00ff>
• </255,0,255>

Mini-Message Abbreviations - v0.5.1

everyone likes mini-message, but the click events are really lengthy.

So I added some abbreviations for them:

Abbreviation	Replacement	Description
<cmd:%arg>	click:run_command:%arg	Run the command %arg
<suggest:%arg>	click:suggest_command:%arg	Suggest the command %arg
<copy:%arg>	click:copy_to_clipboard:%arg	Copy the text %arg
<url:%arg>	click:open_url:%arg	Opens the url %arg
<uurl:%arg>	<u>click:open_url:%arg	Same as url, but underlined

They can all be escaped with <tag> ( e.g. \<url:modrinth.com/plugin/ccmd/version/0.5> )

Also, all of them have ending tags: </tag-name> ( e.g. </cmd>

They all follow this format: < name : quote input quote >

Both quotes have to be the same and can be “ or ‘

Since v2.0, quotes are required