Requirements and Actions

note

You can have more than one requirement

Requirement type

Type	Identifiers	Options
Has permission	has permission has perm haspermission hasperm perm	permission
Is near	is near isnear	location radius
Is not near	!is near !isnear	location radius
Does not have permission	!has permission !has perm !haspermission !hasperm !perm	permission
Has money	has money hasmoney	amount
Does not have money	!has money !hasmoney	amount
Has XP	has xp hasxp	amount
Does not have XP	!has xp !hasxp	amount
String equals	string equals stringequals	input output
String not equals	string not equal !stringequals	input output
String contains	string contains stringcontains contains	input output
String not contains	!string contains !stringcontains !contains	input output
String length	string length stringlength	input output
Greater than	> greater than greaterthan	input output
Greater than equal to	>= greater than or equal to greaterthanorequalto	input output
Equal to	== equal to equalto	input output
Less than equal to	<= less than or equal to lessthanorequalto	input output
Less than	< less than lessthan	input output

Action type

Type	Identifiers	Definitions
Console	[Console]	Run command as Console
Player	[player]	Run command as Player
Command Event	[commandevent]	Fire a player command event
Open form	[openform]	Open a form
Messages	[messages]	Send a message
Broadcast	[broadcast]	Broadcast a message
Chat	[chat]	Send a chat message
Sound	[sound]	Play a sound
Broadcast Sound	[broadcastsound]	Broadcast with a sound
Take money	[takemoney]	Take money from player
Give money	[givemoney]	Give money to player
Take XP	[takexp]	Take XP from player
Give XP	[givexp]	Give XP to player
Give permission	[giveperm]	Give permission to player
Take permission	[takeperm]	Take permission from player
MiniMessage	[minimessage]	Send a MiniMessage

info

• Sound and Broadcast Sound: SoundID|volume|pitch|category

info

Feel free to suggest more requirements. Our Discord

Action tag

These tags are applicable for use alongside the action, for example: '[message] example<delay=20>'.

Type	Identifiers	Definitions
Delay	<delay=<time>>	Executes the action after the specified delay (in ticks, 20 ticks = 1 second).`
Chance	<chance=<chance>>	Specifies the probability of executing the action, ranging from 0 to 100. A value of 0 indicates the action will never execute, while a value of 100 ensures it will always execute.`

Syntax

open_requirements:
  requirements:
    <name>:
      type: "<"
      input: "%server_online%"
      output: "5"
      deny_commands:
        - '[messages] &cServer must have less than 5 players!'
components:
  test:
   title: "Hello"
   image:
    type: "path"
    data: ""
   view_requirements:
     <name>:
       type: ">"
       input: "%server_online%"
       output: "5"
       deny_commands:
         - '[messages] &cServer must have less than 5 players!'
   click_requirements:
     check_distance:
       type: 'is near'
       location: '603,100,1'
       radius: 10
       deny_commands:
         - '[message] &cYou must be near the location'
   click_commands:
    - '[openform] something'