Item Builder

On this page you can find every item related configuration that is possible to create in our plugins!

Note that you don't need to use all of these values at once, only material is required!

Example:

    material: STICK
    custom-model-data: 100
    glow: true
    lore:
    - "&fthis is a lore,"
    - "&eit can be multiple lines!"

Material:

material: DIAMOND

List of materials: CLICK

Item Name:

name: "<red>Name"

Item Lore:

  # you can define as many lines as minecraft allows
  lore:
    - "&cline 1"
    - "&eline 2"

Item Amount:

  # amount can be a number between 1 and 64
  # this value may be ignored in some situations
  amount: 1

Glowing Items:

  # should the item be enchanted? can be true of false
  glow: true

Unbreakable Items:

  # make the item unbreakable
  unbreakable: true

Item Model (1.21.4+)

  # set the item model to a diamond
  # format: namespace:key (namespace defaults to minecraft)
  item-model: "minecraft:diamond"

Custom Model Data:

  # this value is used to display textured items, can be any integer
  custom-model-data: 1

In 1.21.4, mojang reworked how custom model datas work and they made it significantly more difficult to use, however if you still need them, you can find all the types here.

Old

The item builder works with legacy custom model datas, if they are used, the plugin will put as the first "floats" value

custom-model-data: 1

Floats

  custom-model-data:
    floats: # flag list, values can be any number
      - 1.0
      - 5

Strings

  custom-model-data:
    strings: # string list, any string can be used
      - example

Flags

  custom-model-data:
    flags: # flag list, values can be true or false
      - true
      - false

Colors

  custom-model-data:
    colors: # color list, format: RRR, GGG, BBB
      - "255, 200, 150"

Enchants:

  # you can add as many enchants as you want
  # the format is enchant_name:enchant_level
  enchants:
    - protection:4

List of enchantments: CLICK - use the 'Minecraft ID Name' parts

Item Flags:

  # you can add as many item flags as you want
  item-flags:
      - HIDE_ENCHANTS

List of item flags: CLICK

Player Heads:

    # the material must be PLAYER_HEAD
    material: PLAYER_HEAD
    # replace base64-here with the base64 of the skull
    texture: "base64-here"

Potions:

    # the material must be POTION
    material: POTION
    # this value is RGB separated by commas
    color: "255, 0, 0"

RGB generator: CLICK

Leather Armors:

    # the material must be a leather armor piece
    material: LEATHER_HELMET
    # this value is RGB separated by commas
    color: "0, 255, 255"

RGB generator: CLICK

Tipped Arrows:

    # the material must be TIPPED_ARROW
    material: TIPPED_ARROW
    # this value is RGB separated by commas
    color: "255, 255, 0"

RGB generator: CLICK

Advanced

SNBT

1.20.4 and older:

    snbt: |-
        {
            DataVersion: 3578,
            Count: 1b,
            id: "minecraft:turtle_helmet",
            tag: {
                Damage: 0,
                axboosters-item: "flying-helmet",
                display: {
                    Lore: [],
                    Name: '{"italic":false,"extra":[{"bold":true,"color":"#0099FF","text":"F"},{"bold":true,"color":"#009CFF","text":"l"},{"bold":true,"color":"#009FFF","text":"y"},{"bold":true,"color":"#00A2FF","text":"i"},{"bold":true,"color":"#00A4FF","text":"n"},{"bold":true,"color":"#00A7FF","text":"g"},{"bold":true,"color":"#00AAFF","text":" "},{"bold":true,"color":"#00ADFF","text":"h"},{"bold":true,"color":"#00B0FF","text":"e"},{"bold":true,"color":"#00B3FF","text":"l"},{"bold":true,"color":"#00B5FF","text":"m"},{"bold":true,"color":"#00B8FF","text":"e"},{"bold":true,"color":"#00BBFF","text":"t"}],"text":""}'
                }
            }
        }

1.20.5 and newer:

    snbt: |-
        {
           DataVersion: 3955,
           components: {
               "minecraft:custom_data": {
                   axboosters-item: "flying-helmet"
               },
               "minecraft:custom_name": '{"extra":[{"bold":true,"color":"#0099FF","text":"F"},{"bold":true,"color":"#009CFF","text":"l"},{"bold":true,"color":"#009FFF","text":"y"},{"bold":true,"color":"#00A2FF","text":"i"},{"bold":true,"color":"#00A4FF","text":"n"},{"bold":true,"color":"#00A7FF","text":"g"},{"bold":true,"color":"#00AAFF","text":" "},{"bold":true,"color":"#00ADFF","text":"h"},{"bold":true,"color":"#00B0FF","text":"e"},{"bold":true,"color":"#00B3FF","text":"l"},{"bold":true,"color":"#00B5FF","text":"m"},{"bold":true,"color":"#00B8FF","text":"e"},{"bold":true,"color":"#00BBFF","text":"t"}],"italic":false,"text":""}',
               "minecraft:enchantment_glint_override": 1b
           },
           count: 1,
           id: "minecraft:turtle_helmet"
        }

SNBT is the best format to use for complex (custom) items, it can store all nbt that minecraft supports, however, it is much more complicated than our item builder.

Last modified: 16 December 2024