装备与物品
设置物品描述
为指定物品 ID 写入前缀、中间或后缀描述，适用于来源展示、限时说明、专属词条和个性化装备说明场景。
命令用途
SetItemDesc 用于给指定物品 ID 设置描述内容。
它常见于装备来源展示、限时属性说明、专属效果说明和个性化外观描述这类场景，可以把一段文字或图文标记插入到物品描述的前部、中部或后部。
SetItemDesc 需要 AC 封挂网关支持。未接入对应支持时，脚本即使执行成功，客户端也可能看不到描述变化。命令名
SetItemDesc
调用格式
SetItemDesc <物品ID> <描述> <位置>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
物品ID | 是 | 要写入描述的目标物品 ID。通常来自产出、鉴定或生成流程中的当前物品参数。 |
描述 | 是 | 要插入到物品描述中的文本内容，也可以包含颜色、图片和排版标记。 |
位置 | 是 | 描述插入位置。0 表示前缀，1 表示中间，2 表示后缀。 |
返回或影响
- 这是执行型命令，会直接修改目标物品的描述显示内容。
- 相同物品 ID 后续再次执行时，会按你填写的位置覆盖或刷新对应段落的显示结果。
- 这条命令只影响指定物品 ID，不会批量改动同名物品。
- 当前版本已经去掉“描述为空时删除对应物品描述”的旧行为，不能再按清空描述来理解为删除。
示例
基础用法
#ACT
SetItemDesc <$PARAM(1)> "来源：沙巴克藏宝阁" 2
这段写法用于把“来源：沙巴克藏宝阁”追加到目标物品描述后部，适合做掉落来源说明。
常见变体
#ACT
FormatStr "来源：<%s|c=clRed>\地图：<%s|c=$4AD663>\产者：<%s|c=$E9A000>\物主：<%s|c=clSkyBlue>" <$PARAM(0)> <$PARAM(4)> <$PARAM(5)> <$PARAM(6)>
SetItemDesc <$PARAM(1)> <$CALCRESULT> 2
这类写法适合先拼出一段带颜色的来源说明，再整体写入物品描述后缀，常用于装备来源、掉落记录或活动产出展示。
注意事项
SetItemDesc不适合直接用于重叠物品，资料中已明确提示这类物品不建议这样处理。- 描述里如果要带颜色、图片或动态资源，应先在测试环境确认客户端显示效果，再用于正式服。
- 物品描述中尽量不要夹杂逗号等容易干扰后续处理的字符，复杂内容更适合先用
FormatStr组装后再写入。 - 对无效物品 ID 写描述不会得到你想要的结果，实际业务里通常先确保当前物品 ID 有效。