Files
KSpigot/guide/docs/extensions/itembuilder.md
mooziii ed338a712c KSpigot 1.19 (#50)
* Use new papermc repo url

* Update gradle plugins

* Update paper dependencies to 1.19 and bump version

* Package renames

* Update to kotlin 1.7.0

* Update kotlinx-serialization-json to 1.3.3

* Update kotlinx-coroutines to 1.6.2

* Correct version bump

* Update versions in gradle_example.md

* update some guide stuff

Co-authored-by: l4zs <business@l4zs.de>
2022-06-09 21:27:08 +02:00

828 B

Create an ItemStack

The default way of building complex ItemStacks using just Spigot is often painful to use and confusing for beginners.

With KSpigot's item builder you have an easy to use builder DSL. Additionally, it provides an easy way to update the ItemMeta of an ItemStack, which is often needed.

Example use of the item builder

val sword = itemStack(Material.GOLDEN_SWORD) {
    amount = 3
    addEnchantment(Enchantment.KNOCKBACK, 2)
    meta {
        name = literalText("Magic Sword") {
            color = KColors.GOLD
        }
        isUnbreakable = true
        addLore {
            +"This sword is truly special."
            +"Try it!"
        }
        customModel = 1001
        flag(ItemFlag.HIDE_UNBREAKABLE)
    }
}

This creates the following item