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

30 lines
828 B
Markdown

## Create an ItemStack
The default way of building complex `ItemStack`s 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
```kotlin
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
![](img/sword.png)