Pipes and operators

There are two ways to change a value, and they look different. A pipe goes inside a placeholder, after a |, and changes whatever that placeholder gives back.

Pipe

{server.member_count|comma}

Result

1,234

An operator is its own node and works on whatever you put after the :, whether that’s text you typed or another placeholder.

Operator

{fmt: 71437}
{fmt: {server.member_count}}

Result

71,437
1,234

Several names exist as both. Use the pipe when you already have a placeholder, and the operator when you’re working with plain text or nesting things.

Pipes

Syntax

{placeholder|pipe}
{placeholder|pipe: args}

Pipe	Aliases	Args	Description	Example
`upper`	`u`	None	Makes it uppercase	`{member.name\|upper}` → `HELLOFAMAN`
`lower`	`l`	None	Makes it lowercase	`{member.name\|lower}` → `hellofaman`
`title`	`t`	None	Capitalises each word	`{member.name\|title}` → `Hellofaman`
`capitalize`	`cap`	None	Capitalises the first letter	`{member.name\|cap}` → `Hellofaman`
`length`	`len`	None	Counts the characters	`{member.name\|len}` → `10`
`comma`	`fmt`	None	Adds separators to big numbers	`{server.member_count\|comma}` → `1,234`
`ordinal`	`ord`	None	Turns a number into a position	`{member.join_position\|ordinal}` → `2nd`
`plural`	`plur`, `p`	`singular,plural`	Picks a word based on the number	`{server.member_count\|plural: member,members}`

Operators

Syntax

{operator: value}

Logic

Use these to change what a message says depending on the situation.

if

Syntax

{if: condition && value if true && value if false}

Shows the first value when the condition passes, and the second when it doesn’t. You can compare with ==, !=, >, <, >=, and <=.

Examples

{if: {member.top_role} && Your top role is {member.top_role} && You don't have any roles yet}
{if: {server.member_count}>100 && Big server && Small server}

unless

Syntax

{unless: condition && value if true && value if false}

The opposite of if. Shows the first value when the condition is empty or false.

Example

{unless: {member.top_role} && No roles yet && Has roles}

default

Syntax

{default: value, fallback}

Shows the value if there is one, and the fallback if there isn’t.

Example

{default: {member.top_role}, No roles}

Watch the separators. if and unless split their parts with &&, but default splits with a comma. Using the wrong one leaves the whole node showing as raw text.

Maths

Operator	Syntax	Description	Example
`add`	`{add: 10+5}`	Adds the numbers together	`{add: {server.member_count}+10}` → `54`
`sub`	`{sub: 10-5}`	Takes the rest away from the first	`{sub: 100-{server.member_count}}` → `56`
`mul`	`{mul: 10+5}`	Multiplies them together	`{mul: {server.member_count}+2}` → `88`
`div`	`{div: 100+5}`	Divides the first by the rest	`{div: 100+{server.member_count}}` → `2`
`floor`	`{floor: 4.7}`	Rounds down	`{floor: 4.7}` → `4`
`ceil`	`{ceil: 4.2}`	Rounds up	`{ceil: 4.2}` → `5`
`round`	`{round: 4.5}`	Rounds to the nearest	`{round: 4.5}` → `5`

Numbers are separated with +, except sub, which uses -.

Countdown to a milestone

{sub: 2000-{server.member_count}} more members until 2k!

Text

These work on text you type, or on a placeholder you nest inside them.

Operator	Aliases	Description	Example
`upper`	`u`	Makes it uppercase	`{upper: hello world}` → `HELLO WORLD`
`lower`	`l`	Makes it lowercase	`{lower: HELLO}` → `hello`
`capitalize`	`cap`	Capitalises the first character	`{cap: hello}` → `Hello`
`length`	`len`	Counts the characters	`{len: hello}` → `5`
`comma`	`fmt`	Adds separators to big numbers	`{fmt: 71437}` → `71,437`
`ordinal`	`ord`	Turns a number into a position	`{ord: 3}` → `3rd`
`plural`	`plur`	Picks a word based on the number	`{plural: {server.member_count}: person,people}` → `people`
`plural`	`plur`	Adds an `s` when it needs one	`{plural: {server.member_count}}` → `s` or nothing

plural on its own is the quick version. {server.member_count} member{plural: {server.member_count}} reads correctly whether there’s one member or a thousand.

Random

Operator	Aliases	Syntax	Description
`random`	`rand`, `r`, `choice`	`{random: a,b,c}`	Picks one of the options
`randint`	`rng`, `ri`	`{randint: 1,100}`	Picks a whole number between the two, including both

Examples

{random: Welcome,Hello,Sup,Hey}
{randint: 1,100}
{color: {random: #BAEBAE, #EFAEFA}}
{sticker: {r: wave, heya, sup}}

What counts as empty

if, unless, and default all treat these as empty:

Value	Notes
Nothing at all	An empty value
`0`
`false`
`None` or `null`
A node that didn’t resolve	Left as raw text, so it counts as empty

Everything else counts as having a value.

Security

Automation

Scripting

Reference

Pipes and operators

Pipes

Operators

Logic

if

unless

default

Maths

Text

Random

What counts as empty

​Pipes

​Operators

​Logic

​if

​unless

​default

​Maths

​Text

​Random

​What counts as empty

Pipes

Operators

Logic

if

unless

default

Maths

Text

Random

What counts as empty