Name / NBT 动作

名称动作

动作	说明
name.set(文本)	覆盖整个名称
name.prefix(文本)	在名称前添加前缀
name.suffix(文本)	在名称后添加后缀

name.set

装备.name.set("&6传说之剑 +{等级}")

高级颜色

# 基本颜色 (&)
装备.name.set("&6金色名称")
装备.name.set("&c红色 &a绿色")

# 十六进制 RGB（1.16+）
装备.name.set("§#FF5500橙色")
装备.name.set("&#00FF00亮绿色")

# 渐变：多个 RGB 段拼接
当前名字 = @主装备.name.split("+", 0).trim()
装备.name.set("{当前名字}§#15FF00+§#FFFFFF{新等级}")
# 效果：+ 是亮绿色，等级数字是白色

# 根据等级动态变色
等级颜色 = 新等级 >= 15 ? "§#FF0000"
       : (新等级 >= 10 ? "§#FFFF00" : "§#00FF00")
装备.name.set("{原名} {等级颜色}+{新等级}")

颜色码对照表

代码	颜色	代码	颜色
&0	黑色	&8	深灰
&1	深蓝	&9	蓝色
&2	深绿	&a	绿色
&3	深青	&b	青色
&4	深红	&c	红色
&5	紫色	&d	粉色
&6	金色	&e	黄色
&7	灰色	&f	白色

格式码

&l 粗体、&o 斜体、&n 下划线、&m 删除线、&k 混淆、&r 重置。

name.prefix / name.suffix

装备.name.prefix("&c[强化] ")         # 在原名前加前缀
装备.name.suffix(" &7+{等级}")        # 在原名后加后缀

从原名提取

物品名含等级后缀时（如 传说之剑+5），常见做法：

# split(分隔符, 索引)：按分隔符切割取第 N 段
原名 = @主装备.name.split("+", 0)    # "传说之剑"
原名 = 原名.trim()                   # 去首尾空格

# 重新拼接
装备.name.set("{原名} +{新等级}")

NBT 动作

动作	说明
nbt.set(路径, 值)	设置 NBT 值（路径不存在则创建）
nbt.add(路径, 增量)	增加数值型 NBT
nbt.remove(路径)	删除 NBT 路径

# 设置
装备.nbt.set("CustomData.Level", 5)
装备.nbt.set("CustomData.Owner", player.name)
装备.nbt.set("Tags.Enhanced", true)

# 增加数值
装备.nbt.add("CustomData.EnhanceCount", 1)

# 删除
装备.nbt.remove("CustomData.TempTag")

路径用 . 分隔嵌套层级，和 NBT 本身的路径语法一致（如 CustomData.Stats.Attack）。

读取 NBT 用 @input.nbt("路径")、匹配用 nbt.is(...) / nbt.has(...)，详见 引用与插值 和 匹配系统。