ItemRenamerReloaded [1.14 - 26.1.2] [PlaceholderAPI & Vault support]

ItemRenamerReloaded, its a plugin that gives the ability to rename items with customs names and custom lores, with full RGB colors support (+1.16)

So, in general, what does this plugin offers you?
- ✔ Rename any type of item with a custom name
- ✔ Set a custom lore to any type of item.
- ✔ LIMIT how many lines of lore a player can add to an item as you wish with a single line in the config.
- ✔ Play a custom Minecraft sound when players rename an item or set lore to them! (optional)
- ✔ Economy support with Vault!
- ✔ Compatible with PlaceholderAPI placeholders.
- ✔ You can whitelist items if you don't want your users to be able to edit them!
- ✔ Whitelist color codes if you don't want your users to be able to use them when renaming or adding lore to items!
- ✔ Full compatibility with HTML/RGB +1.16 colors.
- ✔ Full compatibility with MiniMessage format when renaming or adding lore to items! (Paper +1.16 only; Full guide here)
- ✔ Almost every message of the plugin is customizable.
- ✔ Fully recoded and with active updates.
- ✔ Compatible from Minecraft 1.12 to the latest Minecraft version.
- ✔ Free.

Requirements:

• At least, Java 11.
• It uses bStats, which you can disable in the bStats configuration.
• OPTIONAL: PlaceholderAPI so you can use placeholders. (full list here)
• OPTIONAL: Vault and a supported economy plugin that uses it (ex.; XConomy, Essentials...) so you can use the economy enhancement.

Are you having any issues with the plugin? Do you have any suggestions for it?
Join the "Xdlob9's Plugin Support" Discord server!
You can access it here: https://discord.gg/hExzXTQCtN


Photos, gifs and examples
Setting a custom name to an item using RGB colors!


Setting a custom LORE to an item using RGB colors!

Removing some lore lines safely!


Using MiniMessage format on items! (previously enabling it at the config + adding the specific permission; Paper +1.16 only)


You can even add Placeholders to your items! You can add them to the name or to the lore!
Note: It has a permission node so only Staff members can add Placeholders to the items

With a little bit of patience, you or your players, can do amazing things like this item! (obviously, this item by itself does not have any type of powers, its just illustrative)


Full economy support! You will need Vault and a compatible economy plugin



Upcoming features
☐ Done - ☐ On development - ☐ Planned

- A Staff command that lets you save your custom items in local files.
- Add a "lock" to an item so other players cannot edit the item
- Whitelist color codes so they can't be used to rename or add lore to items (Done in v1.6)
- Whitelist items so they cannot be edited (Done in v1.5)
- MiniMessage Support (Paper +1.16 only; Done in v1.4)
- Play a optional custom sound when an item is renamed or a lore is set to it. (Done in v1.2)
- PlaceholderAPI compatibility, that needs a permission to be able to set Placeholders in lores/names. (Done in v1.1)
- Economy support with Vault (Done in v1.3)



Commands and permissions
All this commands parameters goes without the "< >"

/rename <Custom name>

• Rename any type of item with ease while holding the item in your hand.
• This command without the "Custom name" parameter, will remove the custom name that you setted to an item.
• Special feature! Play a custom Minecraft sound when your players rename their own items!
• Special feature! Charge money to your users for renaming an item!
• Special feature! Use MiniMessage format by enabling it in the config and adding the new itemrenamer.minimessage permission! (Paper +1.16 only)
• Special feature! Whitelist items [/B]if you don't want your users to be able to set the name to them
• New feature! Whitelist color codes if you don't want your users to be able to set the name with them

itemrenamer.rename - Rename any type of item.
itemrenamer.rename.remove - Remove the custom name from an item.
itemrenamer.papi - Be able to add placeholders (full list here) from PlaceholderAPI to the item name.
itemrenamer.minimessage - Be able to use MiniMessage (full guide here) format when renaming your item
itemrenamer.whitelist - Be able to rename items that are included in the allow/blocked items lists
itemrenamer.whitelist.colors - Be able to use the color codes that are included in the allow/blocked color codes lists

/setlore <Line number> <Custom lore text>[/SIZE]

• Specify the lore line you want to create or modify, along with its custom text while holding an item in your hand.
• This command without the "Custom lore text" parameter, will remove the lore line along with its text.
• Special feature! You can limit how many lines of lore a player can add to an item as you wish by just changing a single line in the config (see more below).
• Special feature! Play a custom Minecraft sound when your players set a lore to their items!
• Special feature! Charge money to your users for adding lines to an item lore!
• Special feature! Use MiniMessage format by enabling it in the config and adding the new itemrenamer.minimessage permission! (Paper +1.16 only)
• Special feature! Whitelist items [/B]if you don't want your users to be able to add lore to them
• New feature! Whitelist color codes if you don't want your users to be able to add lore with them

itemrenamer.setlore - Full command usage permission.
itemrenamer.setlore.maxbypass - Allows you to bypass the lore line limit specified in the config.yml file.
itemrenamer.papi - Be able to add placeholders (full list here) from PlaceholderAPI to the item lore.
itemrenamer.minimessage - Be able to use MiniMessage (full guide here) format when adding lore to your item
itemrenamer.whitelist - Be able to add lore to items that are included in the allow/blocked items lists
itemrenamer.whitelist.colors - Be able to use the color codes that are included in the allow/blocked color codes lists

/irr <reload/help>

• The main plugin command to reload the plugin and to see the plugin help page.

itemrenamer.base.colors - Allows the user to see all the color codes that are available or blocked to use
itemrenamer.base.reload - Allows the user to reload the plugin along with the configuration file.
itemrenamer.base.help - Allows the user to see the plugin help with all the commands and aliases.


Plugin configuration file
Please, any question or problem with the config.yml file, ask it in the plugin discussion section. Thanks!

Code (YAML):

#ItemRenamerReloaded Config file - Xdlob9
# - You can use RGB/HTML color codes in your messages. (ex; &#FFFFFFMessage in white)
#   - ONLY AVAILABLE in Minecraft 1.16 or higher.
# - You can ENABLE MiniMessage support in plugin options if you want to use that instead
# - Touch the plugin placeholders only if you know what you are doing!

# Plugin options
options :
  # This option allows you to set up the maximum lines of lore that a player can set to an item
  # NOTE: Players with 'itemrenamer.setlore.maxbypass' permission won't have this limit
  #
  # Take into account that if you want to limit the lines to, for example, 5 lines, you must write "4", since the plugin starts counting the lines from 0. (example; max_setlore_lines: 4)
  # (Default; this will limit the lore lines to 6) max_setlore_lines: 5
  max_setlore_lines : 5
  # Play a custom sound when a player renames or adds a lore to an item! (Full sounds list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html#enum-constant-summary)
  # The format follows like this: SOUND_ID;VOLUME;PITCH
  # If you don't want to use sounds, just replace it with "none" (ex.; name_set_sound: none)
  name_set_sound : ENTITY_EXPERIENCE_ORB_PICKUP;100;1
  lore_set_sound : ENTITY_EXPERIENCE_ORB_PICKUP;100;1

  # Enable MiniMessage support for item renaming and lore setting (PAPER +1.16 ONLY)
  # Full MiniMessage format guide: https://docs.advntr.dev/minimessage/format.html
  #
  # NOTE: Remember to give the "itemrenamer.minimessage" permission to users so they can use the MiniMessage format
  # - If MiniMessage is enabled, players without the permission will keep using default "&" and "&#" symbols for RGB/normal colors
  minimessage : false

  # Items whitelist
  # When enabled, ONLY the items you add to the "allowed_items" list will be editable (by renaming or adding lore to them)
  # When disabled, ALL items can be edited EXCEPT the ones you add in "blocked_items"
  # EXAMPLE: If you disable 'item_whitelist' and add, for example, a "COOKIE" item to the "blocked_items" list, the "COOKIE" item won't be able to be edited
  # - Leave it as "none" if you want to disable this feature (default value; "blocked_items: none")
  #
  # Full Spigot API items list: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
  # NOTE: In both cases whitelist is enabled or disabled, players with the 'itemrenamer.whitelist' permission will be exempt from the item edit lock
  item_whitelist:
    enabled : false
    allowed_items :
     - "DIAMOND_CHESTPLATE"
      - "COOKIE"
      - "IRON_SWORD"
    blocked_items :
     - "none"

  # Color whitelist
  # When enabled, ONLY the COLOR CODES you add to the "allowed_colors" list will be available to use for the players (by renaming or adding lore to items)
  # When disabled, ALL color codes will be available to use EXCEPT the ones you add to "blocked_colors"
  # EXAMPLE: If you disable "color_whitelist" and add the "&a" color to the "blocked_colors" list, the color won't be applied and a message will appear to the player
  # - Leave it as "none" if you want to disable this feature (default value; "blocked_colors: none")
  #
  # Supported format checking:
  # - Text modifiers like "&k" or "&o"
  # - Minecraft Vanilla Color codes such as "&a" or "&b"
  # - HTML Color Codes (HEX) such as "&#FFFFFF" or "&x&F&F&F&F&F&F"
  # - MiniMessage format such as "<rainbow>" or "<#010101>" (WARNING: Due to how the check works, if you add a MiniMessage color code to "allowed_colors", you wont be able to rename an item like this -> " < Amazing Item name > ")
  color_whitelist:
    enabled : false
    allowed_colors :
     - "&a"
      - "&b"
      - "&#010101"
    blocked_colors :
     - "none"

# Economy setup
# NOTE: You should have Vault and an economy plugin that uses it
economy :
  # Should the plugin use the "Economy" functionality?
  enabled : true

  # Specify the "Rename" and "Set lore" price/cost here
  # Float numbers are compatible (ex.; 100.5)
  rename_cost : 100
  setlore_cost : 100

  # %irr_price% is the cost of the transaction (renaming or lore set)
  insufficient_funds : "%irr_prefix% &cYou don't have the sufficient funds to afford this! You need at least &e%irr_price% &cfrom your balance"
  purchase_confirmed : "%irr_prefix% &e%irr_price% &agot taken from your account. Check your balance anytime with &6/money"

# Main plugin messages
messages:
  prefix : "&8[&bItemRenamerReloaded&8]"

  no_permission : "%irr_prefix% &cYou don't have the permissions to run this command."
  no_permission_removecustom_name : "%irr_prefix% &cYou can't remove the custom name from this item. Use an anvil!"

  no_item_hand : "%irr_prefix% &cYou must have an item in your hand!"
  item_not_allowed : "%irr_prefix% &cYou are not allowed to rename or add lore to this item!"
  color_not_allowed : "%irr_prefix% &cYou are not allowed to use one or more colors to rename or add lore to this item!"
  custom_name_removed : "%irr_prefix% &eThe custom name has been successfully removed."
  custom_name_applied : "%irr_prefix% &aThe custom name &f'%irr_new_name%&f' &ahas been successfully applied!"

  incorrect_setlore_arguments : "%irr_prefix% &cIncorrect command usage! Try it like this: /setlore 1 Hi there! (if you only specify the lore line number, that line will be deleted)"
  lore_setted : "%irr_prefix% &aThe lore &f'%irr_new_lore%&f' &ahas been setted!"
  lore_unsetted : "%irr_prefix% &aThe lore line &f'%irr_removed_lore%&f' &ahas been removed!"
  lore_fully_removed : "%irr_prefix% &aAll the lore lines have been removed from this item!"
  out_of_bounds_lore : "%irr_prefix% &cThe lore line you are trying to access does not exist. (start counting the first line as 0)"
  max_itemlore_lines_reached : "%irr_prefix% &cYou reached the maximum lore lines for this item."

# Other
other:
  help_allowed_items : "&b=== &aAllowed &ecolors list &b==="
  help_blocked_items : "&b=== &cBlocked &ecolors list &b==="
  help_all_colors_allowed : "%irr_prefix% &aAll colors can be used to rename or set lore to your items!"
  plugin_reloaded : "%irr_prefix% &aThe plugin has been successfully &ereloaded&a."