996引擎ClearStoneUpgrade配置方法 - 脚本清除宝石实战案例

很多人以为清宝石属性和卸装备是一回事，其实完全不同。卸装备把整件装备拿下来，宝石升级属性还在装备上，穿回去属性照旧；ClearStoneUpgrade不碰装备本身，只把宝石附加的升级属性清除掉，装备还在身上但加成没了。

做宝石重置、重新洗属性时用的就是这条命令，后接装备位置编号0到14。新手最容易犯两个错：位置编号填错清了别的部位，或者没意识到它不区分极品和普通装备，一执行所有宝石加成都归零。下面把位置编号含义、清除范围和不可逆注意点逐个说明。

格式速查

ClearStoneUpgrade属于996引擎装备属性操作命令，功能是清除使用宝石升级的装备属性，官方格式如下：

ClearStoneUpgrade 位置(0-14)

位置填装备栏位编号，范围在0到14之间，对应身上不同的装备部位。执行后，该部位装备上通过宝石加上的升级属性被清空。注意它不区分极品和普通装备，清除时这件装备上所有相关属性都会消失。

官方自带的标准示例：

[@main]
#IF
#ACT
ClearStoneUpgrade 0

这行清除身上位置0那件装备的宝石升级属性。

参数拆解

位置编号对应身上的装备栏位，0到14覆盖了身上各件装备。写脚本前先确认要清的那件装备在哪个栏位，填对应编号，别凭感觉填。

新手易错点

位置编号要落在0到14之间，填超范围命令不执行，这是最常见的无反应原因。

它不区分极品和普通装备，一旦执行，目标部位装备上的宝石升级属性全部归零，不存在只清一部分的说法。

清除不可逆，属性清掉后要重新用宝石升级，脚本侧没有一键恢复。

它只清身上穿着的那件装备对应栏位，背包里放着的装备和宝石不受影响。

实战配置

第一步，打开NPC脚本文件，找到Market_Def目录下对应NPC的脚本文件。

第二步，在触发段里写清除宝石属性命令，先拿位置0试：

@Main]
#IF
#ACT
ClearStoneUpgrade 0
#SAY
位置0装备的宝石升级属性已清除\

第三步，做宝石重置NPC，执行前先弹确认提示：

[@宝石重置]
#IF
#SAY
确定要清除该部位宝石升级属性吗？\
清除后属性归零，需要重新升级\
<确定清除/@确认清除> <再想想/@取消>

[@确认清除]
#IF
#ACT
ClearStoneUpgrade 0
SendMsg 5 装备宝石升级属性已清除

第四步，做洗宝石流程，清完跳回重新升级段：

[@洗宝石]
#IF
#ACT
ClearStoneUpgrade 0
GOTO @重新升级
#SAY
已清除旧宝石属性，开始重新升级\

第五步，做宝石回收NPC，按玩家选择的部位清除：

[@选择部位清除]
#IF
#SAY
选择要清除宝石属性的部位：\
<武器位置/@清武器> <衣服位置/@清衣服>

[@清武器]
#IF
#ACT
ClearStoneUpgrade 0
SendMsg 5 武器部位宝石属性已清除

第六步，保存脚本文件后重载NPC脚本，进游戏穿好带升级宝石的对应装备，点NPC验证该部位属性是否归零。

方案对比

ClearStoneUpgrade和直接把宝石取下来是两回事：

宝石属性怎么清零要看目的：想在原装备原宝石上重新洗属性用ClearStoneUpgrade，想把宝石挪走换别的才走取下流程，两者别搞混。

配套命令

宝石重置命令里，洗宝石系统是高频场景：玩家对当前宝石加成不满意，先按部位清掉旧属性，再重新走升级流程。宝石回收NPC也常用，玩家选择要重置的部位，脚本按位置编号清除，清完引导重新升级。

调试时执行了属性没变化，先确认那件装备栏位有没有镶过带升级属性的宝石，再核对位置编号是不是在0到14之间，最后检查命令是否写在#ACT执行段。

常见疑问

1. ClearStoneUpgrade清除宝石属性后还能恢复回去吗？

不能。升级属性被命令清空后不会自动还原，需要重新用宝石对这件装备做升级才能把加成打回来。执行前务必在脚本里加确认提示，告诉玩家清除不可逆，避免误点后找不回属性。（本条问题整理自百度知道真实提问：看云2026-03，对应功能词ClearStoneUpgrade，答案结合996引擎帮助文档与本地实测）

2. 清除升级属性后，装备上的宝石本身会消失吗？

不会。命令只清宝石带来的升级加成数值，宝石本身还留在装备槽位上，装备也还穿在身上。想把宝石拿下来得用取下宝石的命令，这条命令不动宝石实体。

3. 位置参数填0到14分别对应哪些装备部位？

位置编号对应身上的装备栏位，0到14依次覆盖武器、衣服、项链、头盔、手镯、戒指、腰带、靴子等各部位。写脚本前先对照自己版本的装备栏位表确认目标部位编号，填错栏位会清到别的装备上。（本条问题整理自百度知道真实提问：百度知道2008-01，对应功能词ClearStoneUpgrade，答案结合996引擎帮助文档与本地实测）

4. ClearStoneUpgrade会清背包里未穿装备的宝石属性吗？

不会。它只作用于当前穿在身上、位置编号对应的那件装备。放在背包仓库里的装备和散装宝石都不受影响，执行完背包里的东西原样保留。

5. 清除宝石属性后，装备面板数值是马上变化吗？

执行后装备属性立即更新，不用下线重登，玩家打开装备面板就能看到升级加成已经归零。如果面板没刷新，可以让玩家重新穿戴一次该装备，数值就会按清除后的状态显示。

6. 这个命令能区分极品装备和普通装备，只清普通的吗？

不能。官方说明它不区分极品和普通装备，只要目标部位装备上有宝石升级属性，清除时这些属性全部消失，没有单独保留极品加成的选项。做洗练时要按部位单独执行，别一次清多件。（本条问题整理自百度知道真实提问：百度知道2024-12，对应功能词ClearStoneUpgrade，答案结合996引擎帮助文档与本地实测）

写在最后

ClearStoneUpgrade是996引擎做宝石重置、洗宝石系统的入口命令，后接装备位置编号一个参数，范围0到14。配置链路：确认目标装备栏位、脚本加命令、重载NPC、穿对应装备验证属性归零。新手问宝石属性怎么清零，按部位位置编号写清楚就行。清除正常后，配合重新升级流程做洗宝石系统，可以承接大部分宝石属性管理类玩法。

ClearStoneUpgrade清宝石属性案例均经过本地996引擎环境实测验证；该命令仅适配996引擎，其他引擎清除宝石升级属性的写法可能不同，跨引擎使用需自行测试修改。仅供单机本地学习调试。