EpicCraftingsPlus
  • EpicCraftingsPlus WIKI
  • How to Start
  • Craftings Tutorial
  • Extra Requirements
  • Items Tutorial
  • Config.yml Tutorial
  • Inventory.yml Tutorial
  • Categories Tutorial
  • Actions
  • Crafting Places
  • Commands and Permissions
  • PlaceholderAPI variables
  • API
  • Default Files
    • Inventory.yml
    • Messages.yml
Powered by GitBook
On this page
  • Id
  • Durability
  • Name
  • Display Name
  • Lore
  • Amount
  • Custom Model Data
  • Custom Model Component Data
  • Enchants
  • Item Flags
  • Attributes
  • Color
  • Hide Tooltip
  • Tooltip Style
  • Model
  • Skull Data
  • Potion Data
  • Banner Data
  • Firework Data
  • Book Data
  • Armor Trim Data
  • NBT

Items Tutorial

PreviousExtra RequirementsNextConfig.yml Tutorial

Last updated 4 months ago

Almost all items on EpicCraftingsPlus follow the same format, here you can find information of the properties of items. An example of an item config:

item:
  id: 'DIAMOND_SWORD'
  name: "&4&lSuper Sword"
  lore:
  - "&6This is one of the best"
  - "&6swords on the server!"
  - ""
  - "&8[Created by: &c%player%&8]"
  enchants:
  - 'DAMAGE_ALL;6'
  - 'FIRE_ASPECT;3'
  item_flags:
  - HIDE_ATTRIBUTES

Remember that you don't need to manually create each crafting item. You can simply use /ecraft create <name> with an item in your hand. However, if you want to modify some of the properties of this item, this information will be helpful.

Id

The id/material of the item. Latest Versions Material: Legacy Materials:

id: 'DIAMOND_SWORD'

Durability

Durability or data value of the item.

durability: 5

Name

Custom name of the item.

  • You can use the %player% variable to set the name of the player.

  • You can use any PlaceholderAPI variable. This will be static.

  • You can use the %random_<min>_<max>% variable to generate a visual random number. (Example: %random_20_30%)

name: "&aE&bP&cI&dC &6Bow"

Display Name

This is a special attribute you can add to items, when the item doesn't have a custom name. The display name will be used in messages mainly, instead of the type/id of the item.

item:
  id: DIORITE
  display_name: "Diorita"
  amount: 1

Lore

Custom lore/description of the item.

  • You can use the %player% variable to set the name of the player.

  • You can use any PlaceholderAPI variable. This will be static.

  • You can use the %random_<min>_<max>% variable to generate a visual random number. (Example: %random_20_30%)

lore:
  - "&6This is one of the best"
  - "&6swords on the server!"
  - ""
  - "&8[Created by: &c%player%&8]"

Amount

The number of items.

amount: 32

Custom Model Data

Custom model data value of the item. Only works on 1.16-1.21.3.

custom_model_data: 1

Custom Model Component Data

custom_model_component_data:
  strings:
  - "string1"
  flags:
  - "flag1"
  - "flag2"
  floats: []
  colors: []

Enchants

enchants:
  - 'DAMAGE_ALL;6'
  - 'FIRE_ASPECT;3-5'

Item Flags

item_flags:
  - HIDE_ATTRIBUTES 

Attributes

attributes:
  - GENERIC_MAX_HEALTH;ADD_SCALAR;0.1;1ab87334-7a32-4307-b783-c5519f735260;HAND
  - GENERIC_MOVEMENT_SPEED;ADD_SCALAR;0.35;766d5332-e2b1-493d-af98-5d3046da3f0a;HAND

Color

Color of a leather armor.

color: 8439583

Hide Tooltip

Whether the tooltip should be hidden or not. 1.20.6+

hide_tooltip: true

Tooltip Style

tooltip_style: "custom:ajneb"

Model

model: "custom:model_1"

Skull Data

skull_data:
    texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTA4Yjc3MmVjYWVlNzA2MjM1ZDFhZGJmMGI5YTI5YjU4YmE5YzBlZDYwZGU2ZjEwZWZiMWE3Zjg2ZDllIn19fQ=="
    id: "ec62ea75-402c-44fb-8f71-bef0015a4634"
skull_data:
    owner: %player%

Potion Data

potion_data:
    # Format for potion effects:
    # <potion_effect>;<level>;<duration_in_ticks>
    effects:
    - INCREASE_DAMAGE;1;4800
    - WATER_BREATHING;0;12000
    extended: false
    upgraded: false
    type: UNCRAFTABLE
    # Color only works on 1.9+, you can get the Minecraft color value here:
    # https://minecraftcommand.science/armor-color
    color: 6196631

Banner Data

banner_data:
    patterns:
    - BLUE;SQUARE_BOTTOM_LEFT
    - BLUE;SQUARE_TOP_RIGHT
    - LIME;STRAIGHT_CROSS

Firework Data

# For firework rocket
firework_data:
    rocket_effects:
    - BALL_LARGE;11743532,2437522;1973019,15790320;false;true
    power: 1
# For firework star
firework_data:
    star_effect: BALL;16777215;14188952,4312372;false;false

Book Data

Information of a written book. Pages are stored in JSON format so I suggest you not to modify this manually. Hover and click events are stored, but only on 1.12+.

book_data:
    title: "Rules Book"
    generation: ORIGINAL
    author: "Ajneb97"
    pages: []

Armor Trim Data

trim_data:
    pattern: ward
    material: redstone

NBT

NBT data of this item. This is difficult to implement manually, so I suggest you not to modify this option. (Only works on 1.8-1.20.4, nbt compounds like this don't exists anymore in Minecraft 1.20.5+)

nbt:
  - Unbreakable|true|boolean

The new 1.21.4 custom model data. The flags, floats, colors and strings properties consist of a list of elements. More info here:

Enchantments of the item. Use the following format: <name>;<level> You can find all enchantment names here: . You can also set random enchantment levels using this format: <name>;<min_level>-<max_level>

Item flags of this item. You can find all item flag names here:

Attribute modifiers of this item. This is difficult to implement manually, so I suggest you not to modify this option unless you know what you are doing. Format: <attribute_name>;<operation>;<value>;<uuid>;<slot> Attribute names: Operation names: Slot names: Generate a random uuid here:

Style of the tooltip background for the item. 1.21.2+ More info here: Format: "<namespace>:<id>"

Model of the item. 1.21.4+ More info here: Format: "<namespace>:<id>"

Information of a player head with texture. You can find heads with textures and their properties here: . You can also set the skull owner of the head, even using the %player% variable to set the head texture as the player who is crafting the item.

Information of a potion item. Works for these items IDs: POTION, SPLASH_POTION, LINGERING_POTION, TIPPED_ARROW. Potion Types: Potion Effects:

Information of a banner or shield item. Use the following format for patterns: <color>;<type> Colors: Pattern types:

Information of a firework rocket or a firework star. Format for firework effects: <type>;<color1>,<color2>,...;<fade1>,<fade2>,...;<has flicker>;<has trail> Firework types: Colors:

Information of armor trim smithing templates. Works only for armor items. Only works on 1.20+. Patterns: Materials:

https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
https://helpch.at/docs/1.8/org/bukkit/Material.html
https://minecraft.wiki/w/Data_component_format/custom_model_data
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/ItemFlag.html
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/Attribute.html
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/AttributeModifier.Operation.html
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/EquipmentSlot.html
https://www.uuidgenerator.net/
https://minecraft.wiki/w/Data_component_format#tooltip_style
https://minecraft.wiki/w/Items_model_definition
https://minecraft-heads.com/custom-heads
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionType.html
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/DyeColor.html
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/banner/PatternType.html
https://hub.spigotmc.org/javadocs/spigot/org/bukkit/FireworkEffect.Type.html
https://minecraftcommand.science/armor-color
https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/meta/trim/TrimPattern.html
https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/meta/trim/TrimMaterial.html