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).
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: []