Skip to main content

MMOItemsRepair

MMOItemsRepair is a repair station plugin for MMOItems and vanilla durability items. It provides a configurable repair GUI, recipe based material consumption, optional repair timing minigame, and safe durability handling for modern Minecraft item data.

The plugin is designed for servers that want controlled repair economies instead of unlimited anvil repairs. Administrators can decide which item types can be repaired, which materials are required, how much durability is restored, and how the repair interface should look.

Features​

  • MMOItems item repair support.
  • Vanilla damageable item repair support.
  • Configurable repair recipes and material requirements.
  • Multiple repair amount modes: full repair, percent repair, and flat durability repair.
  • Priority based repair profiles.
  • Custom GUI layout, slots, buttons, names, lore, and sounds.
  • Optional repair action minigame.
  • Repair material give command.
  • Vanilla CustomModelData material matching.
  • Minecraft 1.21.11 tooltip/component preservation after repair.
  • Vanilla durability bar synchronization after repair.
  • Players can move items in their own inventory while the repair GUI is open.

Requirements​

  • Paper or compatible Bukkit server.
  • Minecraft 1.21.x.
  • MMOItems installed and loaded before MMOItemsRepair.

MMOItemsRepair declares MMOItems as a required dependency. The server must load MMOItems successfully before this plugin can enable.

File Layout​

After the plugin starts, the main configuration files are located in:

plugins/MMOItemsRepair/

Important files:

config.yml
menu.yml
display-names.yml
lang/en_us.yml
lang/zh_cn.yml
lang/zh_tw.yml

config.yml controls language, sounds, repair rules, repair profiles, recipes, and the optional minigame.

menu.yml controls the repair GUI title, size, input slots, action slots, button icons, names, and lore.

display-names.yml controls how MMOItems and vanilla items are displayed in the repair GUI.

Quick Start​

  1. Install MMOItems.
  2. Put MMOItemsRepair into the server plugins folder.
  3. Start the server once.
  4. Edit plugins/MMOItemsRepair/config.yml.
  5. Configure at least one repair profile under repair.profiles.
  6. Run /mmoitemsrepair reload.
  7. Open the repair GUI with /mmoitemsrepair open.

The default configuration includes example repair profiles for MMOItems swords, vanilla diamond gear, and vanilla netherite gear.