GUI Menus

GUI file: /plugins/PLUGINNAME/Language

Hex Colors

You can use hex colors by inserting them in this format: {hex}
Example: {#4287f5}

Slots

You can combine slot ranges. This includes slots for items and slots for list entries. Example:

slots: 
  - '1-5'
  - '7'
  - '8-9'

It's exactly the same for the list menus entries definitions:

entries: 
  - '1-5'
  - '7'
  - '8-9'

Item Types

Entry

Item keys starting with the "entry_" prefix apply to list menus in the defined entries ranges.

Child

Child items appear as feedback when clicking on specific items. For example, letting a player know that they can't untrust a claim owner. These items are temporary and will disappear after 1.5 + 1.5 * lore length seconds.

Refresh

These items trigger a complete refresh of the menu when clicked. In the default configuration, they're mostly used in list menus.

Placeholder

Item keys starting with the "placeholder_" prefix are placeholders.

Optional Item Parameters

All of our GUI menus feature full customization of the whole item language and also positions etc.
Here are some hidden features:

Disable Items:

Add enabled: false to the item.

Set custom Model-Data:

Add model-data: NUMBER to the item.

Set Item Amount

Add amount: NUMBER to the item.

Display as enchanted

Add enchanted: true to the item.

Execute commands at Click

This supports PlaceholderAPI placeholders.

        item:
          name: 'Name'
          lore:
          - 'Lore'
          material: STONE
          slots: 26
          commands:
          - 'say test'

Add your own Items to a Menu

1. Add the custom section to the menu in your GUI file.
2. Configure the item like default items.

  main:
    title: '&8Main Menu'
    items:
      default:
        lands:
          name: '&2&lYour Lands'
          lore:
          - '&8✖ &7Manage your lands:'
          - '   &7This includes your own lands'
          - '   &7and lands, in which you''re'
          - '   &7trusted.'
          - ''
          - '    &8• &7Own: {own}'
          - '    &8• &7Trusted: {trusted}'
          material: GRASS_BLOCK
          slots: 20
        
      custom:
        my-item:
          name: 'Name'
          lore:
          - 'Lore'
          material: STONE
          slots: 26

Conflicting Slot Ranges

If you get a warning in your console that two items have conflicting slot ranges, then you need to edit your GUI file. Find the conflicting items and edit their slots in a way that they don't overlap. Otherwise, one of the two items won't be displayed.