Plugins ✨ Item Upgrader ✨ [Oraxen/ItemsAdder/EcoItems] | [1.8 - 1.21.4]

Item Upgrader

Item Upgrader is a Minecraft plugin that allows players to upgrade their items to other items.

Features

• Minecraft Version Support: Compatible with Minecraft 1.8 - 1.21.4.
• Supports Custom Textured Items: Compatible with Oraxen and ItemsAdder for custom item textures.
• Supports EcoItems: Compatible with items from the EcoItems plugin.
• Economy Integration: Supports popular economy plugins via the Vault API.
• Highly Customizable: Includes fully customizable messages and settings.
• Chained Upgrades: Item upgrades are dependent on other upgrades.
• Required Items: Option to set a list of items required before upgrading.
• Upgrade Chances: Option to set different success rates for various item upgrades.
• Customizable Permissions: Set specific permissions required to open the Upgrade Menu.
• Confirmation Menu: Customizable menu for confirming item upgrades.
• World-Specific Access: The Upgrade Menu can only be opened in specific worlds.
• Upgrade Restrictions: Option to specify which items can and cannot be upgraded.
• Sound Effects: Option to play sounds for various actions, such as insufficient balance,, item breaking and more
• Upgrade Pricing: Option to set prices for different item upgrades (works with economy plugins).
• Customizable Upgrades: Option to set the upgraded item's name, lore, and enchantments.
• Enchantments Reset: Option to remove previous item's enchantments in the upgraded item.
• Item Flags and Durability: Option to set item flags for upgraded items and make them unbreakable.
• Disallowed Enchantments: Option to specify enchantments that prevent an item from being upgraded. If the item contains any of these enchantments, the upgrade will be blocked.
• Enchantment Merging: Previous item's enchantments can be merged with the upgraded item, applying the higher level if the same enchantments are present.
• Custom Enchantment Support: Compatible with custom enchantments from other plugins, such as EcoEnchants.
• Smithing Template Support: Compatible with Smithing Templates (requires Minecraft 1.20 and higher).
• Hex Color Code Support: Compatible with hex color codes (requires Minecraft 1.16 and higher).
• PlaceholderAPI Support: Integration with PlaceholderAPI.

Images | Videos



Spoiler: Item Upgrader Menu
Spoiler: Item Upgrader Menu
Spoiler: Confirmation Menu
Spoiler: Chained Upgrades
Spoiler: Another Upgrade
Spoiler: Misc

Commands and Permissions
Only the reload and help commands can be executed by the console.

• /itemupgrader - no permission by default - Main command of the plugin, opens the Item Upgrader menu.
• /itemupgrader reload - itemupgrader.reload - Reloads the item upgrades, allowed worlds, permissions and configuration files.
• /itemupgrader help - itemupgrader.help - Displays a list of available commands along with their descriptions.
• /itemupgrader item <player> <item name> <true if from> - itemupgrader.item - Gives the player the specified item. If true, it gives the upgraded item; otherwise, it gives the original item.
• /itemupgrader version - itemupgrader.version - Displays detailed information about the plugin and server environment.
• Permission for tab completion: itemupgrader.tabcompleter
  • Use itemupgrader.* to grant all permissions.

,



Configuration Files

config.yml

Code (YAML):
# Should we display a confirmation menu when players try to upgrade their items?
# For the menu customizations check out the messages.yml file.
confirmation-menu: true

# Should only players that have the permission below can be able to open
# the upgrade menu?
# Leave empty so everyone can reach the upgrade menu.
upgrade-menu-perm: ""

# Players must be in one of the worlds below to be able to open the upgrade menu.
allowed-worlds:
- "world"
- "world_nether"
- "world_the_end"

# Which items should players be able to upgrade?
upgradable-items:
- "APPLE"
- "STICK"
- "LEATHER_BOOTS"
- "GOLDEN_HELMET"
- "STONE_SWORD"
- "DIAMOND_PICKAXE"

# Settings for supported plugins/libraries.
addons:
eco-items:
# Simple hack to let EcoItems to finish loading of their items before we load our upgradable items.
start-loading-after: 50

# Sounds for the upgrade menu.
menu-sounds:
upgrade-menu-opened: ""
block-upgraded: BLOCK_ANVIL_USE:1:1
no-enough-balance: BLOCK_ANVIL_STEP:1:1
item-broken: BLOCK_ANVIL_LAND:1:1

required-items:
# If true, we will remove the required items from player's inventory if they have enough chance to upgrade.
# Otherwise, we won't touch their items.
remove-on-success: true
# If true, we will remove the required items from player's inventory if they don't have enough chance to upgrade.
# Otherwise, we won't touch their item even if they fail to upgrade their item.
remove-on-failure: true

# Should we check for any available update when the plugin enables?
update-notifier: true

upgrades.yml
Code (YAML):
# Unlimited amount of upgrades can be created below.
upgrades:

'1':
from:
# 'from.item' is the item that will be upgraded to another item.
item: APPLE
# 'from.name' is the name of the item that will be upgraded to another item.
name: ""
# How many item should we take if player wants to upgrade their item. (default is 1)
amount: 1
to:
# 'to.item' is the item that will be the upgraded item from a previous item.
# Use 'oraxen:item_id_here' for custom textured items by Oraxen plugin.
# Use 'itemsadder:item_id_here' for custom textured items by ItemsAdder plugin.
# Use 'ecoitems:item_id_here' for custom items by EcoItems plugin.
item: GOLDEN_APPLE
# 'to.item' is the new item's name which will be the upgraded from a previous item.
# %price% and %chance% placeholders can be used in the name and lore section.
name: "&e&lUpgraded Apple"
# 'to.lore' is the new item's lore which will be the upgraded from a previous item.
lore:
- ""
- "&7A golden apple that is upgraded"
- "&7with a chance of %chance%%"
# The amount of the upgraded item. This option is also optional, by default the value is 1.
amount: 1
# The item flags of the upgraded item. By default, item flags are empty.
# Values: HIDE_ENCHANTS, HIDE_ATTRIBUTES, HIDE_UNBREAKABLE, HIDE_DESTROYS, HIDE_PLACED_ON and HIDE_POTION_EFFECTS
item-flags: []
# This optional is optional and is false, by default.
unbreakable: false
# If true the tooltip of the upgraded item won't be visible. This option overrides all the item flags.
hide-tooltip: false
# 'chance' amount is going to be used if player accepts to upgrade and try their chance.
# If player is unlucky, they will lose their item and item won't be upgraded
chance: 99
# 'price' is optional, you can set a price for that upgrade. Price system is using the Vault API.
price: 0
# 'enchantments' are optional. You can add enchantments to the new upgraded item.
enchantments: []
# 'reset-enchants' is optional. You can reset the enchantments of the previous item.
# If the previous item has enchantments, they will be applied to the new upgraded item as well.
# If there are same enchantments in the previous item and upgraded item, larger level will be used.
reset-enchants: true
# 'disallowed-enchantments' is optional. If the previous item contains one these enchantments
# they won't be able to open upgrade menu and upgrade the item, and will receive a message about that.
disallowed-enchantments: []
# 'required-items' is optional. To be able to upgrade the item player must have these items in their inventory.
required-items:
'1':
material: STICK
name: ""
# Player must have minimum 5 sticks to upgrade their item.
amount: 5
lore: []
enchantments: []
# - "PROTECTION:1"
# This option is a must if you set the 'required-items' section.
# The message that will be sent to player if they don't have enough the required items in their inventory.
no-required-items-found: "&cYou don't have the required items in your inventory! You need 5 sticks to upgrade your Apple!"

'2':
from:
item: STICK
name: ""
to:
item: ENCHANTED_GOLDEN_APPLE
name: "&e&lGod Apple"
lore:
- ""
- "&7There is a 1% chance that you can"
- "&7grab this Enchanted Golden Apple!"
chance: 1

'3':
from:
item: LEATHER_BOOTS
name: ""
to:
item: GOLD_HELMET
name: "&e&lUpgraded Gold Helmet"
lore:
- ""
- "&7Upgraded from Leather Boots!"
chance: 100
'4':
from:
item: GOLD_HELMET
name: "&e&lUpgraded Gold Helmet"
to:
item: STONE_SWORD
name: "&3&lSpecial Stone Sword"
lore:
- ""
- "&7A stone sword with Sharpness IV!"
chance: 100
enchantments:
- DAMAGE_ALL:4
'5':
from:
item: STONE_SWORD
name: "&3&lSpecial Stone Sword"
to:
item: DIAMOND_PICKAXE
name: "&4&lOP DIAMOND PICKAXE"
lore:
- ""
- "&cDIGS VERYYY QUICKLY!!"
reset-enchants: true
chance: 100
enchantments:
- DURABILITY:2
- DIG_SPEED:5
messages.yml
Code (YAML):
# Command messages.
messages:
correct-usage: "&c&lCorrect usage: %usage%"
no-permission: "&c&lYou do not have enough permission to use Upgrade Menu!"
only-by-players: "&c&lThis command is only executable by players!"
player-not-found: "&c&lNo player with this name could be found!"
item-is-null: "&c&lYou cannot access the Upgrade Menu without having an item in your hand!"
not-upgradable: "&c&lThe item in your hand is not upgradable!"
not-enough-money: "&c&lYou don't have enough money to upgrade this item!"
item-broken: "&c&lThis time luck was not on your side, and the item you wanted to upgrade has been broken!"
item-upgraded: "&aCongratulations! You have successfully upgraded your item!"
conflicts-with: "&c&lYou cannot enchant this item due to some enchantments present on it!"
not-allowed-here: "&c&lYou can not upgrade items in this world!"
reload-message: "&a&lConfiguration files reloaded successfully."

# Upgrade menu settings.
upgrade-menu:
rows: 3
title: "Item Upgrader"
fill-item:
# Leave this empty if you do not want to fill empty slots.
material: BLACK_STAINED_GLASS_PANE
name: ""
lore: []
block-item:
material: BARRIER
name: "&cClose"
lore: []

# Confirmation menu settings.
confirmation-menu:
title: "Confirm"
rows: 3
confirm-item:
material: GREEN_TERRACOTTA
name: "&aUpgrade"
lore: []
slot: 11
cancel-item:
material: RED_TERRACOTTA
name: "&cClose"
lore: []
slot: 15