一、穿戴触发脚本核心逻辑与适用场景
传奇穿戴触发脚本核心是通过检测角色穿戴/卸下装备的动作，触发对应属性变更、特效展示、任务推进等逻辑，依托引擎自带穿戴检测命令实现，无需额外工具。脚本适配所有主流引擎（HERO、BLUE、GOM），仅命令格式略有差异。
适用场景涵盖：穿戴装备附加专属属性/技能、激活套装效果、触发剧情对话、解锁地图权限、显示专属光影特效等，可大幅提升装备辨识度与玩法趣味性，常见于特色套装、专属武器、任务装备的功能配置。
二、设置前核心准备（命令+文件定位）
1. 必备核心命令（分引擎）
穿戴检测核心命令为装备ID识别与动作判定，不同引擎命令格式不同，需针对性选用，避免脚本失效。
HERO引擎：CHECKITEMWEAR（检测是否穿戴指定装备）、@ItemWear（穿戴触发入口）、@ItemUnWear（卸下触发入口）；
BLUE引擎：WEARITEM（穿戴触发命令）、UNWEARITEM（卸下触发命令），支持直接绑定装备ID触发；
GOM引擎：OnWearItem（穿戴触发函数）、OnUnWearItem（卸下触发函数），需搭配全局变量存储状态。
辅助命令：ADDATTRIBUTE（添加属性）、DELATTRIBUTE（删除属性）、PLAYSOUND（播放音效）、SHOWEFFECT（显示特效）、MAPALLOW（解锁地图），用于实现穿戴后的附加效果。
2. 核心文件定位
脚本需写入服务端对应文件，确保引擎加载生效：主流路径为服务端\Data\QuestDiary.txt（通用脚本文件），部分引擎支持单独创建WearScript.txt（穿戴脚本专属文件），需在引擎配置中勾选“加载穿戴脚本”选项。
提前获取目标装备ID（通过引擎物品编辑器查看），记录装备部位（武器、头盔、衣服等），避免脚本绑定错误装备。
三、穿戴触发脚本核心模块设置（分场景实操）
按功能场景分类设置脚本，每个模块聚焦单一效果，通过“检测穿戴-触发效果-状态维持”逻辑编写，兼顾稳定性与可扩展性。
1. 装备穿戴附加属性/技能（基础模块）
核心需求：穿戴指定装备后附加固定属性（攻击、防御、血量等）或解锁专属技能，卸下后属性/技能自动失效，避免永久加成异常。
HERO引擎脚本案例（穿戴武器附加属性与技能）：
[@ItemWear721] （721为目标武器ID，前缀@ItemWear+装备ID触发）
#IF
CHECKITEMWEAR 721 （确认已穿戴目标装备）
#ACT
ADDATTRIBUTE 攻击 50 （附加50点攻击）
ADDATTRIBUTE 血量上限 200 （附加200点血量）
ADDSKILL 烈火剑法 3 （解锁3级烈火剑法，无技能书也可使用）
PLAYSOUND 108 （播放穿戴成功音效，108为音效编号）
MESSAGEBOX [系统提示]：穿戴成功！获得专属属性与技能加成！
#ELSEACT
DELATTRIBUTE 攻击 50 （卸下后删除攻击加成）
DELATTRIBUTE 血量上限 200 （删除血量加成）
DELskill 烈火剑法 （卸下后移除技能）
说明：脚本需绑定装备ID，卸下时通过反向命令清除加成，避免属性叠加异常，适合专属武器、防具的属性配置。
2. 套装效果触发（多装备组合模块）
核心需求：穿戴指定数量套装部件后，触发组合效果（属性叠加、特效展示），部件数量不足时效果失效，支持2-6件套装组合。
BLUE引擎脚本案例（3件套装触发效果）：
[@套装检测]
#IF
CHECKITEMWEAR 721 （套装武器ID）
CHECKITEMWEAR 832 （套装衣服ID）
CHECKITEMWEAR 943 （套装头盔ID）
#ACT
ADDATTRIBUTE 全属性 30 （三件套附加30点全属性）
SHOWEFFECT 角色 25 （角色周身显示光影特效，25为特效编号）
MESSAGEBOX [套装效果]：三件套激活！全属性加成与专属特效生效！
#ELSEIF
CHECKITEMWEAR 721 （仅穿戴武器）
#ACT
ADDATTRIBUTE 攻击 20 （单件武器基础加成）
#ELSEACT
DELATTRIBUTE 全属性 30 （套装部件不足，清除组合加成）
DELATTRIBUTE 攻击 20 （卸下武器，清除单件加成）
STOPEFFECT 角色 25 （关闭光影特效）
补充：需在角色穿戴/卸下任意套装部件时触发检测脚本，可通过@ItemWear、@ItemUnWear绑定各部件ID，实现套装效果实时切换。
3. 穿戴触发剧情/地图权限（任务关联模块）
核心需求：穿戴任务装备后，触发剧情对话、解锁隐藏地图或推进任务进度，常见于主线任务、隐藏副本的开启场景。
GOM引擎脚本案例（穿戴任务装备解锁地图）：
OnWearItem 1054 （1054为任务装备ID，穿戴时触发）
{
MAPALLOW 15 （解锁ID为15的隐藏地图）
NPCSAY 神秘老人：穿戴此装备，方能踏入秘境！（触发NPC对话）
SETQUEST 1 5 （推进主线任务至第5步）
PLAYSOUND 112 （播放剧情音效）
}
OnUnWearItem 1054 （卸下装备时触发）
{
MAPFORBID 15 （卸下装备后禁止进入隐藏地图）
MESSAGEBOX [提示]：卸下任务装备，已无法进入秘境！
}
说明：地图权限控制需配合MapInfo.txt文件，确保解锁的地图ID与脚本一致，任务进度通过SETQUEST命令同步，便于后续任务衔接。
4. 穿戴触发特殊交互（趣味功能模块）
核心需求：穿戴指定装备后，触发特殊交互效果（如召唤宠物、传送至指定地点、临时变身等），提升玩法多样性。
通用脚本案例（穿戴装备召唤宠物）：
[@ItemWear1165] （1165为召唤类装备ID）
#IF
CHECKITEMWEAR 1165
CHECKPET 0 （无宠物召唤状态）
#ACT
CALLPET 幽冥狼 1 （召唤1只幽冥狼宠物）
ADDATTRIBUTE 宠物攻击 100 （强化召唤宠物属性）
MESSAGEBOX [提示]：已召唤专属宠物，持续至卸下装备！
#ELSEACT
STOPPET （卸下装备，收回宠物）
MESSAGEBOX [提示]：装备卸下，专属宠物已收回！
四、脚本设置关键技巧（避坑+强化效果）
1. 状态同步与冲突规避
穿戴与卸下脚本需严格对应，附加属性、技能、特效需在卸下时反向清除，避免属性叠加、特效残留。若同一装备绑定多重效果，需按“属性-技能-特效”顺序编写，优先执行核心效果，再触发附加交互。
避免多装备效果冲突，如两件装备均附加攻击属性，需明确加成优先级，可通过设置属性类别（临时/永久）区分，穿戴触发脚本仅添加临时属性，卸下自动清除。
2. 引擎适配与命令修正
不同引擎命令不可通用，如GOM引擎需用函数格式（OnWearItem），HERO引擎需用入口标签（@ItemWear+ID），编写前需核对引擎命令手册，替换对应格式。
部分引擎支持批量穿戴检测，可通过循环命令遍历装备ID，减少重复代码，如检测全套装部件时，用LOOP命令依次校验各部件ID，提升脚本简洁度。
3. 效果可视化与反馈优化
添加音效、弹窗提示、光影特效，让穿戴效果更直观，如穿戴成功播放专属音效、弹窗提示加成内容，套装效果触发时显示周身光影，提升玩家体验。
避免频繁弹窗干扰，可设置弹窗冷却时间，同一效果短时间内重复触发时，仅更新状态，不重复弹出提示。
4. 权限控制与防滥用
对特殊效果脚本添加权限校验，如GM装备的穿戴效果仅对指定账号开放，通过CHECKADMIN命令限制使用范围，避免普通玩家滥用。
设置装备穿戴等级限制，脚本中添加CHECKLEVEL命令，若角色等级不足，禁止穿戴并触发提示，确保效果与角色等级匹配。
五、脚本部署与测试排查（实操落地）
1. 部署步骤
将编写好的脚本写入对应文件（QuestDiary.txt或专属穿戴脚本文件），保存后重启引擎，确保脚本加载生效。若为单独创建的专属文件，需在引擎“脚本配置”中添加文件路径，勾选“启用穿戴触发”选项。
绑定触发入口：单件装备触发脚本直接通过@ItemWear+装备ID绑定；套装、组合效果需在各部件穿戴/卸下时触发检测脚本，确保效果实时同步。
2. 测试与问题排查
测试核心场景：穿戴装备是否触发对应效果、卸下后效果是否清除、多装备组合是否正常触发套装效果、不同角色等级穿戴是否符合权限要求。
常见问题解决：
1. 脚本不触发：核对装备ID是否正确、命令格式是否适配引擎、脚本文件路径是否在引擎加载范围内，重启引擎重新加载脚本；
2. 效果残留：检查卸下脚本是否完整，确保附加属性、特效、技能均有反向清除命令，避免卸下装备后效果持续生效；
3. 冲突报错：排查是否存在同ID装备重复绑定脚本、命令参数错误（如特效编号、地图ID错误），通过引擎日志定位报错位置并修正。
六、常见场景扩展脚本（直接复用）
1. 穿戴装备变身效果
[@ItemWear1278]
#IF
CHECKITEMWEAR 1278
#ACT
CHANGELOOK 10 （变身为指定造型，10为造型ID）
ADDATTRIBUTE 防御 80 （变身附加防御加成）
#ELSEACT
CHANGELOOK 0 （恢复原造型）
DELATTRIBUTE 防御 80
2. 穿戴装备自动回血
[@ItemWear1389]
#IF
CHECKITEMWEAR 1389
#ACT
HP +5 每2秒 （每2秒回血5点，循环触发）
GOTO @ItemWear1389
#ELSEACT
STOPHP （停止自动回血）
