smaug

## Smaug An interactive crafting plugin for Minecraft servers to create custom items. The plugin allows you to define custom items either in it's own plugin configuration or register your items externally using the API. ### Features This plugin's primary purpose is to allow you to: - Define recipes/conversions to create custom items by interacting with stations (plans to integrate MythicMobs/Crucible) - Define custom items in-configuration as well as register items externally Example Usage: <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/aLXckUpuREM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> ### Usage Defining an item in-configuration can be done like so: item.yml ``` test: material: DIAMOND display-name: <#000000>This is a test item! item-model: minecraft:stone ``` Note: all text-based fields such as display-name, or lore can use (https://docs.advntr.dev/minimessage/format) format. You can inherit properties additively by using the key 'inherits' ``` test2: display-name: <#0000ff>This is the second test item! inherits: test ``` Defining a recipe: a) Recipes accept item keys in the format <namespace>:<key> for output, or the keys of the items section. <namespace> is optional, as the plugin will infer if the key is a member of the minecraft namespace it will default to that, an example is given in the recipe under 'test.output'. b) Alternatively, if you want to specify a registered item from a specific namespace, e.g. smaug, you can refer to it either by test, or smaug:test if there is a conflict with a key in another namespace. c) Recipes also allow for forward references, as this is the only way currently to register a recipe, meaning, the recipe expects that the item referenced will be present in the registry at the time the recipe is parsed. recipe.yml ``` test: output: gold_ingot # a) amount: 2 # output amount actions: 10 # optional, defaults to 0 ingredients: items: #item_key: amount test2: 2 test_hammer: 9 type: smaug:anvil #station type ``` ### Links - Support for the plugin and it's API are available on (https://discord.gg/yrnqw5S2). Any questions that cannot be answered with the content on this page can be asked there. - Reporting a bug? (https://www.github.com/mintychochip/smaug). ### Credits - (https://www.deviantart.com/elizabethholmes/art/Smaug-s-eye-No-2-702282394)