Expressions - CodeCrafter47/BungeeTabListPlus GitHub Wiki
Expressions are used at various places in the configuration of the plugin. So here's a definition of what is an expression:
Note on the semantic: The result of an expression can be a boolean value (true/ false), a number or a string. In most
places the plugin requires a boolean result. If the expression does not give a boolean result, the result will be converted,
i.e. a number will be converted to false
if it is 0
and to true
in all other cases, a string will be converted to
true
if it equals "true"
all other strings will be converted to false
.
-
Any number is an expression, so the following are valid expressions. Examples:
0 1000 -7 47.2
-
A string in double quotes is a valid expression. Examples:
"Hello World" ""
-
The boolean literals are
true
,false
andall
(same astrue
).
Any placeholder is a valid expression. See the full list of placeholders for more information.
Examples:
${player name}
${viewer uuid}
${playerset:global size}
${server:lobby online}
${viewer server tps}
<Expression> <Binary Operator> <Expression>
is a valid expression. The following binary operators are available:
Operator | Semantic |
---|---|
and |
Evaluates to true only if both operands evaluate to true . |
or |
Evaluates to true if at least one of the operands evaluate to true . |
== |
Tests the operands for equality. |
!= |
true if the operands are not equal, false otherwise. |
< |
Compares two numbers, true if the first operand is smaller than the second operand. |
<= |
Compares two numbers, true if the first operand is smaller or equal the second operand. |
> |
Compares two numbers, true if the first operand is greater than the second operand. |
>= |
Compares two numbers, true if the first operand is greater or equal the second operand. |
. |
Concatenates two strings. |
+ |
Adds two numbers. |
- |
Subtracts one number from another. |
* |
Multiplies two numbers. |
/ |
Divides one number by another. |
Examples:
${viewer name} == "CodeCrafter47"
${viewer ping} <= 50
50 < ${viewer ping} <= 150
${viewer server} == "survival" and ${viewer world} == "world_nether"
( <Expression> )
is a valid expression. Parenthesis can be used to prevent ambiguities.
Example:
(${viewer server} == "survival" and ${viewer world} == "world_nether") or (${viewer group} == "Admin")
You can use !
to negate boolean expressions.
Examples:
!${server:lobby online}
!(${viewer server} == "survival" and ${viewer world} == "world_nether")