🔨 OmniRepair

Repair Vanilla & RPG Items Safely. MMOItems Supported.

📋 Overview

OmniRepair is a lightweight, performance-focused Minecraft repair plugin that supports both vanilla items and MMOItems custom equipment. Built with clean architecture and production-ready code.

✨ Key Features

Universal Durability Detection — Vanilla tools/armor/weapons + MMOItems custom durability
Simplified Repair GUI — 27-slot interface with 3 buttons (Repair Hand, Repair All, Close)
Multiple Payment Methods — Vault economy, XP levels, item costs, or free repair
NBT Preservation — Safe cloning with full enchantment/lore/custom data protection
Blacklist System — 4-tier filtering: materials, lore, names, MMOItems IDs
Anvil Protection — Prevents MMOItems from being enchanted in vanilla anvils
Soft Dependencies — Graceful degradation without required plugins

🎮 Usage

Commands

Command	Description	Permission
`/repair`	Open repair GUI for yourself	`omnirepair.use`
`/repair <player>`	Open repair GUI for another player	`omnirepair.admin`
`/repair reload`	Reload configuration	`omnirepair.admin`
`/repair debug`	Toggle debug mode	`omnirepair.admin`

GUI Layout

┌─────────────────────────────────────────────────────────┐
│                   🔨 RPG Mender                         │
├─────────────────────────────────────────────────────────┤
│  [    ] [    ] [    ] [    ] [Close] [    ] [    ] ... │
│  [    ] [Hand] [    ] [ All ] [    ] [    ] [    ] ... │
│  [    ] [    ] [    ] [    ] [    ] [    ] [    ] ... │
└─────────────────────────────────────────────────────────┘

Slot 10 (Repair Hand) — Repair item in your hand
Slot 12 (Repair All) — Repair all damaged items in inventory
Slot 4 (Close) — Close the GUI

⚙️ Configuration

Main Settings (`config.yml`)

settings:
  debug: false
  support-mmoitems: true
  use-economy: true
  cost-per-percent: 10.0
  max-cost: 5000.0
  min-cost: 5.0
  max-bulk-repair: 360

Economy Options

Method	Config	Description
Vault Economy	`economy.enabled: true`	Withdraw from player balance
XP Levels	`economy.use-xp-cost: true`	Deduct XP levels
Item Cost	`economy.use-item-cost: true`	Consume specific items
Free Repair	`omnirepair.free` permission	Bypass all costs

Blacklist System

blacklist:
  materials:
    - BEDROCK
    - BARRIER
  lore-contains:
    - "&lEVENT ITEM"
    - "Unrepairable"
  name-contains:
    - "Event Item"
  mmoitems-ids:
    - "EXAMPLE_SWORD_EVENT"

MMOItems Integration

mmoitems:
  enabled: true
  custom-cost-multiplier: 1.5
  sync-lore: true
  lore-format:
    enabled: true
    line: "&7Durability: &a{current} &7/ &a{max} &7(&e{percent}%&7)"
    position: "ADD_BOTTOM"

🛡️ Safety & Protection

Protection	Implementation
NBT Preservation	Clone + verify: enchantments, display name, lore, custom model data, PDC keys
Soulbound Check	Scan lore for soulbound keywords from config
Anvil Protection	Block MMOItems from anvil enchant (prevents EXP leak)
Blacklist System	4-tier: material, lore-contains, name-contains, MMOItems IDs
Cost Cap	`max-cost` and `min-cost` prevent exploitation
Rollback Safety	Clone item BEFORE repair; if fails, original unchanged

🔌 Plugin Integrations

Plugin	Status	Method	Fallback
MMOItems `6.9+`	✅ Soft Dependency	Reflection API + NBT PDC	NBT-only
Vault `1.7+`	✅ Soft Dependency	ServicesManager	Free repair
AdvancedEnchantments	✅ Soft Dependency	Reflection API + NBT PDC	NBT-only
WorldGuard `7.0+`	⚙️ Config Only	Region checks	N/A

📝 Permissions

Permission	Default	Description
`omnirepair.use`	`true`	Use repair GUI
`omnirepair.hand`	`true`	Use /repair hand
`omnirepair.bulk`	`false`	Use /repair all
`omnirepair.admin`	`op`	Admin commands (reload, debug)
`omnirepair.free`	`false`	Free repair (bypass costs)

📄 License

MIT License - see LICENSE file for details.

🔗 Links

Source Code: https://github.com/Syaaddd/OmniRepair
Issues: https://github.com/Syaaddd/OmniRepair/issues
Releases: https://github.com/Syaaddd/OmniRepair/releases

Made with ❤️ for the Minecraft community

No gallery available for this project.

Version	Minecraft	Loader	Download
OmniRepair 1.0.1 1.0.1	1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11	bukkit, paper	Download