Описание
**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](https://www.spigotmc.org/resources/placeholderapi.6245/)** 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](https://docs.advntr.dev/minimessage/format.html))**
- ✔ **Almost** every message of the plugin is **customizable**.
- ✔ Fully recoded and with **active updates**.
- ✔ Compatible from **Minecraft 1.14** to the **latest Minecraft version**.
- ✔ **Free**.
## Requirements:
- At least, **Java 11**.
- For now, a **Spigot/Bukkit based server** _(Spigot, Bukkit, Paper, Purpur...)_.
- It uses bStats, which you can disable in the bStats configuration.
- **OPTIONAL**: **[PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)** so you can use **placeholders**. (_[full list here](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders)_)
- **OPTIONAL**: **[Vault](https://www.spigotmc.org/resources/vault.34315/) and a supported economy plugin that uses it** _(ex.; XConomy, Essentials...)_ so you can use the economy **enhancement**.
## 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)_
You can even add Placeholders to your items! You can add them to the name or to the lore!
Full economy support! You will need Vault and a compatible economy plugin
---
## Commands and permissions
All this commands parameters goes without the "< >"
/rename
- 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!
- **Special feature!** **Whitelist items** if you don't want your users to be able to rename 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](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders)_) from **PlaceholderAPI** to the item name.
> _itemrenamer.minimessage_ - Be able to use MiniMessage (_[full guide here](https://docs.advntr.dev/minimessage/format.html)_) 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
- 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**.
- If you specify _clear_ as the **line number**, you will delete all the item lore lines!
- **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!
- **Special feature!** **Whitelist items** 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](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders)_) from **PlaceholderAPI** to the item name.
> _itemrenamer.minimessage_ - Be able to use MiniMessage (_[full guide here](https://docs.advntr.dev/minimessage/format.html)_) format when renaming 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
- The main plugin command to **check the allowed/blocked colors**, **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
```
#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 "" or "" (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"
- "❵"
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."
```
---
Anonymous data collected thanks to the bStats integration.
---
Terms and Conditions
- You cannot modify and share, sell or distribute the plugin as your own
- You can't decompile the plugin.
© Xdlob9 / 2018 - 2026