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:

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 MiniMessage 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 : for output, or the keys of the items section. 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 discord. Any questions that cannot be answered with the content on this page can be asked there.
• Reporting a bug? please open a ticket on github.

Credits

• icon