传奇背包宝石拖拽装备升级教程 全套脚本功能详解

一、功能核心介绍
传奇游戏中支持背包宝石拖拽至人物装备栏完成装备升级、装备鉴定操作，是传奇版本搭建、功能优化中常用的核心自定义功能，操作简单、触发便捷，大幅提升玩家装备养成体验。
该功能核心逻辑为玩家将背包内指定宝石道具，直接拖动至人物身上对应装备位置，即可触发升级、鉴定脚本机制，无需复杂指令操作，适配各类传奇复古、微变、超变版本。
特殊适配说明：本功能不支持斗笠装备位置，斗笠与头盔共用同一控件，无法单独触发宝石升级机制，其余常规装备位置均可正常适配。

二、宝石使用基础规则
想要正常触发装备升级、装备鉴定功能，宝石道具需满足固定参数要求，参数不达标将无法拖拽触发功能，具体规则如下：
1. 核心参数要求：宝石物品shape值必须等于255，仅该参数的宝石可拖拽至人物装备栏，触发升级、鉴定脚本；
2. 装备适配限制：当前功能仅支持人物基础装备升级，暂不支持时装装备扩展，所有时装类装备无法使用该宝石拖拽升级功能。

三、功能触发核心原理
整套装备宝石升级功能依托传奇脚本命令实现，无需复杂插件配置，核心通过装备位置点击字段触发对应脚本逻辑，玩家将宝石放置于人物对应装备位置即可自动执行升级、失败判定、物品回收等系列流程。

四、核心脚本字段与命令详解4.1 触发核心字段
[@ESPBSClickUserItem*] 为QF脚本专属触发字段，是宝石拖拽装备升级的核心触发入口。其中符号*为装备位置编码，取值范围0-16，对应人物身上所有常规装备位置，精准匹配不同装备的升级触发逻辑。

4.2 功能辅助命令
1. ESPCLICKFAIL：核心容错命令，多用于玩家操作条件不满足、升级判定失败场景，执行后会将玩家鼠标选中的宝石材料原路返还至背包，避免道具无故损耗；
2. ESPDELETEBS：道具清理命令，主要用于装备升级完成、升级失败的最终流程，执行后直接删除本次强化、升级所使用的宝石材料，防止出现道具卡屏、无限复用BUG。

4.3 系统内置变量
1. <$STR(S$ESPCLICKNAME)>：展示变量，用于实时显示玩家当前使用的宝石、装备升级材料具体名称，可用于系统提示、弹窗文案展示；
2. <$STR(S$ESPCLICKWHERE)>：位置变量，用于精准显示玩家当前拖拽宝石对应的人物装备位置编码，方便脚本判定、报错提示与功能调试。

五、传奇人物装备位置编码对照表(0-16)
脚本中所有装备位置判定均以以下编码为准，搭建版本、编写脚本时需严格对应，避免装备升级功能错位、失效：
0 — 盔甲
1 — 武器
2 — 照明物
3 — 项链
4 — 头盔
5 — 右手镯
6 — 左手镯
7 — 右戒指
8 — 左戒指
9 — 护身符
10 — 腰带
11 — 鞋子
12 — 宝石
13 — 斗笠(不支持宝石拖拽升级)
14 — 军鼓
15 — 马牌
16 — 盾牌

六、QF脚本完整实战示例(可直接复用)
以下为盔甲装备宝石升级完整脚本案例，包含材料判定、金币扣费、属性加成、道具删除、失败提示等完整逻辑，可直接复制用于传奇版本配置，也可根据需求修改装备位置、宝石类型、属性参数。
[@ESPBSClickUserItem0]
#if
equal <$STR(S$ESPCLICKNAME)> 防御之石+20
;记得要判断下名字，防止玩家拉其他物品到这，不判断会出现任意物品升级漏洞
CHECKGAMEGOLD > 2000
#act
SetNewItemValue <$STR(S$ESPCLICKWHERE)> 0 + 10
ESPDELETEBS  // 删除该强化所用的宝石，成功后必须调用，防止道具卡BUG复用
sendmsg 6 装备升级成功 暴击率加10
#elseact
ESPCLICKFAIL  // 升级失败返还宝石至背包，可自行修改为扣除物品不返还
sendmsg 6 装备升级失败,宝石名称：:<$STR(S$ESPCLICKNAME)>，身上序号：<$STR(S$ESPCLICKWHERE)>

七、脚本配置注意事项
1. 必须添加宝石名称判定逻辑，若缺少名称判断，玩家可使用任意道具触发升级功能，造成版本漏洞、装备数据异常；
2. 升级成功流程中必须调用ESPDELETEBS命令，及时删除升级宝石，避免玩家重复利用道具卡BUG无限升级；
3. 斗笠位置无适配权限，切勿对13号装备位置编写升级脚本，功能无法生效且易引发脚本报错；
4. 所有升级宝石需统一设置shape值为255，参数错误会导致拖拽无响应、功能无法触发。