ItemRenamerReloaded [PlaceholderAPI & Vault support] - ItemRenamerReloaded - 物品重命名工具

ItemRenamer Reloaded 是一款功能强大的物品重命名插件，允许玩家为任何物品设置自定义名称和描述（Lore），并完整支持 RGB 色彩（1.16+版本）。它提供了丰富的自定义选项、经济系统集成以及灵活的权限控制，帮助服务器管理者打造独特的游戏体验。

💡核心功能

• 重命名物品：为手中持有的任何物品设置自定义名称。
• 自定义描述：为物品添加或修改自定义描述文本。
• 描述行数限制：通过配置文件轻松限制玩家可为物品添加的描述行数。
• 自定义音效：玩家重命名物品或设置描述时，可播放自定义的 Minecraft 音效（可选）。
• 经济系统支持：通过 Vault 集成，可对重命名和添加描述操作收费。
• 变量支持：兼容 PlaceholderAPI，可在物品名称和描述中使用变量。
• 物品白名单/黑名单：可设置允许或禁止编辑的物品列表。
• 完整色彩支持：完全兼容 HTML/RGB 色彩代码（1.16+）。
• MiniMessage 格式支持：在重命名或添加描述时使用 MiniMessage 格式（仅 Paper 1.16+ 服务器）。
• 高度可定制：几乎所有的插件提示信息都可自定义。
• 持续更新：插件已完全重写并保持活跃更新。
• 广泛兼容：兼容 Minecraft 1.12 至最新版本。
• 完全免费。

❓要求与依赖

运行环境

• 必需：Java 11 或更高版本。
• 插件集成了 bStats 统计，您可以在其配置文件中选择禁用。

可选依赖

• PlaceholderAPI：用于在物品名称和描述中使用变量。[查看完整变量列表](此处填写原链接)
• Vault 及兼容的经济插件（如 XConomy、Essentials 等）：用于启用经济收费功能。

🔧使用示例与展示

• 使用 RGB 色彩设置自定义物品名称！
• 使用 RGB 色彩设置自定义物品描述！
• 安全地移除部分描述行！
• 在物品上使用 MiniMessage 格式！（需先在配置中启用并授予相应权限；仅限 Paper 1.16+）
• 在物品中添加变量！ 您可以将变量添加到名称或描述中。注意：此功能需要特定权限节点，通常仅限管理员使用。
• 完整的经济系统支持！ 您需要安装 Vault 和一个兼容的经济插件。

✨即将推出的功能

• 物品保存命令：一个管理员命令，允许将自定义物品保存到本地文件。
• 物品锁定：为物品添加“锁”，防止其他玩家编辑。
• 物品白名单：使特定物品无法被编辑。（已在 v1.5 版本完成）
• MiniMessage 支持。（已在 v1.4 版本完成）
• 操作音效：重命名或设置描述时播放可选的自定义音效。（已在 v1.2 版本完成）
• PlaceholderAPI 兼容性：需要权限才可在描述/名称中设置变量。（已在 v1.1 版本完成）
• Vault 经济支持。（已在 v1.3 版本完成）

🎮命令与权限

所有命令参数均无需输入尖括号 < >。

/rename `<自定义名称>`

重命名手中持有的任何物品。

• 如果不输入“自定义名称”参数，则会移除物品上已设置的自定义名称。
• 特殊功能：可为玩家重命名物品的操作播放自定义音效。
• 特殊功能：可对重命名操作收费。
• 特殊功能：在配置中启用并授予 itemrenamer.minimessage 权限后，可使用 MiniMessage 格式（仅 Paper 1.16+）。
• 新功能：可通过白名单/黑名单控制哪些物品可被重命名。

相关权限：

• itemrenamer.rename - 允许重命名任何类型的物品。
• itemrenamer.rename.remove - 允许移除物品上的自定义名称。
• itemrenamer.papi - 允许在物品名称中使用 PlaceholderAPI 变量。
• itemrenamer.minimessage - 允许在重命名时使用 MiniMessage 格式。
• itemrenamer.whitelist - 允许重命名位于允许/阻止物品列表中的物品。

/setlore `<行号> <自定义描述文本>`

指定要创建或修改的描述行号及其自定义文本，对手中物品生效。

• 如果不输入“自定义描述文本”参数，则会移除指定行的描述文本。
• 特殊功能：可通过配置文件单行设置，限制玩家可为物品添加的描述行数。
• 特殊功能：可为玩家设置描述的操作播放自定义音效。
• 特殊功能：可对添加描述行的操作收费。
• 特殊功能：在配置中启用并授予 itemrenamer.minimessage 权限后，可使用 MiniMessage 格式（仅 Paper 1.16+）。
• 新功能：可通过白名单/黑名单控制哪些物品可被添加描述。

相关权限：

• itemrenamer.setlore - 完整使用该命令的权限。
• itemrenamer.setlore.maxbypass - 允许绕过 config.yml 中设置的描述行数限制。
• itemrenamer.papi - 允许在物品描述中使用 PlaceholderAPI 变量。
• itemrenamer.minimessage - 允许在添加描述时使用 MiniMessage 格式。
• itemrenamer.whitelist - 允许为位于允许/阻止物品列表中的物品添加描述。

/irr `<reload/help>`

插件主命令，用于重载插件或查看帮助页面。

• itemrenamer.base.reload - 允许用户重载插件及其配置文件。
• itemrenamer.base.help - 允许用户查看包含所有命令和别名的插件帮助。

⭐配置文件详解

如有任何关于 config.yml 的问题，请在插件讨论区提问。

# ItemRenamerReloaded 配置文件 - Xdlob9
# - 您可以在消息中使用 RGB/HTML 颜色代码（例如：&#FFFFFF白色消息）
#   - 仅适用于 Minecraft 1.16 或更高版本。
# - 如果您想使用 MiniMessage，可以在插件选项中启用它
# - 仅在您知道自己在做什么的情况下修改插件占位符！

# 插件选项
options:
  # 设置玩家可为物品添加的最大描述行数
  # 注意：拥有 'itemrenamer.setlore.maxbypass' 权限的玩家不受此限制
  # 注意：如果您想限制为 5 行，请填写“4”，因为插件从 0 开始计数行号。（例如：max_setlore_lines: 4）
  # （默认：这将限制描述行数为 6 行）
  max_setlore_lines: 5

  # 当玩家重命名物品或添加描述时播放自定义音效！（完整音效列表：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html）
  # 格式如下：音效_ID;音量;音高
  # 如果不想使用音效，请替换为 "none"（例如：name_set_sound: none）
  name_set_sound: ENTITY_EXPERIENCE_ORB_PICKUP;100;1
  lore_set_sound: ENTITY_EXPERIENCE_ORB_PICKUP;100;1

  # 为物品重命名和描述设置启用 MiniMessage 支持（仅限 PAPER 1.16+）
  # MiniMessage 格式完整指南：https://docs.advntr.dev/minimessage/format.html
  # 注意：记得授予用户 "itemrenamer.minimessage" 权限，他们才能使用 MiniMessage 格式
  # - 如果启用了 MiniMessage，没有权限的玩家将继续使用默认的 "&" 和 "&#" 符号表示 RGB/普通颜色
  minimessage: false

# 物品白名单
# 启用时，只有添加到 "allowed_items" 列表中的物品可以被编辑（重命名或添加描述）
# 禁用时，所有物品都可以被编辑，除了添加到 "blocked_items" 列表中的物品
# 示例：如果您禁用 'item_whitelist' 并在 "blocked_items" 列表中添加 "COOKIE"，则 "COOKIE" 物品将无法被编辑
# - 如果您想禁用此功能，请保持为 '[]'（默认值："blocked_items: []"）
# 完整物品材料列表：https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# 注意：无论白名单启用或禁用，拥有 'itemrenamer.whitelist' 权限的玩家都将不受物品编辑限制
item_whitelist:
  enabled: false
  allowed_items:
    - "DIAMOND_CHESTPLATE"
    - "COOKIE"
    - "IRON_SWORD"
  blocked_items:
    - "none"

# 经济设置
# 注意：您需要安装 Vault 和一个使用它的经济插件
economy:
  # 插件是否使用“经济”功能？
  enabled: true
  # 在此指定“重命名”和“设置描述”的价格/成本
  # 支持浮点数（例如：100.5）
  rename_cost: 100
  setlore_cost: 100
  # %irr_price% 是交易（重命名或设置描述）的成本
  insufficient_funds: "%irr_prefix% &c您的资金不足！您至少需要 &e%irr_price% &c的余额"
  purchase_confirmed: "%irr_prefix% &e%irr_price% &a已从您的账户中扣除。随时使用 &6/money &a查看余额"

# 主要插件消息
messages:
  prefix: "&8[&bItemRenamerReloaded&8]"
  no_permission: "%irr_prefix% &c您没有运行此命令的权限。"
  no_permission_removecustom_name: "%irr_prefix% &c您不能移除此物品的自定义名称。请使用铁砧！"
  no_item_hand: "%irr_prefix% &c您手中必须持有物品！"
  item_not_allowed: "%irr_prefix% &c您不被允许重命名或为此物品添加描述！"
  custom_name_removed: "%irr_prefix% &e自定义名称已成功移除。"
  custom_name_applied: "%irr_prefix% &a自定义名称 &f'%irr_new_name%&f' &a已成功应用！"
  incorrect_setlore_arguments: "%irr_prefix% &c命令使用不正确！请像这样尝试：/setlore 1 你好！（如果只指定描述行号，该行将被删除）"
  lore_setted: "%irr_prefix% &a描述 &f'%irr_new_lore%&f' &a已设置！"
  lore_unsetted: "%irr_prefix% &a描述行 &f'%irr_removed_lore%&f' &a已被移除！"
  lore_fully_removed: "%irr_prefix% &a此物品的所有描述行已被移除！"
  out_of_bounds_lore: "%irr_prefix% &c您尝试访问的描述行不存在。（请将第一行计为 0）"
  max_itemlore_lines_reached: "%irr_prefix% &c您已达到此物品的最大描述行数限制。"

# 其他
other:
  plugin_reloaded: "%irr_prefix% &a插件已成功&e重载&a。"

🔧支持与条款

获取帮助

如果您遇到任何问题或有改进建议，请加入 “Xdlob9's Plugin Support” Discord 服务器：

https://discord.gg/hExzXTQCtN

条款与条件

• 您不能修改、分享、出售或将该插件作为自己的作品分发。
• 您不能反编译该插件。
• 感谢 bStats 集成收集的匿名数据。
• © Xdlob9 / 2018 - 2025