EliteRename

插件

· 作者 Partakithware

重命名、物品、背景故事、附魔背景故事、属性背景故事等。

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.0 · 26.1.2 · Paper

一键开服(送7天)

EliteRenameSplash EliteRename 是一款轻量级的、基于状态驱动的项元数据操作插件,专为 Paper 1.21 设计。它通过利用持久化数据存储和严格的组件重建机制,绕过了原版客户端渲染的僵化限制,赋予用户对物品显示名称、描述文本数组、附魔显示和属性修饰符的完全控制权。

  1. 核心渲染与格式化管道

    MiniMessage 集成:摒弃了旧版字符串格式化方式,转而采用 Adventure API 的 MiniMessage,支持复杂的 RGB 渐变、十六进制颜色以及丰富的文本组件(, <bold>),并安全地解析为原生 Component 对象。

    动态描述文本重建:使用一个管道(rebuildLoreOnMeta)作为物品可见描述文本数组的唯一事实来源。它会即时拼接自定义附魔标签和用户定义的描述文本,确保 UI 更新与底层数据结构保持同步。

  2. 数据持久化 (PDC)

    隔离存储:插件并未将自定义数据存储在脆弱的基于字符串的描述文本行中,而是使用 Gson 将状态序列化为 JSON 数组和对象,并直接存储在物品的 PersistentDataContainer (PDC) 中。

    命名空间键:使用专用键(KEY_ENCHANT_LABELS, KEY_USER_LORE)来分离由插件管理的数据与原版 NBT 数据或其他插件的修改,防止冲突,并允许在编辑外来物品时优雅降级。

  3. 客户端 UI 混淆与模拟

    附魔伪造 (/enchlabel):应用 ItemFlag.HIDE_ENCHANTS 以抑制硬编码的客户端工具提示。随后,它将用户定义的、非斜体的灰色文本前置到描述文本数组中,完美模仿原版的附魔显示效果,同时允许自定义命名(例如,将 "Sharpness" 改为 "Blade of Doom")。

    属性注入 (/renameattr):应用 ItemFlag.HIDE_ATTRIBUTES 以隐藏默认的武器/工具修饰符。它读取物品的 AttributeModifiers(如果不存在则回退到材质对应的原版默认值),结合基础玩家实体统计信息(例如 1.0 基础伤害,4.0 基础速度),并将数学上准确、视觉上与原版的 "When in Main Hand:" 工具提示完全一致的副本直接注入到 PDC 描述文本数组中。这将硬编码的客户端属性转化为完全可变的文本。

  4. 状态管理(遗憾机器)

    基于会话的撤销栈:维护一个瞬时的、按 UUID 映射的每玩家 Deque<ItemStack>。

    LIFO 记忆:在任何变异发生之前立即捕获 ItemStack 的深度克隆。该栈在每个会话中限制为最多 5 个状态,以防止内存泄漏,并充当后进先出(LIFO)的回滚机制,在恢复 ItemMeta 之前验证物品类型是否匹配。

  5. 实用功能与生活便利

    身份窃取 (/rename steal):一种上下文感知的克隆方法,读取副手物品的 ItemMeta,提取其显示名称和 PDC 存储的用户描述文本(对于外来物品回退到原始描述文本),并在保留主手物品原生附魔的同时覆盖主手物品。

    上下文 Tab 补全:命令路由器具有深度的 Tab 补全功能,能够实时查询物品的当前内部状态。例如,输入 /setlore 1 会动态序列化并建议当前位于第 1 行的确切 MiniMessage 字符串,从而允许快速进行就地拼写错误修正。

commands:
  rename:
    description: 重命名手持物品,重置它,撤销更改,或从你的副手窃取身份。
    usage: /rename [reset | undo | steal | <text...>]
    permission: elr.rename.player
  setlore:
    description: 设置或替换特定的描述文本行。
    usage: /setlore <line> <text...>
    permission: elr.lore
  addlore:
    description: 追加新的描述文本行。
    usage: /addlore <text...>
    permission: elr.lore
  removelore:
    description: 通过编号移除特定的描述文本行。
    usage: /removelore <line>
    permission: elr.lore
  clearlore:
    description: 清除手持物品上的所有用户描述文本。
    usage: /clearlore
    permission: elr.lore
  enchlabel:
    description: 对特定附魔应用自定义视觉标签。
    usage: /enchlabel <enchant> [<text...> | reset]
    permission: elr.enchant
  iteminfo:
    description: 查看手持物品的元数据详情。
    usage: /iteminfo [field]
    permission: elr.info
  renameattr:
    description: 隐藏原版属性并将其转换为可编辑的描述文本。
    usage: /renameattr <true|false>
    permission: elr.renameattr

permissions:
  elr.rename.player:
    description: 允许普通玩家使用 /rename 命令。
    default: true
  elr.rename:
    description: 明确授予管理员使用 /rename 命令的权限。
    default: op
  elr.lore:
    description: 允许使用 /setlore, /addlore, /removelore 和 /clearlore。
    default: op
  elr.enchant:
    description: 允许使用 /enchlabel 命令。
    default: op
  elr.info:
    description: 允许使用 /iteminfo 读取物品元数据。
    default: true
  elr.renameattr:
    description: 允许使用 /renameattr 隐藏原版属性并将其转换为可编辑的描述文本。
    default: true
  elr.admin:
    description: 完全访问所有 EliteRename 命令和功能。
    default: op

版本 1.0(窃取功能尚未达到我期望的效果,它可以工作,但由于其按需匹配的方式,感觉不够……侵入性)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源