传奇宝石升级系统完整说明：StdItems字段配置成功率失败规则NPC触发镶嵌合成与M2物品

宝石升级在传奇里分两条线。一条是背包装备用升级宝石提升已有属性、加星级或加几，走M2物品规则、QFunction的@ItemUpgrade、StdItems里StdMode=55到59的升级宝石。另一条是装备开孔后镶嵌独立宝石，走M2特色属性、StdItems里StdMode=46的镶嵌宝石。两套不要混：升级宝石改的是装备本身附加属性，镶嵌宝石是孔位挂独立石头，摘下可保留或消耗。

一、StdItems升级宝石六种类型

升级宝石常用StdMode=55、56、57、58、59，不同引擎列名略有差异，按Hero/M2帮助字段理解。

1.StdMode=55指定类型升级

Shape填目标装备StdMode，例如武器单手5就写5，衣服男10女11就写对应值。AniCount填该宝石允许升级的已加次数上限，例如10表示可升级次数小于10的装备能用。DuraMax填成功率，写20表示20%。Need控制失败结果：1到100失败后清空装备附加属性，101到200失败后装备消失，201到300失败后属性不变只扣材料。NeedLevel可限定加几范围，全开放写0；只允许+5到+10写低限65535+上限，即565535+10。AC、AC2、MAC、MAC2、DC、DC2、MC、MC2、SC、SC2填成功后的附加属性，例如武器成功加攻就写DC、DC2，衣服成功加防就写AC、AC2。

2.StdMode=56指定类型减属性降级

字段接近55，但失败处理不同。成功按DC/MC/SC/AC等加属性；失败按该宝石设定属性从装备扣除相同数值，并把装备降一级。NeedLevel可按1到100做其它限定，具体以M2版本说明为准。适合做“高风险高回报”的强化石，不适合普通小白玩家直接碰。

3.StdMode=57分类属性升级

Source=1时只加防御和魔御，AC2、MAC2填数值，目标装备必须是可加防魔的衣物、手镯等；Shape=0表示符合类型全升，填指定StdMode只升该类。Source=2时只加攻击、魔法、道术，DC2、MC2、SC2填数值，目标为武器、项链等输出装。这种宝石不做全属性，避免战士石加道术、道士石加攻击造成职业错配。

4.StdMode=58随机属性升级

Shape=0全类型，填指定StdMode只对该类生效。AniCount填随机总点数，例如5表示成功随机给装备加5点属性，由引擎在DC/MC/SC/AC等可加项里分配。失败处理按Need：小于100随机清某项或多项附加，大于100按引擎设定可配消失。部分Hero新特性里Weight=1随机全属性，Weight=2只随机攻魔道；Reserved=1也可按版本限定只随机攻魔道。适合爆率产出、做惊喜强化，不适合做固定数值养成。

5.StdMode=59成功率增幅

本身不加属性，只作为辅助石。Shape=0全类型，指定StdMode只对该类生效。DuraMax填提高的成功百分比，例如5表示主升级宝石基础概率额外加5%。使用时和55/58类主石一起放入升级界面，M2按物品规则计算总概率。

6.综合备注

55、57、58默认失败是否降低装备升级次数看引擎；Hero新特性可用Reserved控制，0不降，大于0降对应点数。DuraMax在55类通常直接作主成功率，在59类作附加成功率，不要两行都写20却期望叠加成40，具体叠加公式以M2物品规则为准。NeedLevel用65535算法只适合支持该规则的Hero类；其它引擎若没有此算法，改用M2列表限制可升最高星、最高加几。

二、背包升级按钮与QFunction触发

M2查看列表信息二、物品规则可设置禁止宝石升级的装备类型。玩家在背包装备点右下升级，或用脚本OpenUpgradeDialog打开升级窗口，放装备、放宝石、放辅助材料后确认。若要用自定义收费和额外材料，在QFunction-0.txt写@ItemUpgrade。

示例：

[@ItemUpgrade]
if

CheckGold 5000
CheckItem 升级宝石 1
act

Take 金币 5000
Take 升级宝石 1
elsesay

升级需要5000金币和1个升级宝石。
elseact

SetUpgradeFail
Break

逻辑是系统弹出升级前先跑这段，条件不满足直接中断；满足才进入M2自身成功率判定。想加矿石、灵魂、特定BOSS材料，把CheckItem换成对应物品名，Take对应数量。SetUpgradeFail用于主动判定失败并回滚收费；若只让M2按概率失败，不写SetUpgradeFail，只做扣费扣材。@ItemUpgrade必须在M2功能脚本注册才可执行，不同版本注册路径在“物品规则”或“QFunction设置”里勾选。

三、成功率、失败、保底设计

纯数据库方案：55主石DuraMax=20，表示基础20%；再配59辅石DuraMax=5，按M2规则叠加到25%。Need=30表示失败30%概率触发清附加，其余失败按M2设定不触发则仅扣材无属性变化；Need=130表示失败30%概率装备消失，其余失败仅扣材。这种配置适合中级版本。

保底方案用脚本做计数：玩家每次升级写全局或角色变量，连续失败N次后下次强制成功。QFunction里判断变量，满足保底直接给装备加DC/AC等并跳过M2概率；不满足再走正常Take宝石、系统判定。注意变量要按角色名或UID存，避免全服共享保底导致单人不限次。

防爆方案：失败只清本次附加、不消失、不降已稳定星级。用55加Need=201到300使失败属性不变，再配合脚本只扣少量材料；或者用M2“使用保护符100%不爆”规则，放护符NPC判断CheckItem护符后走强制成功分支。高价值装备建议防爆不降级，低级装备可用Need=30清属性做廉价强化。

四、装备加几上限与物品规则

M2物品规则里对可升级装备设最大升级次数、最大附加属性、允许宝石StdMode、禁止装备列表。比如武器最多+15，每次55石加DC1-3；衣服最多+10，57防石每次加AC0-1、MAC0-1。列表信息二勾选禁止某类装备升级后，即使数据库放对宝石也点不了升级按钮。

星号显示和加几不是同一概念。部分M2用DuraMax以外的星级字段、部分用附加属性次数。数据库改完要在物品规则重载，再用GM造一把白武器点升级观察“已升级次数”是否累加；不累加检查AniCount上限、Shape目标类型、M2该Stdmode是否允许升级。

五、镶嵌宝石独立系统

GOM/GEE类常用StdMode=46做镶嵌。基础设置：StdMode=46，Shape=3表示按属性类别镶嵌；AniCount映射属性种类，1防御、2魔御、3攻击、4魔法、5道术、6生命、7魔法值、8准确、9敏捷、10幸运、11攻速、12魔躲等；Source填该类属性点数，例如攻击宝石Source=3表示加3点攻击。元素属性走AC列，1暴击、2伤害、3物减、4魔减、5忽视防御、6反弹、7人物暴率等；AC2填元素点数。Reserved=0摘下宝石不消失，大于0摘下消耗。

开孔在M2物品功能、特色属性、基本选项配置；部分引擎右键宝石再点装备直接镶嵌，部分用NPC执行开孔命令。摘取道具单独建StdItems：StdMode=46、Shape=9，NPC用摘取命令把孔位宝石退回或按Reserved消耗。

镶嵌和升级区别：升级改装备自身DC/AC等基础附加，重铸后原属性可能变；镶嵌是孔位独立数值，换装备不继承，摘下可转移。养成服常两套并行，升级撑基础、镶嵌撑元素暴击攻速。

六、NPC合成与升级材料链

单纯数据库宝石只解决“放石升级”，产出要做合成NPC。Market_Def建宝石合成员：

[@main]
升级宝石合成/gemmake
高级随机宝石/gemrand

[@gemmake]
if

CheckItem 初级升级宝石 5
CheckGold 100000
act

Take 初级升级宝石 5
Take 金币 100000
Give 中级升级宝石 1
elseact

Say 需要5个初级升级宝石和10万金币。

[@gemrand]
if

CheckItem 宝石碎片 20
act

Take 宝石碎片 20
Give 随机升级宝石 1
elseact

Say 碎片不足。

数据库里初级/中级/随机分别建不同Idx、不同StdMode和DuraMax/AniCount。GM测试用@Make或版本制造命令直接出石头，再进升级界面验证概率和属性，避免只测NPC合成不测实际强化。

七、按职业与装备类型配石示例

战士武器：55石，Shape=5，DuraMax=25，AniCount=15，DC=1、DC2=3，Need=201不爆不清，NeedLevel按+0到+15用M2列表限制；辅石59，Shape=5，DuraMax=5。
法师武器：55石，Shape=5，MC=1、MC2=3；或57 Source=2只加魔法，避免误加道术。
道士武器：55石，Shape=5，SC=1、SC2=3；扇类Stdmode按版本确认，Shape填对应值。
衣服：57 Source=1，AC2=1、MAC2=1，Shape=10只让男衣，或0全衣物；高防服可用55加AC/MAC但失败规则要防爆。
首饰：57 Source=2处理项链攻魔道；手镯用57 Source=1处理防魔；戒指若引擎支持攻魔道再按Source=2。
全随机活动石：58，AniCount=5，Shape=0，Weight按版本设全属性或仅攻魔道，爆BOSS低概率掉，失败只清随机项不清底子。

八、M2相关设置清单

物品规则：开启宝石升级、勾选允许Stdmode、设禁止装备、设最大次数。
QFunction：注册@ItemUpgrade，写金币/材料/护符逻辑。
数据库StdItems：55到59建主石，46建镶嵌石，46/9建摘取道具。
MonItems/爆率：低级石给小怪，中级石给精英，58/59给BOSS，避免前期满街高成石。
机器人活动：定时发宝石碎片、开启双倍成功率时段，用SENDMSG公告，成功率仍在M2和宝石DuraMax控制。
备份：改StdItems前备DB，改QFunction前备脚本，改M2物品规则前截原配置；升级逻辑出问题直接回滚三处，不要只改数据库不回脚本。

九、常见排错

点升级没反应：M2物品规则未开该类装备，或QFunction@ItemUpgrade未注册，或Shape目标Stdmode和装备实际Stdmode不一致。
一直成功不按概率：DuraMax写成100，或脚本保底变量初始值错误每次都强制成功，或M2测试模式关了概率。
一失败就爆装：Need设在101到200，按需求改201到300防爆；若用56类型失败降级是正常机制，不是bug。
加属性不对职业：55的Shape没限定只写0全类型，或57的Source写错，攻装用了Source=1只加防就会不加攻击。
随机石只加防御不加攻击：58的Weight/Reserved按版本设成防魔优先，改Weight=2或Reserved=1只随机攻魔道。
镶嵌不显示数值：StdMode不是46、Shape不是3、AniCount属性类别错、M2特色属性未开启；右键无反应检查开孔规则和客户端补丁。
摘宝石消失：Reserved大于0即按消耗处理，想保留改0；摘取道具Stdmode/Shape不对也会导致命令不识别。
升级后星级不存：M2未重载物品规则，或数据库Stdmode被其它功能占用；用GM造白装升级一次，看已升级次数是否写入，不写入查AniCount和M2最大次数。
多引擎差异：Hero用55到59和NeedLevel 65535算法较完整；GOM/GEE部分版本偏镶嵌和脚本自定义，纯55数据库石可能要在M2特色里再开开关；3K/其它轻量引擎若没有StdMode=55体系，就用NPC脚本手动改DC/AC/MC/SC变量实现“伪宝石升级”，但失去背包装备按钮原生体验。

十、平衡参数参考

复古低变：主石DuraMax=30到50，AniCount上限+7，单次DC加1到2，Need=201防爆，59辅石只给+3到+5，产出自精英怪。
中变合击：主石DuraMax=20，辅石+5，+15封顶，失败清本次附加但不爆，56高风险石只放BOSS活动。
高变爽服：主石DuraMax=80，59辅石+10可叠到100，+30封顶，用脚本保底3次必成，材料靠日常副本。
镶嵌独立线：攻击/魔法/道术石Source=1到5，元素暴击石AC=1点起、AC2按百分比，开孔最多3到5孔，Reserved=0允许自由拆装，避免付费摘石劝退。

按数据库六种石定义属性与失败、QFunction接管收费材料、M2物品规则限类型限次数、镶嵌系统单独开孔这套并行做，传奇宝石升级既能走原生背包装备按钮，也能用NPC合成产出。排错先分是数据库不认石、M2不让升、脚本扣材不进概率、还是镶嵌补丁不对，一次只改一类最稳。