Artillex-Studios Documentation Help

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

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"

Leather Armors:

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

Tipped Arrows:

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

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