🗡️Items

how to config an item

Items:

Use & or § for colored string

internal_name:
  Type: <item type>
  Data: <item data 1.13-> <custom model data 1.14+>
  Display: <item name>      
  Rate: <rating>
  Description:
  - <description> <amount>
  ...
  Stat:
  - <stat> <amount>
  ...
  Ability:
  - <ability> <amount>
  ...
  Lore: 
  - <lore 1>
  - <lore 2>
  - <lore 3>
  ...
  Enchants: 
  - <enchantment>:<level>
  - <enchantment>:<level>
  ...
  Flags:
  - <flag>
  ...
  Unbreak: <true/false>
  Gems: <range>
  Buffs: 
  - <Buff> <tier>
  ...

Item Format:

Format

in lore-format.yml {line} <string> a line appear if below still have other line Example: 'line} &aStat:' will not appear if stat was not setted

item-format:
- '{line} &aDescription:'
- '#description#'
- '{line} &aStat:'
- '#stat#'
- '{line}'
- '#ability#'
- '{line}'
- '#buff#'
- '{line}'
- '#lore#'
- '{line}'
- '#gem#'

#description-format:
description:
- '#type#'
- '#leveling#'
- '#rate#'
- '#durability#'
- '#require#'

# See in /forge stat
attack-stat:
- '#physic_damage#'
- '#physic_piercing#'
- '#physic_lifesteal#'
- '#attack_speed#'
- '#pvp_damage#'
- '#pve_damage#'
- '#crit_chance#'
- '#crit_damage#'
- '#accuracy#'
- '#attack_speed#'

# See in /forge stat
defense-stat:
- '#heal#'
- '#physic_armor#'
- '#magic_armor#'
- '#pvp_defense#'
- '#pve_defense#'
- '#dodge_chance#'
- '#block_chance#'
- '#absorb_chance#'
- '#parry_chance#'
- '#resistance#'

# See in /forge stat
magic-stat:
- '#magic_damage#'
- '#magic_piercing#'
- '#magic_lifesteal#'
- '#magical_attack#'

# See in /forge stat
other-stat:
- '#health#'
- '#speed#'
- '#xp_boost#'

# See in /forge stat
ability:
- '#burn#'
- '#freeze#'
- '#lightning#'
- '#blind#'
- '#weak#'

Type

Make sure you choose correct material (based on minecraft version) item type - vanilla Material - found in https://helpch.at/docs/1.17.1/org/bukkit/Material.html,... Example: STONE, DIRT, DIAMOND_SWORD, NETHERITE_HELMET,...

Data

1.8-1.13: item data 1.14-1.17: custom model data Example: 1,2,3,...

Display

Display name of item Example: §a§lSupperForge

Rate

rate of item, can found in attributes.yml, used to determine blueprint price, leveling infomation. Example: 'epic'

Description

durability or something else such requirement, leveling, item type,... i divide stat and description for display in two part, you can see in lore-format.yml Example: - 'durability 1000' - 'level 5'

Stat

set stat for item (see stats in attributes.yml) Example: - 'physicdamage 10~20' - 'critchance 15.6'

Ability

set ability for item (see abilities in attributes.yml) Example: - 'lightning 10~20' - 'blind 15.56'

Lore

Lore of item Example: - '§aLore' - '§6Legendary' - '§4Red Lore!!!'

Enchants

found in https://helpch.at/docs/1.17.1/org/bukkit/enchantments/Enchantment.html level should be integer (1,2,3,4,...) Example: - DAMAGE_ALL:10 - DURABILITY:5

Flags

found in https://helpch.at/docs/1.17.1/org/bukkit/inventory/ItemFlag.html Example: - HIDE_ATTRIBUTES - HIDE_ENCHANTS

Unbreak

true/ false is item unbreakable

Gems

range, example '1-3' or '3-5',... amount of gem slot in item

Buffs:

set buff for item Example: - 'strength 3-5' - 'speed 1-6'

Examples:

supper_sword: Type: IRON_SWORD Data: 0 Display: '&a&lSupper Sword' Lore: - '&7Basic sword can be created' - '&7By: &eZenDev' - '&7It is so &aSupper' Stat: - 'physic_damage 5~7' - 'health 2' - 'crit_chance 30~50' Enchants: - DAMAGE_ALL:3 - DURABILITY:10 - MENDING:1 Flags: - HIDE_ENCHANTS - HIDE_ATTIBUTES - HIDE_UNBREAKABLE Gems: '1~3' Unbreak: true