Item Gotcha

Code | Download

Config.yml

stone:
  id: STONE
  amount: 32

advanced_stone:
  id: STONE
  amount: "32"
  name: "&c{player}'s Stone"
  lore:
    - "A dummy Stone"
    - ''
    - "&kYes, it's very dummy and stupid"

Create an item

The config should be easy if you are familiar with Button and, particularly, Dummy Button
Yes, you can think of the config.yml as a Menu setup, but with dummy buttons
Therefore, if you want to make an item, you can set it up in the config.yml as how you did in your menu (Name, Material, Lore, etc)

Command

Command	Permission	Description
`giveitem <item_name>`	bettergui.items	Give `<item_name>` to the player

Action

Format

give: <item>
give: <item>, <amount>
give: <material>, <amount>

Description

This action will give the player the <item> (specified in the config.yml) or the <material> with the <amount>

Example

give-stone:
  slot: 1
  id: stone
  name: "&cGive me stone"
  command: "give: stone"

give-advanced-stone:
  slot: 2
  id: stone
  name: "&cGive me advanced stone"
  command: "give: advanced_stone"

give-kits:
  slot: 3
  id: diamond sword
  name: "&cGive kits"
  command:
  - "give: DIAMOND_SWORD"
  - "give: STONE, 10"

Requirement

Format

item: <item>

item:
  value: <item>
  take: <true/false>

item: <item>, [amount]

item:
  value: <item>, [amount]
  take: <true/false>

item: "<item>, [amount]: [format]"

item:
  value: "<item>, [amount]: [format]"
  take: <true/false>

Description

This requirement will check if the player has the <item> (specified in the config.yml) in his inventory
You can set the amount value to specify the amount of <item> the requirement should check
You can set the format value with 2 values
- true if you want the requirement to convert the <item> to the final item and check that item with the player's inventory
- false if you want the requirement to check simplier (the material, then item modifiers, and finally the amount).
You can set the take value (true or false) to allow/disallow the plugin to take the items of the player alter checking successfully

Example

take-stone:
  slot: 1
  type: predicate
  button:
    id: stone
    name: "&cTake Stone"
  click-requirement:
    left:
      take-one: # Take one stone
        item: "stone"
    right:
      take-ten: # Take ten stone
        item: "stone, 10"
    middle:
      take-multi: # Take 10 stone and 1 cobblestone
        item:
          value:
            - "stone, 10"
            - "cobblestone"
          take: true
    default:
      check-stone: # Check (not take) if the player has 20 stone
        item:
          value:
            - "stone, 20"
          take: false

BetterGUI