传奇沙城武器升级脚本教程：破碎触发与成功率调整指南
在传奇服务端架设与版本修改中，沙城武器升级是核心玩法模块，很多开发者会遇到升级破碎无提示、成功率无法自定义调整等问题。本文详解沙城武器升级破碎触发脚本、成功率追加指令用法，附带可直接复用的完整脚本代码，适配996引擎，帮助开发者快速优化武器升级玩法。一、沙城武器升级破碎/成功触发脚本该段脚本用于监听…
在传奇服务端架设与版本修改中，沙城武器升级是核心玩法模块，很多开发者会遇到升级破碎无提示、成功率无法自定义调整等问题。本文详解沙城武器升级破碎触发脚本、成功率追加指令用法，附带可直接复用的完整脚本代码，适配996引擎，帮助开发者快速优化武器升级玩法。
一、沙城武器升级破碎/成功触发脚本
该段脚本用于监听沙城武器升级的两种核心结果，分别对应升级失败（破碎）与升级成功场景，可自定义玩家弹窗提示信息，适配所有支持物品升级触发段的传奇引擎。
1.1 武器升级失败（破碎）触发脚本
触发场景：玩家在沙城进行武器升级，判定失败、武器破碎时自动执行，可自定义系统提示文案。
[@TakeWeaponByUpgradeFail]
#IF
#ACT
SENDMSG 5 您的武器升级失败
STOP
脚本说明：STOP指令用于终止后续逻辑，避免失败后叠加执行其他升级相关命令；SENDMSG 5为系统级弹窗提示，全区可见或玩家专属提示，可根据需求修改提示文本。
1.2 武器升级成功触发脚本
触发场景：武器升级判定成功后执行，可回显当前升级武器的名称、索引ID、唯一ID三大核心参数，方便日志记录、属性溯源。
[@TakeWeaponByUpgradeOK]
#IF
#ACT
SENDMSG 5 您的武器升级成功物品名字--<$Param1> 物品IDX--<$Param2> 物品唯一ID--<$Param3>
参数释义：<$Param1>=当前升级武器名称；<$Param2>=物品索引ID；<$Param3>=物品全局唯一ID，可用于防止复制装备、溯源异常道具。
二、自定义沙城武器升级成功率配置
默认引擎的沙城武器升级成功率由系统底层算法固定，如需针对玩家、NPC活动、会员特权等场景调整成功率，可使用专属追加指令实现概率自定义。
2.1 核心指令：SetUpgradeRandom
指令作用：为当前角色追加沙城武器升级成功率，基于系统原始成功率进行数值叠加，不修改底层算法，兼容性更强。
语法格式：SetUpgradeRandom 参数1（百分比数值）
2.2 成功率叠加规则
该指令采用后置追加计算逻辑，计算优先级为：系统原始成功率 + 指令追加成功率 = 最终成功率，具体规则如下：
1. 基础叠加：系统算法结算原始成功率后，直接追加设置百分比。例：系统原始成功率5%，指令追加50%，玩家最终成功率为55%；
2. 必成机制：追加百分比≥95%时，极易触发必成；追加100%直接强制必成；
3. 数值封顶：无论叠加后数值多高，最终成功率上限固定为100%，无溢出风险。
2.3 完整可运行示例脚本
以下脚本可挂载至NPC对话、登录触发、礼包调用等场景，玩家触发后即时提升本次沙城武器升级成功率：
;沙城武器升级成功率增益脚本
[@main]
#IF
#ACT
SetUpgradeRandom 50
SENDMSG 7 您在沙城升级武器的成功率提升了50%
脚本说明：SENDMSG 7为彩色专属提示，仅当前玩家可见；修改指令后的数字，即可调整成功率追加幅度，适配会员专属增益、活动临时加成等场景。
三、脚本使用注意事项
1. 路径存放：所有脚本需放置在服务端Envir\Market_Def文件夹内，与沙城升级NPC脚本同目录，避免触发失效；
2. 引擎适配：该脚本全兼容996传奇引擎，无专属函数，无需额外加载插件；
3. 权限管控：成功率追加指令建议仅限NPC、活动逻辑调用，禁止开放给普通角色自主执行，防止破坏版本平衡；
4. 提示优化：可根据版本风格修改SENDMSG后的提示文本与颜色代码，贴合服内UI调性。
