Item Upgrader Documentation

Item Upgrader

Item Upgrader lets players transform a held item into a configured result through a protected graphical menu. Every upgrade can define its source identity, output item, quantity, success chance, Vault price, required ingredients, enchantment behavior, item flags, model data, and source loss on a failed roll.

The plugin supports vanilla materials and custom items from Oraxen, ItemsAdder, and EcoItems. Multiple recipes can form upgrade chains, while permissions and allowed-world settings control where the menu is available.

Item Upgrader is proprietary premium software. Obtain an authorized binary through the official marketplace pages. Private repository access does not grant source redistribution rights; there is no public source API or public Javadoc site.

Get Started

Getting Started Install Item Upgrader and verify its dependencies and generated files.

Upgrade Flow Follow an item from validation through confirmation, payment, success, or failure.

Creating Upgrades Build a complete upgrade recipe and test it safely.

Commands

Player Command Open the upgrade menu for the item held in the main hand.

Admin Commands Reload files, inspect versions, give recipe items, and manage access.

Configuration

config.yml Configure confirmation, permissions, worlds, source materials, sounds, addons, and ingredient removal.

messages.yml Customize command feedback, validation messages, and both menu layouts.

upgrades.yml Reference every source, output, chance, price, enchantment, metadata, and ingredient option.

Features

Chances and Economy Control success rolls, failed items, Vault withdrawals, and result placeholders.

Required Items Require exact ingredient names, lore, amounts, and enchantment levels.

Enchantments and Metadata Merge or reset enchants and configure flags, durability, model data, tooltips, and armor trims.

Custom Items Use Oraxen, ItemsAdder, and EcoItems identifiers in recipes and menus.

Chained Upgrades Connect result items to later recipes without ambiguous source matching.

Miscellaneous

FAQ Common questions about dependencies, prices, failures, matching, custom items, and reloads.

Get Item Upgrader on SpigotMC Open the official SpigotMC distribution page.

Get Item Upgrader on BuiltByBit Open the official BuiltByBit distribution page.