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

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

An Item Upgrader plugin with extremely customizable features.



Minimum Java Version: Java 17

Support:
https://discord.gg/uXVU8jmtpU


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



[​IMG]

EcoItems
[​IMG]

[​IMG]
[​IMG]

[​IMG]
[​IMG]


[​IMG]
[​IMG]

[​IMG]


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.
,
[​IMG]


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

My Other Plugins:
[​IMG] [​IMG] [​IMG] [​IMG] [​IMG]

Terms of Service
By using this plugin, you agree to the following terms, which may be updated by the author at any time.
  • All payments are final and non-refundable.
  • Redistribution or resale of this plugin is prohibited.
  • You are not permitted to modify, decompile, or extract any part of the plugin's source code.
  • Support is provided exclusively to legitimate customers. We cannot offer support for plugins obtained through unauthorized or illegal means.
If you like the plugin, don't forget to leave a review!

Copyright 2024 © Berke Akçen
Resource Information
Author:
----------
Total Downloads: 22
First Release: May 11, 2024
Last Update: Dec 19, 2024
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings