Skip to main content

Repair Profiles

Repair profiles define which items can be repaired and which recipes are available.

Profiles are stored under:

repair:
profiles:

The plugin sorts profiles by priority from high to low. If multiple profiles match the same item, the higher priority profile is checked first.

Basic Structure

repair:
profiles:
profile_key:
priority: 100
target:
provider: MMOITEMS
recipes:
recipe_key:
display-name: "&eRepair Recipe"
repair:
mode: PERCENT
value: 25
ingredients:
ingredient_key:
provider: VANILLA
material: DIAMOND
amount: 2

Target Providers

MMOItems Target

target:
provider: MMOITEMS
mmoitems-types:
- SWORD
mmoitems-ids:
- EXAMPLE_SWORD

Supported fields:

provider: MMOITEMS
match-any-mmoitems: true
mmoitems-types:
- SWORD
mmoitems-ids:
- EXAMPLE_SWORD

match-any-mmoitems: true allows all MMOItems items.

mmoitems-types limits the profile to specific MMOItems types.

mmoitems-ids limits the profile to specific MMOItems IDs.

Vanilla Target

target:
provider: VANILLA
groups:
- DIAMOND_GEAR

Supported fields:

provider: VANILLA
match-any-vanilla-damageable: true
materials:
- DIAMOND_SWORD
- DIAMOND_CHESTPLATE
groups:
- DIAMOND_GEAR

match-any-vanilla-damageable: true allows all non-MMOItems damageable vanilla items.

materials limits the profile to exact Bukkit material names.

groups uses built-in material groups.

Vanilla Target Groups

Supported groups:

SWORDS
AXES
PICKAXES
SHOVELS
HOES
BOWS
CROSSBOWS
TRIDENTS
SHIELDS
HELMETS
CHESTPLATES
LEGGINGS
BOOTS
DIAMOND_GEAR
NETHERITE_GEAR

Repair Modes

PERCENT

Repairs by a percentage of the item's maximum durability.

repair:
mode: PERCENT
value: 25

If an item has 1000 max durability, this repairs 250 durability points. The result is capped at full durability.

FLAT

Repairs a fixed number of durability points.

repair:
mode: FLAT
value: 350

FULL

Repairs the item to full durability.

repair:
mode: FULL
value: 0

value is ignored for FULL.

Ingredients

Each recipe can require one or more ingredients.

Vanilla Ingredient

ingredients:
diamond:
provider: VANILLA
name: "&bDiamond"
material: DIAMOND
amount: 2

Supported fields:

provider: VANILLA
material: DIAMOND
amount: 2
name: "&bDiamond"
custom-model-data: 10001

For vanilla ingredients, material and amount are required.

If name is configured, the item must have the same display name.

If custom-model-data is configured, the item must have the same CustomModelData.

The give command also applies the configured name and custom-model-data.

MMOItems Ingredient

ingredients:
shard:
provider: MMOITEMS
name: "&6Weapon Fragment"
type: MATERIAL
id: WEAPON_FRAGMENT
amount: 2

Supported fields:

provider: MMOITEMS
type: MATERIAL
id: WEAPON_FRAGMENT
amount: 2
name: "&6Weapon Fragment"

For MMOItems ingredients, at least one of type or id must be configured.

If both are configured, both must match.

Example: MMOItems Sword Repair

repair:
profiles:
mmoitems_sword_basic:
priority: 100
target:
provider: MMOITEMS
mmoitems-types:
- SWORD
recipes:
fragment_repair:
display-name: "&eBasic Sword Repair"
repair:
mode: PERCENT
value: 25
ingredients:
shard:
provider: MMOITEMS
name: "&6Weapon Fragment"
type: MATERIAL
id: WEAPON_FRAGMENT
amount: 2
catalyst:
provider: VANILLA
name: "&bExperience Bottle"
material: EXPERIENCE_BOTTLE
amount: 4

Example: Custom Vanilla Repair Tool

repair:
profiles:
vanilla_tool_repair:
priority: 60
target:
provider: VANILLA
groups:
- DIAMOND_GEAR
recipes:
repair_tool:
display-name: "&bRepair Tool"
repair:
mode: PERCENT
value: 30
ingredients:
tool:
provider: VANILLA
name: "&bEquipment Repair Tool"
material: GOLDEN_HORSE_ARMOR
custom-model-data: 810001
amount: 1

Give command:

/mir give repair_tool tool
/mir give repair_tool tool Steve 16