Skip to content
JiminStudio

Items

All aspects of BetonQuestAddon item creation

  • Directoryplugins
    • DirectoryBetonQuestAddon
      • Directoryitems/
        • file
      • config.yml

Full Example Item

Section titled “Full Example Item”
example_item: # id
  material: DIAMOND_SWORD
  item_name: "<gold>Epic Diamond Sword"
  lore:
    - "<gray>A sword of legends"
    - "<gray>Shining with power"
  unbreakable: true
  unstackable: false


  ItemFlags:
    - HIDE_ENCHANTS
    - HIDE_ATTRIBUTES
  Enchantments:
    SHARPNESS: 5
    UNBREAKING: 3
  rarity: RARE
  max_stack_size: 1
  Glider: false
  damage_resistant: ALWAYS_HURTS_ENDER_DRAGONS


  Components:
    hide_tooltip: true
    tooltip_style: "minecraft:italic"
    item_model: "minecraft:diamond_sword_model"
    enchantable: 1

Material

Section titled “Material”
material: DIAMOND_SWORD
  • Sets the base material of the item.
  • Use the Material enum names (e.g., DIAMOND_SWORD, STONE, etc.).

Item Name

Section titled “Item Name”
item_name: "<gold>Epic Diamond Sword"
  • The display name of the item, using MiniMessage format.
  • You can use tags like <gold> for color, <italic>, <bold> for style, etc.

Lore

Section titled “Lore”
lore:
  - "<gray>A sword of legends"
  - "<gray>Shining with power"
  • The item’s lore, also in MiniMessage format.
  • Can include multiple lines as a list.

Unbreakable / Unstackable

Section titled “Unbreakable / Unstackable”
unbreakable: true
unstackable: false
  • unbreakable: Makes the item unbreakable.
  • unstackable: Prevents the item from stacking.

ItemFlags

Section titled “ItemFlags”
ItemFlags:
  - HIDE_ENCHANTS
  - HIDE_ATTRIBUTES
  • A list of Bukkit ItemFlags to apply.
  • Example: HIDE_ENCHANTS hides enchantments, HIDE_ATTRIBUTES hides attack/defense stats.

Enchantments

Section titled “Enchantments”
Enchantments:
  SHARPNESS: 5
  UNBREAKING: 3
  • Specifies enchantments and their levels.
  • Applied using RegistryAccess to fetch the enchantment objects.

Rarity

Section titled “Rarity”
rarity: RARE
  • The item’s rarity (COMMON, UNCOMMON, RARE, EPIC, LEGENDARY).
  • Useful for GUIs or special item categorization.

Max Stack Size

Section titled “Max Stack Size”
max_stack_size: 1
  • Sets the maximum stack size for the item.
  • 1 makes it unstackable, like unique items.

Glider

Section titled “Glider”
Glider: false
  • Available in Minecraft 1.21.3+, determines if the item can act as a glider.
  • true enables gliding functionality.

Damage Resistant

Section titled “Damage Resistant”
damage_resistant: ALWAYS_HURTS_ENDER_DRAGONS
  • Available in Minecraft 1.21.3+, uses DamageTypeTags to configure damage resistance.
  • Must match the tag name in uppercase.

Components

Section titled “Components”
Components:
  hide_tooltip: true
  tooltip_style: "minecraft:italic"
  item_model: "minecraft:diamond_sword_model"
  enchantable: 1
  • hide_tooltip: Whether to hide the tooltip.
  • tooltip_style: Tooltip style (minecraft:italic, namespace:value, etc.).
  • item_model: Custom item model (NamespacedKey format).
  • enchantable: Level at which the item is enchantable (0+ means enchantable).