✨ 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.




  • Updated Commons library for better stability and compatibility.
----------, Dec 19, 2024

  • Support for MC 1.21.4.
----------, Dec 8, 2024

  • Updated Commons library.
  • Code based changes/improvements.
----------, Nov 27, 2024

  • Updated some of the log messages.
----------, Nov 17, 2024

  • Optimized the user management system.
----------, Nov 13, 2024

  • Fixed update checker not working properly.
  • Updated Commons library.
----------, Nov 10, 2024

  • Updated Command Framework library to v1.5.12.
----------, Nov 4, 2024

  • Added an option to fully hide the tooltip for upgraded items.

Changes in the upgrades.yml
Code (YAML):
upgrades:
  '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
----------, Oct 29, 2024

  • Support for Minecraft 1.21.2 & 1.21.3.
  • Removed /itemupgrader check command.
----------, Oct 28, 2024

  • Fixed the messages not working.
  • Fixed the empty sound names causing to an exception.
----------, Oct 13, 2024

  • Added /itemupgrader version command - itemupgrader.version - Displays detailed information about the plugin and server environment.
----------, Oct 10, 2024

  • Updated libraries for better performance and compatibility.
----------, Oct 1, 2024

  • Updated libraries:
    • Commons
    • Command Framework
    • bStats
----------, Sep 25, 2024

  • Updated Commons library to v1.8.3.
  • Updated shaded library locations.
----------, Sep 9, 2024

  • No permission message is no longer only associated with the main command, now it will work for every command related to this plugin.
----------, Sep 3, 2024

  • Fixed the help command permission. (new perm: itemupgrader.help).
----------, Sep 2, 2024

  • Added PlaceholderAPI support for the messages.
----------, Sep 1, 2024

  • Set default system locale to English, this update fixes bugs with the langues such as Turkish.
----------, Aug 26, 2024

  • Updated Commons license.
----------, Aug 22, 2024

  • General improvements on the command system.
  • Updated some of the messages.
----------, Aug 21, 2024

  • Updated Command Framework to v1.5.0.
  • Fixed help command not containing main command.
----------, Aug 19, 2024

  • Updated help command messages.
With this update, there will be a 50% discount until the end of this month.
----------, Aug 17, 2024

  • Added option to play sound when a player opens the Upgrade Menu.
  • Fixed the economy integration.

Changes in the config.yml
Code (YAML):
menu-sounds:
  upgrade-menu-opened
: ""
With this update, there will be a 50% discount until the end of this month.
----------, Aug 16, 2024

  • Performance improvements.
----------, Aug 15, 2024

  • Support for Minecraft 1.21.1.
  • Fixed help command not working properly.
----------, Aug 11, 2024

  • Now required items can be separated in the player inventory, they don't have to be the exact amount.
    • For instance, the required amount item is 5 sticks. These sticks can be 5 different sticks with amount 1, or 2 separated sticks with amounts 2 and 3.
  • Bolded some of the messages in upgrades.yml and messages.yml files.
----------, Aug 3, 2024

  • Updated Command Framework to the v1.4.9.
  • Updated command descriptions.
  • Updated resource page design.
  • Fixed some of the commands sending command usage instead of sending the error message.
----------, Jul 28, 2024

  • Removed static usage of storing item upgrader menu data.
----------, Jul 24, 2024

  • Updated Command Framework to v1.4.8.
    • Huge improvements on the command system.
----------, Jul 19, 2024

  • Fixed permission of reload command.
----------, Jul 14, 2024

  • Added option to make upgraded item unbreakable.
  • Updated Commons to latest available version.

Changes in 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
    # '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
----------, Jul 11, 2024

  • Added check command's messages to messages.yml.

Changes in messages.yml
Code (YAML):
 update-command:
    checking-for-update
: "&3[Item Upgrader] &bChecking for updates, please wait..."
    new-update-available
: "&3[Item Upgrader] &bFound a new update: {0} (current version: {1}).\n&3>>&b https://spigotmc.org/resources/item-upgrader.116575/"
    up-to-date
: "&3[Item Upgrader] &bNo new updates found, everything is up to date!"
 
----------, Jul 10, 2024

  • Fixed sounds can not be played in higher versions of the game.
----------, Jul 9, 2024

  • Support for new added sounds in MC 1.17+ such as:
    • BLOCK_COPPER_BULB_BREAK,
    • BLOCK_COPPER_BULB_FALL,
    • BLOCK_COPPER_BULB_HIT,
    • BLOCK_COPPER_BULB_PLACE,
    • BLOCK_COPPER_BULB_STEP,
    • BLOCK_COPPER_BULB_TURN_OFF,
    • BLOCK_COPPER_BULB_TURN_ON,
    • BLOCK_COPPER_DOOR_CLOSE,
    • BLOCK_COPPER_DOOR_OPEN,
    • BLOCK_COPPER_FALL,
    • BLOCK_COPPER_GRATE_BREAK,
    • BLOCK_COPPER_GRATE_FALL,
    • BLOCK_COPPER_GRATE_HIT,
    • BLOCK_COPPER_GRATE_PLACE,
    • BLOCK_COPPER_GRATE_STEP
    • BLOCK_TRIAL_SPAWNER_ABOUT_TO_SPAWN_ITEM,
    • BLOCK_TRIAL_SPAWNER_AMBIENT,
    • BLOCK_TRIAL_SPAWNER_AMBIENT_CHARGED,
    • BLOCK_TRIAL_SPAWNER_AMBIENT_OMINOUS,
    • BLOCK_TRIAL_SPAWNER_BREAK,
    • BLOCK_TRIAL_SPAWNER_CHARGE_ACTIVATE,
    • BLOCK_TRIAL_SPAWNER_CLOSE_SHUTTER,
    • BLOCK_TRIAL_SPAWNER_DETECT_PLAYER,
    • BLOCK_TRIAL_SPAWNER_EJECT_ITEM,
    • BLOCK_TRIAL_SPAWNER_FALL,
    • BLOCK_TRIAL_SPAWNER_HIT,
    • BLOCK_TRIAL_SPAWNER_OMINOUS_ACTIVATE,
    • BLOCK_TRIAL_SPAWNER_OPEN_SHUTTER,
    • BLOCK_TRIAL_SPAWNER_PLACE,
    • BLOCK_TRIAL_SPAWNER_SPAWN_ITEM,
    • BLOCK_TRIAL_SPAWNER_SPAWN_ITEM_BEGIN,
    • BLOCK_TRIAL_SPAWNER_SPAWN_MOB,
    • BLOCK_TRIAL_SPAWNER_STEP.
----------, Jul 9, 2024

  • Now item flags of the upgraded item can be customized.

Changes in upgrades.yml
Code (YAML):
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
: [ ]
----------, Jul 6, 2024

  • Support for new added items in MC 1.20 & 1.21 such as:
    • EXPOSED_COPPER_BULB
    • EXPOSED_COPPER_DOOR
    • EXPOSED_COPPER_GRATE
    • EXPOSED_COPPER_TRAPDOOR
    • FLOW_ARMOR_TRIM_SMITHING_TEMPLATE
    • FLOW_BANNER_PATTERN
    • FLOW_POTTERY_SHERD
    • GUSTER_BANNER_PATTERN
    • GUSTER_POTTERY_SHERD
    • MACE
    • MUSIC_DISC_CREATOR
    • MUSIC_DISC_CREATOR_MUSIC_BOX
    • OMINOUS_BOTTLE
    • OMINOUS_TRIAL_KEY
----------, Jul 6, 2024

  • Added '/itemupgrader check' command to check if there is any available updates.
    • Permission: itemupgrader.check
    • Only executable by players.
----------, Jun 22, 2024

  • Added support for Minecraft 1.21.
  • Improvements on help command.
----------, Jun 20, 2024

  • Added option to specify a amount of an item that will be upgraded to be able to open upgrader menu.
  • Fixed sending a debug message when player does not have required items, in case user set a list of required items.
  • Now if required item amount is 5 and if player has 10 then 5 of them will be removed from player.
  • Now upgraded item will add to player's inventory in case their main hand can be filled with another item.

Changes in messages.yml

Code (YAML):
messages :
  # {0} - Needed amount to upgrade. | {1} - Current amount of the currently held item.
  not-enough-amount
: "&c&lYou need at least {0} of currently held item to upgrade it!"

Usage of new feature

Code (YAML):
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
    # '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!"
----------, Jun 18, 2024

  • Added required items feature.
    • Now you can set a list of required items that player must have in their inventory to be able to upgrade their item.
    • You can set a custom 'you don't have enough of required items' message based on different upgrades.
    • You can set different required items for different upgrades.
    • You can define material, displayname, lore, amount and enchantments for required items.
Changes in config.yml
Code (YAML):
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
Usage of the new feature:
Code (YAML):
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
: ""
    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
    # '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!"
----------, Jun 15, 2024

Discord: mrdespical

  • Now supports Mojang mapped servers, such as Paper (MC 1.20.5+).
  • Added an option to change the amount of upgraded item.

Code (YAML):
upgrades:
  '1'
:
    to
:
      # The amount of the upgraded item. This option is also optional, by default the value is 1.
      amount
: 1
----------, May 24, 2024

Discord: mrdespical

  • Fixed smithing templates not applying to upgraded items. (this feature requires MC 1.20+)
----------, May 18, 2024

Discord: mrdespical

1.0.3
  • Added support for EcoItems.
    • Use 'ecoitems:item_id_here' to use Eco Items in upgrades.

Config Changes
Code (YAML):
# 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
The item is from EcoItems plugin and got with using command:
/ecoitems give mrdespi enchanted_cobblestone

[​IMG]
----------, May 16, 2024

Discord: mrdespical

1.0.2
  • Added ItemsAdder support for custom textured items.
    • Use 'itemsadder:item_id_here' in upgrades.yml
  • Added a warning message if the items can not be found by using Oraxen/ItemsAdder APIs.
----------, May 13, 2024

Discord: mrdespical

1.0.1
  • Added Oraxen support for custom textured items.
  • Added update checker (can be disabled via config).
  • Separated 'upgrades' section to another file (upgrades.yml).

[​IMG]
----------, May 12, 2024

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