☢️Actions

Actions that can be performed after a requirement

With a requirement, you can define actions for both success and failure. Here are the actions that can be performed.

Example: You will need to create an action list like this:

success:
  - type: player_command
    commands:
      - "firstcommand"
      - "seconds commands %player%"
  - type: console_command
    commands:
      - "firstcommand"
      - "seconds commands %player%"      
  - type: message
    messages:
      - "firstcommand"
      - "seconds commands %player%"

You can add a delay, in ticks, for each item in the list below. Do it like this:

success:
  - type: player_command
    delay: 10 # 10 ticks
    commands:
      - "firstcommand"
      - "seconds commands %player%"

You can add a chance for each item in the list below. Do it like this:

success:
  - type: player_command
    chance: 50 # 50% chance
    commands:
      - "firstcommand"
      - "seconds commands %player%"

zMenu

Actions compatible with Dialogs are now marked with a badge:

Actions not compatible are marked with:

`player command`

- type: player command
  commands:
    - "firstcommand"
    - "seconds commands %player%"
  command-in-chat: false # false by default

Executes commands as the player. You can also send the command in the player's chat.

`random player command`

- type: random_player_command
  amount: 1 # Default value
  commands:
    - "firstcommand"
    - "seconds commands %player%"
  command-in-chat: false # false by default

Executes random commands as the player. You can also send the command in the player's chat.

This feature is only available with zMenu+ !

`console command`

- type: console_command
  commands:
    - "firstcommand"
    - "seconds commands %player%"

Executes commands as the console.

`random console command`

- type: random_console_command
  amount: 1 # Default value
  commands:
    - "firstcommand"
    - "seconds commands %player%"

Execute random commands from the list.

This feature is only available with zMenu+ !

`player command as op`

- type: player command as op
  commands:
    - <command>

Allows the execution of a command while being op.

Attention, this action will give all the permissions to the player while they execute the command. Please be careful when using this action.

`message`

- type: message
  messages:
    - "my message"
    - "my second messages"
  mini-message: true # true by default

Sends a message to the player. You can use placeholders, color codes, and format codes. The MiniMessage format is enabled by default if your server supports it.

`broadcast`

- type: broadcast
  messages:
    - "my name %receiver%"
    - "my second message send by %sender%"
  mini-message: true # true by default
  requirements: 
    - type: permission
      permission: "admin.use"

Sends a message to all online players. You can use placeholders, color codes, and format codes. The MiniMessage format is enabled by default if your server supports it.

%sender% is the name of the player sending the broadcast %receiver% is the name of the player who will receive the message.

You can set a list of requirements to send a message to certain players.

`chat`

- type: chat
  messages:
    - "my message"

Sends messages on behalf of the player. You can use placeholders, color codes, and format codes. MiniMessage format is enabled by default if your server supports it.

`close`

- type: close

Closes the player's inventory.

`inventory`

- type: inventory
  inventory: <inventory name>
  plugin: <plugin name>
  page: <page>
  arguments: <argument list>

Opens an inventory.

`connect`

- type: connect
  server: <server name>

Allows sending the player to another server, only works with BungeeCord and Velocity.

`sound`

- type: sound
  sound: <xsound>
  pitch: <sound pitch> # 1.0f by default
  volume: <sound volume> # 1.0f by default

Send a sound to a player, you must use XSound for sound.

`broadcast sound`

- type: broadcast_sound
  sound: <xsound>
  pitch: <sound pitch> # 1.0f by default
  volume: <sound volume> # 1.0f by default

Send a sound to the online players, you must use XSound for sound.

`data`

- type: data
  action: <SET/REMOVE/ADD/SUBTRACT>
  key: <data key>
  value: <data value>
  seconds: <expire seconds> # 0 by default
  math: <true/false>

Update player data.

You can use mathematical expressions if you set math to true, this allows you to do more complex actions. Work only with ADD and SUBTRACT.

`refresh`

- type: refresh

Refresh current button. Works only in click requirement.

If you update the status of a player with orders, to be sure that the inventory update is done correctly, you must put a delay of 1 tick.

`refresh inventory`

- type: refresh inventory

Refreshes the currently open inventory.

`back`

- type: back

Return to previous inventory.

`shopkeeper`

- type: shopkeeper
  name: <shopkeeper name>

Open a Shopkeeper trading inventory

`book`

- type: book
  author: "Maxlego08" # Book author
  title: "&cTest" # Book title
  lines: # Book pages
    1: # First page
      - '     #34ebe8zMenu'
      - ''
      - ''
      - '<hover:show_text:"#34eba8Open an url !"><click:open_url:"https://minecraft-inventory-builder.com/">#f0af24Open URL<reset>'

Opens a book for the player. You can specify the title, author, and pages of the book.

`actionbar`

- type: actionbar
  message: "my message"
  minimessage: true # true by default

Allows you to send a message in the action bar of the player. You can use placeholders and color/format codes here. MiniMessage format is enabled by default if your server supports it.

`withdraw`

- type: withdraw
  amount: <amount>
  currency: <currency name>
  economy: <economy name> # Only the zEssentials, CoinsEngine and EcoBits plugins need this

Allows you to withdraw money from the player’s account. Works with the BeastTokens, Vault, PlayerPoints, ElementalTokens, ElementalGems, Level, Experience, zEssentials, EcoBits, CoinsEngine and VotingPlugin. CurrenciesAPI : https://github.com/Traqueur-dev/CurrenciesAPI

`deposit`

- type: deposit
  amount: <amount>
  currency: <currency name>
  economy: <economy name> # Only the zEssentials, CoinsEngine and EcoBits plugins need this

Allows you to deposit money from the player’s account. Works with the BeastTokens, Vault, PlayerPoints, ElementalTokens, ElementalGems, Level, Experience, zEssentials, EcoBits, CoinsEngine and VotingPlugin. CurrenciesAPI : https://github.com/Traqueur-dev/CurrenciesAPI

`title`

- type: title
  title: <title>
  subtitle: <sub title>
  start: <start in milliseconds>
  duration: <duration in milliseconds>
  end: <end in milliseconds>

Send a title. You can use placeholders and color/format codes here. MiniMessage format is enabled by default if your server supports it.

`teleport`

- type: teleport
  world: <world> # default world is "world"
  x: <x>
  y: <y>
  z: <z>
  yaw: <yaw>
  pitch: <pitch>

Teleport a player

`discord`

- type: discord
  webhook: "https://discord.com/api/webhooks/<url>"
  message: "Test webhook"

Allow to send a discord webhook. You can add a embeds, username, tts etc.

- type: discord
  webhook: <url>
  message: <content>
  avatar: <avatar url>
  username: <webhook username>
  embeds:
    - title: <embed title>
      description: <embed description>
      url: <url>
      color: <hex color>
      footer:
        text: <text footer>
        icon-url: <icon url>
      thumbnail:
        url: <url>
      image:
        url: <url>
      author:
        name: <author name>
        url: <author url>
        icon-url: <author icon url>
      fields:
        - name: <field name>
          value: <field value>
          inline: true/false

`discord component`

- type: discord component
  webhook: "https://discord.com/api/webhooks/<url>"
  username: "GroupeZ" #Optional
  avatar_url: "" #Optional
  component: [
    {
      "type": 10,
      "content": "Never trust a alien with a giant spaghetti."
    },
    {
      "type": 14,
      "divider": true,
      "spacing": 2
    },
    {
      "type": 10,
      "content": "If life gives you invisible unicorn, make invisible unicorn soup."
    },
    {
      "type": 17,
      "accent_color": 14951974,
      "spoiler": true,
      "components": [
        {
          "type": 10,
          "content": "Never trust a grandma with a giant spaghetti."
        }
      ]
    }
  ]

Send a webhook discord components. To generate your component you must go to the site https://discord.builders/, then you must copy the result json. You can simplify your json into one line here.

`permission set`

- type: permission set
  permission: <permission>
  value: <true/false>

Allows you to add or remove a permission from a player, works with luckperms.

`toast`

- type: toast
  toast-type: <TASK/GOAL/CHALLENGE>
  message: <your message>
  material: <material>
  model-id: <material model id> # Default is 0 #Can be a float value or string for itemModel "<namespace>:<model name>"
  glowing: <true/false>

Allows you to send a toast message to the player. You can use a material from another plugin to define the material and model id to use.

zQuests

Lists of actions working with the zQuests plugin.

`start quest`

- type: start quest
  quests:
    - <quest name>

Allows you to start several quests.

zJobs

Lists of actions working with the zJobs plugin.

`zjobs add points`

- type: zjobs add points
  points: <points>

Allows you to add job points

`zjobs claim reward`

- type: zjobs claim reward
  reward: <reward id>

Allows you to claim a reward

`zjobs remove points`

- type: zjobs remove points
  points: <points>

Allows you to remove job points

PreviousRequirements NextItems

Last updated 4 months ago

hashtagzMenu

hashtagplayer command

hashtagrandom player command

hashtagconsole command

hashtagrandom console command

hashtagplayer command as op

hashtagmessage

hashtagbroadcast

hashtagchat

hashtagclose

hashtaginventory

hashtagconnect

hashtagsound

hashtagbroadcast sound

hashtagdata

hashtagrefresh

hashtagrefresh inventory

hashtagback

hashtagshopkeeper

hashtagbook

hashtagactionbar

hashtagwithdraw

hashtagdeposit

hashtagtitle

hashtagteleport

hashtagdiscord

hashtagdiscord component

hashtagpermission set

hashtagtoast

hashtagzQuests

hashtagstart quest

hashtagzJobs

hashtagzjobs add points

hashtagzjobs claim reward

hashtagzjobs remove points

zMenu

`player command`

`random player command`

`console command`

`random console command`

`player command as op`

`message`

`broadcast`

`chat`

`close`

`inventory`

`connect`

`sound`

`broadcast sound`

`data`

`refresh`

`refresh inventory`

`back`

`shopkeeper`

`book`

`actionbar`

`withdraw`

`deposit`

`title`

`teleport`

`discord`

`discord component`

`permission set`

`toast`

zQuests

`start quest`

zJobs

`zjobs add points`

`zjobs claim reward`

`zjobs remove points`