⚙️ Items | Custom Items

In this section you will find detailed information about the available items, as well as instructions for creating customized menu items.

Items

In this section you won't be able to add new items to the menu, only edit the current ones. If you want to add more items use the custom-items section

Item | Material

Supported material values:

material: TEXT

Item | ItemFlags

There is an item_flags: section where you can add the necessary flags for your item.

item_flags:
  - HIDE_ATTRIBUTES

Custom Items

In this section you will be able to create your customized items. Each item you add in this section must have a different name.

Remember that to execute an action, you can read Actions to find out which one you need. For more information you can read ❔ FAQ

Section

For the custom items section, you will need to create a name identifier for the item, as shown in the following example: 'close'.

    custom-items:
      close:  # <-- Name ID
        material: BOOK
        amount: 1
        display_name: '&cClose'
        lore: [ ]
        slot: 49
        actions:
          - "[close]"

Slots

In this section, you can specify in which slots the articles will be created. Below are some examples of how to assign articles to different slots:

slot: 10 # <--  The item is created in slot 10
slots: [1-10] # <-- Create the item in slots 1 to 10
slots: # <-- Create the item in slots 1, 2 and 3
- 1
- 2
- 3

You can use these formats to customize item locations according to your needs.

Actions

Actions allow you to execute console commands, send messages, send titles, send messages in the bossbar and even use mini message

Remember that you can use placeholders in any action. For example %player_name%.

Prefix

Description

[message]

If the prefix is [message] and the player is not in parkour (or is a new player), a message is sent to the player.

[command]

If the prefix is [command] and the player is not in parkour, a server command is executed. You can use placeholder like %player_name% to get the player's name

[player]

If the prefix is [player] and the player is not in parkour, a chat action is performed for the player

[sound]

Send a sound to the player, add volume, pitch using ;

[broadcast]

Send a global message, to all connected players

[close]

Close the player's inventory

[openmenu]

You will be able to open an inventory menu using its section name in menus.yml

[title]

Uses the format Title;Subtitle;fadeint;stay;fadeout

[actionbar]

It will allow you to send a message in actionbar.

[minimessage]

It will allow you to send the minimessage format that will be sent to the player.

https://docs.advntr.dev/minimessage/format.html

[minibroadcast]

It will allow you to send the mini-message format to all connected players. https://docs.advntr.dev/minimessage/format.html

[log]

It will display a message on the server backend.

[firework]

Launches a firework with the desired configuration [firework] colors=RED,BLUE;fade=WHITE;type=BALL_LARGE;power=2;flicker=true;trail=true

[permission]

Adds permissions to the player (Requires Vault)

[!permission]

Remove player permissions (Requires Vault)

    ##
    ## You can use {player} to get the name of the player or
    ##
    ## Remember to install PlaceholderAPI and load the expansion Player :
    ## /papi ecloud download Player or %player_name% will not work.
    ##
- '[command] eco give {player} 10000 <delay=40>'  # Gives 10,000 coins to the player after 40 ticks
#- '[chance=50] [command] say Hi {player}' # With a 50% probability, the server says "Hi" to the player.
#- '[player] /rewards' # Execute the /rewards command as the player
#- '[message] &aYou have correctly claimed your reward' # Sends a confirmation message to the player
#- '[sound] BLOCK_NOTE_BLOCK_HARP;1.0f;1.0f' # Plays a sound to the player SOUND;YAW;PITCH
#- '[broadcast] &8» &eThe player &7{player} &ehas claimed his &7Basic &ereward using &7&o(&a/rewards&7)'  # Public message announcing the reward
#- '[title] &a&lCLAIMED;&fsuccess;10;20;10' # Displays a title to the player
#- '[close]' # Closes the player's inventory
#- '[actionbar] &aYou have correctly claimed your reward' # Send a message in the actionbar to the player

# MiniMessage > https://docs.advntr.dev/minimessage/format.html#minimessage-format
#- '[minimessage] <MiniMessage>'
#- '[minibroadcast] <MiniMessage>'

Sub Actions

Examples:

It is important to maintain the space between chance and action.

Prefix
Description

[chance=50]

Add chance to your action

<delay=20>

Add a delay to your actions.

actions:
 - "[chance=50] [command] say Hi %player_name%"
actions:
 - "[command] say Hi %player_name% <delay=20>"

Previous❔ FAQNext📙 Support

Last updated