Recipe Configuration

The recipes allow players to create unique items through their profession and using their workstations.

Recipe Creation

Before creating a recipe, one must first create an item in the file matching the profession. This is done by going in the /RPPRofessions/items/ folder to create a .yml file named after the desired profession. E.g. /RPPRofessions/items/alchemist.yml .

All the items created inside that .yml file will be linked to the profession of the file name.

When creating the .yml file, the profession id is not case sensitive. This mean that, if you created a profession which id is ENCHANTER, the file can either be named enchanter.yml or ENCHANTER.yml.

General Options

These options are common to all kind of recipes.

Mandatory Options

These options must be defined otherwise the plugin won't load the recipe.

Station

The workstation used to craft the item. It obviously must be set to a workstation usable by this profession.

station: FORGE

If you want to use the vanilla crafting table as the recipe station set the option to 'WORKBENCH'

station: WORKBENCH # The recipe will use the vanilla crafting table

Category

The category in which to sort the recipe. This is used to classify the recipes in the recipes menu.

category: MATERIAL

Additional Options

These options are not required as they all have default value that would be chosen should you decide not to do so.

Required level

Set the required profession level in order to craft this item. Default value is 1.

required-level: 50

Level gain

How many levels should be gained when completing this craft. Default value is 1.

level-gain: 2

Level cap

The maximum level the player can gain level from crafting this item. Default value is required-level + 25.

level-cap: 75

Default

If the players should know how to craft this item as soon as they reach the required level. Setting it to false will force players to learn the recipe by finding and right clicking the recipe for this craft. By default the value is set to true.

default: false

Dynamic

Whether the recipe is dynamic, i.e. the crafter must complete the workstation mini-game in order to complete the craft. Default value is false.

dynamic: true

Shaped Recipe Options

These options are common to all recipes using 3x3 crafting grid.

Recipe

The actual recipe. Each number corresponds to a position in the crafting grid, with 0 being the top left corner and 8 the bottom right corner.

recipe:
  0: GOLD_NUGGET
  2: GOLD_NUGGET
  4:
    material: POTION
    potion-type: WATER
  6: GOLD_NUGGET
  8: GOLD_NUGGET

You can use RPProfession items in the recipe as well:

recipe:
  1: BRONZE_INGOT
  4: BRONZE_INGOT
  7: STICK

You can also use items from compatible plugins:c

MMOItems: "mmo-item:"/"mi:"

recipe:
  0: COPPER_INGOT
  1: COPPER_INGOT
  2: COPPER_INGOT
  3: mi:TIN_INGOT
  4: mi:TIN_INGOT
  5: mi:TIN_INGOT
  6: COPPER_INGOT
  7: COPPER_INGOT
  8: COPPER_INGOT

MythicMobs: "mm-item:"/"mm:"

recipe:
  1: REDSTONE
  3: GLOWSTONE_DUST
  4: mm:skeleton_sword
  5: GLOWSTONE_DUST
  7: REDSTONE

Reagent

The reagent is an additional item that is required in order to make the recipe work. The crafter must place the required reagent in the bottom slot of the crafting recipe in order to successfully create their item.

reagent:
  material: REDSTONE
  amount: 3

Brewing Recipe Options

These options only work for recipes using the brewing stand, i.e. dynamic recipes in workstations with BREWING_STAND set as the station option.

Receptacle

The item that must be placed in the potions slots, i.e. the 3 bottom slots of the brewing inventory. It can be anything.

receptacle:
  material: POTION
  potion-type: INSTANT_HEAL
  upgraded: true

Reagent

The item that must be placed in the top slot of the brewing inventory. It can be anything.

reagent: GOLDEN_APPLE

Not to be confused with the reagent option of shaped recipes.

Fuel

The item that must be placed in the fuel/blaze powder slot of the brewing inventory, i.e. the leftmost slot of the inventory. It can be anything.

# Using custom RPPRofessions item
fuel: WEAK_INFUSER

Fuel consumed

Whether the brewing stand must be fueled with blaze powder and the recipe will consume one unit of it. Default value is false, i.e. the potion can be crafted without blaze powder loaded in the brewing stand.

fuel-consumed: true

Using Soft Dependencies

You might want to use items from other plugins as your recipe result, meaning let players craft items from other resources than RPProfessions. This can help you create even more interesting and unique professions.

Instead of configuring your items from scratch using options like material, display-name, etc... you can simply import an item.

MMOItems

To use an item from MMOItems as your recipe result:

mmo-item: IRON_CUTLASS

MythicMobs

To use an item from MythicMobs as your recipe result:

mm-item: bandit_tunic

Oraxen

To use an item from Oraxen as your recipe result:

oraxen-item: ruby_helmet

Check out the Item Configuration Examples page of the wiki for full examples of items and recipes configurations.