宝石升级系统脚本教程 - 装备属性强化玩法

GOM引擎宝石升级系统是传奇版本中核心的装备强化功能，依托专属脚本与宝石参数配置，可实现装备属性提升、成功率调节、失败惩罚自定义等效果。

本教程适配全版本GOM引擎，针对55/56/57/58/59五类升级宝石，覆盖装备定向升级、随机属性、成功率加成等全部玩法场景。

跟随本文可完整搭建宝石升级功能，掌握参数配置、脚本编写、报错修复技巧，零基础GM也能快速落地上线。

一、宝石升级系统功能整体介绍

GOM引擎宝石升级系统分为界面触发与脚本逻辑两大核心部分，支持两种升级触发方式，适配玩家自助升级与后台自定义触发场景。

玩家可直接打开人物背包右下角升级按钮开启升级界面，GM也可通过专属命令手动调用升级弹窗，灵活适配版本玩法设计。

装备升级全程由Q-Function脚本管控，升级成功、失败、属性清除均对应独立脚本段，可自定义不同场景的执行逻辑。

二、升级系统核心脚本命令详解

2.1 界面打开命令

OpenUpgradeDialog为升级界面专属调用命令，可绕过背包按钮，直接触发装备升级弹窗，常用于NPC快捷升级玩法定制。

2.2 四大核心脚本触发段

所有宝石升级操作均依托Q-Function.txt脚本执行，四个核心脚本段覆盖全流程状态判定，X为装备位置序号。

• @ItemUpgrade：升级前置触发段，放置升级扣费、权限判定、条件校验等前置逻辑

• @UpgradeOKX：升级成功触发段，X为装备位置，可自定义成功奖励、系统提示等效果

• @UpgradeFailX：升级失败触发段，配置失败惩罚、提示文案等逻辑

• @UpgradeClearX：装备属性清除触发段，适配升级失败属性清零场景

2.3 基础扣费脚本案例（可直接复用）

以下为经典金币扣费升级脚本，放入Q-Function.txt即可实现基础升级扣费校验，新手可直接照搬使用。

[@ItemUpgrade]
#IF
CheckGold 5000
#ACT
Take 金币 5000
#ELSESAY 
升级装备需要5000金币.
#ELSEACT
SetUpgradeFail
Break

三、五类升级宝石参数详解（StdMode分类）

GOM引擎升级宝石统一使用StdMode55、56、57、58、59五类参数，每类宝石功能定位、配置规则独立，以下为全参数拆解。

3.1 StdMode=55 定向装备升级宝石

核心功能为升级指定类型装备，精准匹配单一装备品类，适合定制专属武器、衣服等单品强化玩法。

3.2 StdMode=57 防御魔御专属升级宝石（Source=1）

专属防具强化宝石，仅提升装备防御、魔御属性，适配衣服、手镯、头盔等防御类装备，不增加攻击输出属性。

3.3 StdMode=57 攻道魔专属升级宝石（Source=2）

专属输出装备强化宝石，仅提升攻击、魔法、道术属性，适配武器、项链、戒指等输出类装备。

3.4 StdMode=58 随机属性升级宝石

随机性强化宝石，升级后随机为装备增加属性，可自定义随机属性范围，失败后支持随机清除附加属性。

3.5 StdMode=59 升级成功率加成宝石

辅助功能宝石，无属性强化效果，专门用于提升装备升级成功率，可搭配各类升级宝石使用，降低升级失败概率。

四、宝石升级系统最新新特性配置

GOM引擎新版优化了升级失败星星掉落规则，新增Reserved字段控制星星损耗，适配高端版本玩法定制。

4.1 装备升级星星数掉落规则

55、56、57、58四类宝石默认升级失败不扣除装备星星数，无需额外配置即可生效。

如需开启星星掉落功能，只需设置宝石物品Reserved字段，Reserved数值即为失败扣除星星数量。

实操案例：宝石Reserved=2，装备当前3颗星星，升级失败后自动扣除2颗，剩余1颗星星，适配高风险高回报升级玩法。

4.2 58类随机宝石属性细分规则

通过Weight字段精准控制随机属性范围，解决随机属性杂乱、不符合版本定位的问题，优化玩家体验。

Weight=1：全局随机，装备所有攻防、道术、魔法、防御属性均可随机提升。

Weight=2：定向随机，仅提升攻击、魔法、道术三大输出属性，适合输出装备专属强化。

五、零基础搭建宝石升级系统实操步骤

全程分步操作，无需专业脚本基础，按步骤配置即可完美开通宝石升级功能。

1. 打开传奇版本服务端，找到Q-Function.txt脚本文件，路径为服务端Mir200\Envir\QuestDiary系统目录。

2. 将上文对应的升级前置脚本、成功/失败触发脚本粘贴至文件末尾，保存文件并关闭。

3. 打开物品数据库，新增升级宝石，对应设置StdMode、Shape、DuraMax等全套参数。

4. 根据玩法需求配置Reserved、Weight等进阶参数，设置星星掉落、随机属性规则。

5. 重启M2引擎，重载脚本与物品数据库，玩家即可通过背包按钮或命令开启升级界面使用功能。

六、高频报错与功能失效排错方案

6.1 放入宝石无法点击升级、界面无反应

问题现象：打开升级界面，放入装备和宝石后，升级按钮灰色无法点击。

核心成因：宝石StdMode设置错误、装备类型与宝石Shape参数不匹配、装备升级次数超出AniCount限制。

排查步骤：核对宝石StdMode是否为55-59区间，检查Shape数值是否适配当前装备，查看装备现有升级次数是否超标。

修复方案：修正宝石参数，更换对应适配装备，或调高宝石AniCount升级次数上限。

6.2 升级成功无属性加成

问题现象：提示升级成功，但装备属性无任何变化。

核心成因：宝石属性参数配置为空、宝石类型与装备品类不匹配（如防御宝石用于输出装备）。

排查步骤：核对57类宝石Source数值，确认攻防属性参数是否对应装备类型，检查属性数值是否有效。

修复方案：重新配置对应属性参数，严格区分输出、防御宝石的适配装备类型。

6.3 升级失败不扣除星星数

问题现象：设置Reserved参数后，升级失败装备星星无损耗。

核心成因：仅55/56/57/58宝石支持星星掉落，59成功率宝石无该功能，且参数未生效重载。

排查步骤：确认宝石StdMode类型，检查Reserved数值是否大于0，是否重载物品数据库。

修复方案：更换对应类型宝石，设置Reserved≥1，重启M2引擎重载数据。

七、宝石升级系统设置避坑注意事项

1. 严格区分各类宝石适配场景，57类Source1/2参数不可混用，否则会出现属性添加无效、功能异常问题。

2. Need参数区间不可错乱，1-100、101-200、201-300惩罚规则互不重叠，数值错乱会导致失败机制失效。

3. NeedLevel等级区间计算公式固定，必须遵循低限*65535+上限规则，数值填写错误会导致装备无法升级。

4. 58随机宝石Weight参数按需设置，版本主打平衡玩法建议设置2，避免全属性随机导致装备属性超标。

5. 星星掉落功能仅指定四类宝石支持，成功率宝石无法配置星星损耗，避免无效参数设置浪费配置时间。

八、高频实操FAQ问答

8.1 如何设置全装备通用的成功率提升宝石？

选择StdMode=59宝石，设置Shape=0，DuraMax填写对应成功率数值，无需额外配置其他参数，即可适配所有装备升级场景，通用提升成功率。

8.2 升级失败不想清空装备属性怎么设置？

将宝石Need参数设置为201-300区间，升级失败后装备当前所有属性、星星数均保持不变，无任何惩罚，适合新手福利版本配置。

8.3 怎么限制装备只能升级5-10次？

通过NeedLevel参数设置，计算公式为5*65535+10，填写后仅升级次数在5-10次之间的装备可使用该宝石升级，精准限制强化区间。

8.4 58随机宝石怎么只加攻击道术魔法？

将宝石Weight参数设置为2，即可锁定仅随机增加攻击、魔法、道术三类输出属性，不会生成防御、血量等无关属性。

九、全文总结

本文全覆盖GOM引擎宝石升级系统的五类核心宝石参数、脚本逻辑、实操搭建与排错技巧。

通过区分定向升级、随机属性、成功率加成等不同宝石玩法，搭配自定义失败惩罚、星星掉落规则，可灵活适配各类传奇版本的装备强化玩法需求。

所有脚本与参数均可直接照搬使用，零基础GM可快速完成功能上线，同时支持高阶定制优化。