Skip to content

Menu Item

SuperRonanCraft edited this page Jun 1, 2019 · 16 revisions

Create/Identify the item which to open the menu with

Menu-Item:
  Name: 'Name of item'
  Item: 'anvil'
  Lore:
  - '&7Line #1'
  Give-Join: true
  Give-Slot: 0
  Give-Delay: 0
  Item-Move: true
  Item-Drop: true
  Ignore-Amount: true
  Ignore-Durability: true
  Ignore-Meta: true

Summary

Item

Required? Type Supports Placeholders?
Yes String Yes

Set the item here. The format is <Item>:[Data]:[Amount]
Supports Numerical and String item ids!
Data and Amount are numerical but optional.
Numerical Placeholders can be used in data and amount.


Name

Required? Type Supports Placeholders?
No String Yes

Set the display name of the Item.
Make sure to surround the name with ' ' (single quotes)


Lore

Required? Type Supports Placeholders?
No StringList Yes

A list of text that will be displayed in the items lore.

Lore:
- '&aHello %player_name%'
- '&cYour UUID is %player_uuid%!'

Give-Join

Required? Type Supports Placeholders? Default
No Boolean No False

Should the item be given on join? Else the player must obtain the item another way, or set the item to a gineric item.
Ex: If the Item is set to wool:1:32, the player must be holding wool to open the assigned menu.


Give-Slot

Required? Type Supports Placeholders? Default
No Integer No 0

The slot in which the item should be placed in the players inventory.
If an item is already there, no item will be given. If an item is in the way, that item will be moved.


Give-Delay

Required? Type Supports Placeholders? Default
No Integer No 0

Sets a delay (in seconds) that the item is given to the player.
Usefull for servers, that have starter-kits or a Auth-plugin like AuthMe.


Permission

  • Give

    Required? Type Supports Placeholders? Default
    No Boolean No True

    Should we give the item to the player even if they do not have the permission advancedcustommenu.open.<menu>?

  • Message

    Required? Type Supports Placeholders? Default
    No StringList Yes Config NoPermission:

    Set a list of messages when the player does not have the permission advancedcustommenu.open.<menu> to open the menu with the menu-item item.
    Set this to '' to disable the default message!


Item-Move

Required? Type Supports Placeholders? Default
No Boolean No True

Should the player be able to move the item in their inventory?


Item-Drop

Required? Type Supports Placeholders? Default
No Boolean No True

Should the player be able to drop the Item?


Ignore-Amount

Required? Type Supports Placeholders? Default
No Boolean No False

Should we ignore the Amount an item has when checking if the item in an Item-Menu?


Ignore-Durability

Required? Type Supports Placeholders? Default
No Boolean No False

Should we ignore the item Durability when checking if the item in an Item-Menu?


Ignore-Meta

Required? Type Supports Placeholders? Default
No Boolean No False

Should the plugin ignore the item Meta when checking if the item in an Item-Menu?


Enchantments

Required? Type Supports Placeholders?
No StringList Yes

List of enchantments to give an item, more enchants here
The format is '<enchantment>:<level>', the level must be a number or a numerical placeholder!


Hide-Flag

Required? Type Supports Placeholders?
No Integer No

Can be used, to hide certain flags.
To hide multiple flags just use the sum of the flags you want to hide. For example 63 hides all flags, while 7 hides Attributes, Destroys and Enchantments.

Values:

  • 1 = Attributes
  • 2 = Destroys ("Can destroy: [Block]")
  • 4 = Enchantments
  • 8 = Placed-On ("Can be placed on [Block]")
  • 16 = Potion-Effects
  • 32 = Unbreakable

Skull-Owner

Required? Type Supports Placeholders?
No String Yes

Set the name of whos skin to display on a skull item. If this section is filled, the item will be replaced with a Skull.

You can use %player_name% to show the head of the player that opens the menu.
All heads are cached until the server is reloaded/restarted to hold off requests!
Valid Nodes

  • LINK: You can state the link to a head texture (ex: minecraft-heads.com)
  • PLAYERNAME: The name of the player you want to set the head as (Disclaimer: If the player has never joined, this may take time to load)

Egg-Type

Required? Type Supports Placeholders?
No String No

The entity egg type, view valid entity types here Will replace current item with a random spawn egg (if invalid)


Color

Required? Type Supports Placeholders?
No String No

The color to give leather armor, tipped arrows or potions, generate color codes here
Will replace current item (if invalid) with a random valid item
Disclaimer: There is no way of removing the color indicator, as it is client side!
Valid Entries:

  • <red>, <green>, <blue> Each color ranges from 0 to 255
  • <raw rgb> The raw color value, such as '16711680' for red
  • #RRGGBB R, G and B range from 0-9 and A-F

Banner-Pattern

Required? Type Supports Placeholders?
No String No

The pattern to apply to a banner, this uses a pattern generated by NeedCoolShoes.com/banner When you are happy with your banner, use this code as your value:
Image