Conditions

Conditions let you define requirements that must be met before a routine is executed. If any condition fails, the routine will not run, even if the scheduled time is correct.

They are defined under the conditions: section in each routine's config.

🧩 Types of Supported Conditions

Type	Description
permissions	Player must have all listed permissions
placeholders	Placeholder values must match a condition (supports numbers & strings)

📦 Example Configuration

conditions:
  - permissions:
      - "routine.yes"
      - "routine.admin"
  - placeholders: # Supports placeholders from the PlaceholderAPI plugin
      - "%server_online%>=20"
      - "%world_time%<13000"
      - "%player_name%==AaSteve"

🔍 Placeholder Comparison Operators

Operator	Meaning	Supports
==	Equals (case-sensitive)	Numbers, Text
==Aa	Equals (case-insensitive)	Only Text
!=	Not equal (case-sensitive)	Numbers, Text
!=Aa	Not equal (case-insensitive)	Only Text
>	Greater than	Numbers
<	Less than	Numbers
>=	Greater than or equal to	Numbers
<=	Less than or equal to	Numbers
*=	Contains (case-sensitive)	Only Text
!=*	Does not contain (case-sensitive)	Only Text
=*Aa	Contains (case-insensitive)	Only Text
~=	Starts with (case-sensitive)	Only Text
!~=	Does not start with (case-sensitive)	Only Text
~=Aa	Starts with (case-insensitive)	Only Text
^=	Ends with (case-sensitive)	Only Text
!^=	Does not end with (case-sensitive)	Only Text
^=Aa	Ends with (case-insensitive)	Only Text

⚠ Notes

• Conditions apply before any action is executed.

• All conditions must meet these requirements for the process to continue.

• placeholders values are evaluated dynamically at runtime.

• If any placeholder cannot be resolved, the condition is treated as false.

Custom Placeholders

Below you will find custom placeholders that can be used in the actions and conditions sections. Each platform has its own set of supported placeholders:

Spigot

Placeholders designed for servers running on Spigot (including Paper, Purpur, etc.).

Placeholder	Description	Return Type
%money%	Player's balance via Vault	Number
%online%	Number of online players	Number
%max_players%	Max allowed players on server	Number
%server_name%	Server name	Text
%server_version%	Server version	Text
%server_ip%	Server IP address	Test
%server_port%	Server port	Text
%player%	Player's name or "Console"	Text
%uuid%	Player's UUID or "Console"	Text
%display_name%	Player's display name	Text
%health%	Player's health	Number
%food%	Player's food level	Number
%level%	Player's XP level	Number
%exp%	Player's XP progress (0.0–1.0)	Number
%gamemode%	Player's game mode	Text
%is_flying%	If player is flying	true/false
%is_sneaking%	If player is sneaking	true/false
%is_sprinting%	If player is sprinting	true/false
%is_op%	If player is OP	true/false
%is_online%	If player is online	true/false
%potion_effects%	Active potion effects or none	Text
%world%	Current world of the player	Text
%location%	Player's X,Y,Z position	Text
%location_x%	Player's X coordinate	Number
%location_y%	Player's Y coordinate	Number
%location_z%	Player's Z coordinate	Number
%motd%	Server Message of the Day	Text

BungeeCord

Placeholders available for use with the BungeeCord proxy system.

Placeholder	Description	Return Type
%online_players%	Total number of players online across the proxy.	Number
%max_players%	Max allowed players defined in the proxy config.	Number
%player%	Player's name	Text
%uuid%	Player's UUID	Text
%server%	The name of the server the player is currently on.	Text
%version%	Proxy server version (e.g., BungeeCord version).	Text
%ip%	Player's IP address	Text
%server_<name>_online%	Number of players on a specific server.	Number
%server_<name>_name%	Name of the specific server.	Text
%server_<name>_motd%	MOTD (message) of the specific server.	Text

Velocity

Placeholders supported by the modern Velocity proxy platform for managing multiple servers.

Placeholder	Description	Return Type
%online%	Total number of online players across the proxy.	Number
%max%	Max players shown in server list (config setting).	Number
%player%	Player’s username	Text
%uuid%	Player’s UUID	Text
%server%	Current server name the player is connected to.	Text
%version%	Proxy server version string (e.g. Velocity version).	Text
%protocol%	Player’s protocol version (e.g. Minecraft client version ID).	Number
%motd%	MOTD from the proxy config.	Text
%ip%	Player’s IP address	Text
%server_<name>_online%	Online player count on a specific server (if it exists).	Number
%server_<name>_name%	The name of a specific registered server (or empty if not found).	Text