search
githubEdit

🏁Requirements

The requirements feature allows you to perform actions based on a permission check.

hashtag
Requirements

hashtag
Syntax

# open-requirement
# click-requirement
view-requirement:

  # Set the minimum number of requirements to be able to say this is a success.
  # By default the value will be the same as the number of requirements.
  minimum-requirement: <number>
  
  # List of requirements, all information about each type below
  requirements:
    - type: permission
      permission: "example.permission"
      deny:
        - type: message
          messages:
            - "&cYou don't have permission !"
    - type: placeholder
      placeholder: "%player_gamemode%" # need PAPI ecloud Player
      value: "CREATIVE"    
      action: equals_string
      # Specific deny actions
      deny:
        - type: message
          messages:
            - "&cYou mus be in creative"      
    - type: regex
      input: "%player_item_in_hand%" # need PAPI ecloud Player
      regex: "(NETHERITE_|DIAMOND_|IRON_|GOLDEN_|STONE_|WOODEN_|LEATHER_|BOW|CROSSBOW|FISHING_ROD|SHEARS|SHIELD|TRIDENT|TURTLE_HELMET|ELYTRA|FLINT_AND_STEEL)"      
      deny:
        - type: message
          messages:
            - "&cYou dont have items in your hand !"
  
  # Global Success actions
  success:
    - type: sound
      sound: ENTITY_PLAYER_LEVELUP
      
  # Global Deny actions
  deny:    
    - type: message
      messages:
        - "&cYou doesn't have an item in your hand."

In addition to global deny and success actions, you can define specific deny and success actions for each requirement.

hashtag
View Requirement

Defines the requirements a player must meet to see a button in the inventory.

hashtag
Example:

hashtag
Open Requirement

Defines the requirements a player must meet to open the inventory.

hashtag
Example

In the example below, there is a check for the item in the player's hand. If the item matches the regex pattern, the player can open the inventory. Otherwise, they will receive a message, and the inventory will not open.

hashtag
Click Requirement

Defines multiple requirements for clicking the button. You need to specify several requirements and the corresponding clicks.

You can apply all clicks directly by using the following format:

You can set the click type to ALL or ANY to apply the actions to all clicks. The list of clicks that will be included can be managed in the config.json file.

hashtag
Example:

hashtag
Requirements type

hashtag
permission

Checks if the player has the specified permission. To reverse the condition, add an exclamation mark ! in front of the permission, like this: !<permission>.

hashtag
placeholder

Allows you to define a permission using a placeholder. You must specify the placeholder, the action to be performed with the value, and the value that will be checked. For more information, click herearrow-up-right.

You can specify a player; otherwise, the player who opens the inventory will be used by default.

Actions:

  • BOOLEAN (alias: b=): Checks if a value is true or false.

  • EQUALS_STRING (alias: s=): Checks if the text is strictly equal to the value.

  • EQUALSIGNORECASE_STRING (alias: s==): Checks if the text is equal to the value, ignoring case.

  • CONTAINS_STRING (alias: sc): Checks if the text is contained within the value.

  • DIFFERENT_STRING (alias: s!=): Checks if the text is different from the value.

  • SUPERIOR (alias: >): Checks if a number is strictly greater than the value.

  • LOWER (alias: <): Checks if a number is strictly less than the value.

  • SUPERIOR_OR_EQUAL (alias: >=): Checks if a number is greater than or equal to the value.

  • LOWER_OR_EQUAL (alias: <=): Checks if a number is less than or equal to the value.

  • EQUAL_TO (alias: ==): Verifies that two numbers are identical.

hashtag
regex

Checks if the input matches the specified regex pattern. The input can be a placeholder.

Visit regexr.comarrow-up-right to create your regex pattern.

hashtag
item

Checks if the player has a specific item in their inventory.

hashtag
job

Allows to check if the player has the job. Works with JobRebornarrow-up-right plugin.

hashtag
luckperm

Allows to check if the player is in a group. Works with LuckPermsarrow-up-right plugin.

hashtag
playername

Allows to check if a placeholder returns a text that can be a player nickname.

hashtag
money

Check if the player has enough money in their account. This only works with BeastTokensarrow-up-right, Vaultarrow-up-right, PlayerPointsarrow-up-right, ElementalTokensarrow-up-right, ElementalGemsarrow-up-right, Levelarrow-up-right, Experiencearrow-up-right, zEssentialsarrow-up-right, EcoBitsarrow-up-right, CoinsEnginearrow-up-right and VotingPluginarrow-up-right. CurrenciesAPI : https://github.com/Traqueur-dev/CurrenciesAPIarrow-up-right

hashtag
cuboid

Allows you to check if the player is present in a cuboid. You must define the world as well as the coordinates of the two ends of your cuboid.

hashtag
and

Allows to combine multiple requirements into one.

circle-exclamation

This feature is only available with zMenu+ !

chevron-rightExample and + or requirementhashtag

This example uses an and and or requirement. The player must have the permission zmenu.test and zmenu.test2 and must have the permission zmenu.test3 or the permission zmenu.test4.

hashtag
or

Allows to combine multiple requirements into one and have a minimum of required.

The random option determines whether the list of requirements should be traversed randomly or not.

circle-exclamation

This feature is only available with zMenu+ !

PreviousButtonsNextActions

Last updated