Expressions Expansion - Expressions Expansion for MiniPlaceholders

This is a discussion topic for the Ore project, Expressions Expansion. View the full project on Ore for downloads and more information.


Expressions-Expansion

Expressions Expansion for MiniPlaceholders.

Placeholders

Basic Operations

  • Addition | <expr_add:n1:n2:...:nX>
    • <expr_add:5:2:3> == 10
  • Subtraction | <expr_sub:n1:n2>
    • <expr_sub:10:3> == 7
  • Multiplication | <expr_mul:n1:n2:...:nX>
    • <expr_mul:5:2:3:6> == 180
  • Division | <expr_div:n1:n2>
    • <expr_div:10:5> == 2
  • Division remainder <expr_mod:n1:n2>
    • <expr_mod:5:2> == 1
  • Negation | <expr_neg:n>
    • <expr_neg:5> == -5
    • <expr_neg:-5> == 5

Round

  • Round down to integer | <expr_floor:n>
    • <expr_floor:5.05> == 5
    • <expr_floor:2.9> == 2
  • Round to nearest integer | <expr_round:n>
    • <expr_floor:5.05> == 5
    • <expr_floor:2.9> == 3
  • Round up to integer | <expr_ceil:n>
    • <expr_floor:5.05> == 6
    • <expr_floor:2.9> == 3
  • Get the lowest-valued number | <expr_min:n1:n2:...:nX>
    • <expr_min:5:10:15:2:500:9:69> == 2
  • Get the highest-valued number | <expr_max:n1:n2:...:nX>
    • <expr_max:5:10:15:2:500:9:69> == 500
  • A random number from 0 to 1 | <expr_random> | Acts like <expr_random:0:1:0.01>
    • <expr_random> == 0.15
  • A random integer from min to max | <expr_random:min:max> | Acts like <expr_random:min:max:1>
    • <expr_random:1:100> == 69
  • A random number from min to max with a step of step | <expr_random:min:max:step>
    • <expr_random:50:10:0.25> == 68.75

String Operations

  • Concat strings | <expr_concat:s1:s2:...:sN>
    • <expr_concat:hello:_:world> == “hello_world”
  • Create a substring of s from n1 to n2 character | <expr_substring:s:n1:n2>
    • <expr_substring:hello:2:4> == “ll”
  • Get length of the string | <expr_length:s>
    • <expr_length:hello> == 5
  • Format a string using Java String.format() | <expr_format:format:arg1:arg2:...:argX>
    | It may be useful for user expressions
    • <expr_format:'%s is not a %s':4drian3d:fruit> == “4drian3d is not a fruit”
  • Displays r1 if o1 and o2 are same. Otherwise, displays rs | <expr_if:o1:o2:r1:r2>
    • <expr_if:1:2:Equals:NotEquals> == “NotEquals”
  • Sets text placeholders for a player with uuid. | <expr_player:uuid:text>
    • <expr_player:4drian3dUUID:<player_name>> == 4drian3d
  • Sets text placeholders for a player with name. | <expr_player:name:text>
    • <expr_player:4drian3d:<player_ping>> == 42
  • Expand to a User expression | <expr_user:name:arg1:arg2:...:argX>

User expressions

You can create your own expression shortcut in config.yml using our Expression Expansion Language (EEL):

add_and_multiply: "<expr_add:'<arg1>':'<expr_mul:\\'<arg2>\\':\\'<arg3>\\'>'>" means <expr_user:add_and_multiply:arg1:arg2:arg3> will be evaluated to arg1 + (arg2 * arg3). So, <expr_user:add_and_multiply:2:3:4> evaluates to <expr_add:2:'<expr_mul:3:4>'>, which is 2 + (3 * 4) = 14

Example user expressions

  • <expr_user:remove_first:s:n> - Remove n first characters from s (hello, 2llo), EEL: remove_first: "<expr_substring:'<arg1>':'<arg2>':'<expr_length:\\'<arg1>\\'>'>"
  • <expr_user:remove_last:s:n> - Remove n last characters from s (hello, 2hel), EEL: remove_last: "<expr_substring:'<arg1>':0:'<expr_sub:\\'<expr_length:\\\\\\'<arg1>\\\\\\'>\\':\\'<arg2>\\'>'>"
  • <expr_user:decimals:n:decimals> - format a number (1.234567, 21.23), EEL: decimals: "<expr_format:'<expr_concat:\\'%.0\\':\\'<arg2>\\':\\'f\\'>':'<arg1>'>"
  • <expr_user:pad_integer:n:length> - pad an integer with zeros (12, 3012), EEL: pad_integer: "<expr_format:'<expr_concat:\\'%0\\':\\'<arg1>\\':\\'d\\'>':'<arg2>'>"

Nesting

Expressions can be nested. Try /miniplaceholders parse me "<expr_add:1:'<expr_add:1:\\'<expr_add:1:\\\\\\'<expr_add:1:\\\\\\\\\\\\\\'<expr_add:1:0>\\\\\\\\\\\\\\'>\\\\\\'>\\'>'>"

Downloads

A new version has been released for Expressions Expansion, it is available for download here.


What’s Changed

  • fix: Removed Krypton module
  • feat: Added Sponge support
  • fix: Fixed placeholders nesting
  • fix: Fixed Fabric module 1.20+ support

Full Changelog: Comparing 1.1.1...1.2.0 · MiniPlaceholders/Expressions-Expansion · GitHub