本文聚焦传奇装备加星砸星的核心需求，详细拆解加星规则、材料配置逻辑，提供HERO、GOM、BLUE三大主流引擎的加星脚本实现方案，脚本可直接套用，同时涵盖成功率调整、失败惩罚设置等实用技巧。
一、传奇装备加星砸星基础规则设定
加星砸星是传奇核心养成玩法，核心逻辑为：消耗指定材料触发加星判定，按设定成功率晋升星阶，失败可能保留当前星阶、掉星或损坏装备。常见基础规则需提前明确，避免脚本逻辑冲突：
1. 加星材料：核心材料为“加星石”（可自定义名称，如星陨石、强化晶石），高阶加星可额外需求“保护符”（用于降低失败惩罚）；不同星阶消耗材料数量不同，如1-3星需1个加星石，4-6星需2个加星石。
2. 成功率机制：星阶越高成功率越低，如1星升2星成功率80%，6星升7星成功率20%；可通过消耗保护符提升成功率，或设定“保底机制”（如连续失败3次后成功率提升50%）。
3. 失败惩罚：分三级设定，轻度惩罚（失败不掉星，仅消耗材料）、中度惩罚（失败掉1-2星，消耗材料）、重度惩罚（失败装备损坏消失，消耗材料），可按星阶区分，高阶加星失败惩罚更严重。
二、主流引擎装备加星脚本实现方案
1. HERO引擎装备加星脚本（含成功率+保护符机制）
HERO引擎通过“QFunction-0.txt”或NPC专属脚本实现加星，以下以“1-7星”加星为例，包含基础加星、保护符适配、失败掉星逻辑：
;传奇装备加星砸星脚本（HERO引擎）
;触发条件：玩家手持目标装备，点击NPC触发加星
#if
;校验是否手持装备（可替换为指定装备，如checkitem 裁决之杖 1）
CheckItemInHand 1 ;1代表任意装备，指定装备需写完整名称
;基础加星材料校验（1-3星通用，消耗1个加星石）
CheckItem 加星石 1
#act
;获取装备当前星阶（通过装备附加属性存储，如星阶属性名为“StarLevel”）
LocalStar = GetItemVarInHand(StarLevel)
;1星升2星（成功率80%）
if LocalStar == 1
RANDOM 100
if <= 80
;加星成功：更新星阶属性，消耗材料
SetItemVarInHand(StarLevel, 2)
Take 加星石 1
SendMsg 1 恭喜勇士！装备成功晋升2星，属性大幅提升！
else
;加星失败：轻度惩罚，仅消耗材料
Take 加星石 1
SendMsg 1 加星失败！材料已消耗，当前星阶保持1星！
endif
;2星升3星（成功率70%）
elseif LocalStar == 2
RANDOM 100
if <= 70
SetItemVarInHand(StarLevel, 3)
Take 加星石 1
SendMsg 1 装备成功晋升3星，继续加油！
else
Take 加星石 1
SendMsg 1 加星失败，星阶未变！
endif
;4-6星加星（需2个加星石，可搭配保护符）
elseif LocalStar >=3 and LocalStar <6
CheckItem 加星石 2
#act
;判断是否携带保护符（携带则失败不掉星）
if CheckItem 保护符 1
RANDOM 100
;4星升5星成功率50%，5星升6星成功率40%
if (LocalStar ==3 and <=50) or (LocalStar ==4 and <=40)
;成功：升星+消耗材料+保护符
SetItemVarInHand(StarLevel, LocalStar+1)
Take 加星石 2
Take 保护符 1
SendMsg 1 借助保护符之力，装备成功晋升至{LocalStar+1}星！
else
;失败：消耗材料+保护符，不掉星
Take 加星石 2
Take 保护符 1
SendMsg 1 加星失败，保护符生效，星阶未掉！
endif
else
;未携带保护符，失败掉1星
RANDOM 100
if (LocalStar ==3 and <=50) or (LocalStar ==4 and <=40)
SetItemVarInHand(StarLevel, LocalStar+1)
Take 加星石 2
SendMsg 1 装备成功晋升至{LocalStar+1}星！
else
SetItemVarInHand(StarLevel, LocalStar-1)
Take 加星石 2
SendMsg 1 加星失败！星阶掉1级，材料已消耗！
endif
endif
;6星升7星（需3个加星石，成功率20%，失败有概率损坏装备）
elseif LocalStar ==6
CheckItem 加星石 3
#act
RANDOM 100
if <=20
SetItemVarInHand(StarLevel,7)
Take 加星石 3
SendMsg 1 逆天改命！装备成功晋升7星，成为顶级神装！
else
;失败概率判定：30%损坏装备，70%掉至4星
RANDOM 100
if <=30
;装备损坏，删除手持装备
DelItemInHand 1
SendMsg 1 加星失败！装备已损坏消失！
else
SetItemVarInHand(StarLevel,4)
Take 加星石 3
SendMsg 1 加星失败！星阶跌至4星，材料已消耗！
endif
endif
#ELSEACT
MESSAGEBOX 加星条件不满足！请确认：1.手持需加星装备；2.携带足够加星石（1-3星需1个，4-6星需2个，7星需3个）
关键说明：脚本中“StarLevel”为装备星阶存储变量，需提前在引擎“物品属性配置”中添加该自定义属性；“CheckItemInHand 1”代表任意手持装备，若需指定装备加星，替换为“CheckItemInHand 裁决之杖 1”即可。
2. GOM引擎装备加星脚本（含保底机制）
GOM引擎支持通过“QFunction-1.txt”实现加星逻辑，以下脚本新增“连续失败3次保底成功”机制，提升玩法体验：
;传奇装备加星砸星脚本（GOM引擎）
;注册加星触发函数
Function EquipmentStarUpgrade()
;获取手持装备信息
local itemName = GetHandItemName()
if itemName == "" then
MsgBox "请手持需要加星的装备！"
return false
end
;获取当前星阶与失败次数
local starLevel = GetItemVar(itemName, "StarLevel")
local failCount = GetRoleVar("StarFailCount")
;材料校验（按星阶区分消耗）
local needStone = 1
if starLevel >=3 then needStone =2 end
if starLevel ==6 then needStone =3 end
if not CheckItem("加星石", needStone) then
MsgBox "加星石数量不足！"
return false
end
;保底机制：连续失败3次，本次100%成功
if failCount >=3 then
SetItemVar(itemName, "StarLevel", starLevel+1)
TakeItem("加星石", needStone)
SetRoleVar("StarFailCount", 0)
MsgBox "恭喜！连续失败3次触发保底，装备成功晋升至"..(starLevel+1).."星！"
return true
end
;设定各星阶成功率
local successRate = 0
if starLevel ==1 then successRate=80 end
if starLevel ==2 then successRate=70 end
if starLevel ==3 then successRate=50 end
if starLevel ==4 then successRate=40 end
if starLevel ==5 then successRate=30 end
if starLevel ==6 then successRate=20 end
;成功率判定
local randomNum = Random(100)
if randomNum <= successRate then
;加星成功
SetItemVar(itemName, "StarLevel", starLevel+1)
TakeItem("加星石", needStone)
SetRoleVar("StarFailCount", 0)
MsgBox "装备成功晋升至"..(starLevel+1).."星！"
else
;加星失败，更新失败次数
TakeItem("加星石", needStone)
SetRoleVar("StarFailCount", failCount+1)
;失败惩罚：高阶掉星，低阶不掉星
if starLevel >=3 then
SetItemVar(itemName, "StarLevel", starLevel-1)
MsgBox "加星失败！星阶掉1级，已连续失败"..(failCount+1).."次！"
else
MsgBox "加星失败！星阶未变，已连续失败"..(failCount+1).."次！"
end
end
return true
EndFunction
使用方法：将脚本写入“QFunction-1.txt”，在合成NPC对话脚本中添加“CallFunc EquipmentStarUpgrade()”，点击NPC即可触发加星；“StarFailCount”为角色连续失败次数存储变量，离线后不清零，可根据需求添加“每日重置失败次数”逻辑。
3. BLUE引擎装备加星脚本（简洁版，适配新手）
BLUE引擎脚本语法更简洁，以下为基础版加星脚本，包含核心加星逻辑，适合新手服主快速配置：
-- 传奇装备加星砸星脚本（BLUE引擎）
RegisterMerchantEvent(1001, "Click", function(player)
-- 1001为加星NPC编号，需在NPC配置中对应
local handItem = player:GetHandItem()
if not handItem then
player:SendMsg(1, "请手持需要加星的装备！")
return
end
-- 获取星阶与材料消耗
local star = handItem:GetVar("Star") or 0
local stoneCount = star <3 and 1 or (star <6 and 2 or 3)
-- 材料校验
if not player:CheckItem("加星石", stoneCount) then
player:SendMsg(1, "加星石数量不足，无法加星！")
return
end
-- 成功率设定
local rate = {80,70,50,40,30,20}
local successRate = star <6 and rate[star+1] or 20
-- 判定结果
if math.random(100) <= successRate then
-- 成功升星
handItem:SetVar("Star", star+1)
player:TakeItem("加星石", stoneCount)
player:SendMsg(1, "装备加星成功，当前星阶："..(star+1).."星！")
else
-- 失败惩罚
player:TakeItem("加星石", stoneCount)
if star >=3 then
handItem:SetVar("Star", star-1)
player:SendMsg(1, "加星失败，星阶掉至"..(star-1).."星！")
else
player:SendMsg(1, "加星失败，星阶未变！")
end
end
end)
使用方法：新建脚本文件“EquipmentStar.lua”，放入BLUE引擎“Scripts”文件夹，在引擎控制台加载该脚本即可；可通过修改“rate”数组调整各星阶成功率，修改“stoneCount”逻辑调整材料消耗数量。
三、装备加星脚本核心参数调整技巧
1. 成功率调整：HERO引擎修改“RANDOM 100”后的“if <= 数值”，如1星升2星成功率从80%改为90%，将“if <=80”改为“if <=90”；GOM和BLUE引擎直接修改成功率变量（如successRate数值）即可。
2. 材料消耗调整：修改脚本中“Take 加星石 X”“TakeItem("加星石", X)”中的“X”数值，如4-6星加星从消耗2个加星石改为3个，替换对应数值即可；也可新增材料需求，如高阶加星需同时消耗“加星石”和“元宝”，添加“CheckItem 元宝 1000”“Take 元宝 1000”指令。
3. 失败惩罚调整：轻度惩罚（仅消耗材料）删除掉星相关指令（如SetItemVarInHand(StarLevel, LocalStar-1)）；重度惩罚（装备损坏）添加“DelItemInHand 1”（HERO）、“player:RemoveItem(handItem)”（BLUE）指令，需谨慎使用。
四、脚本测试与常见问题排查
1. 测试步骤：创建测试账号，获取不同星阶装备和加星材料，依次测试低星升阶、高阶升阶、材料不足、未持装备、携带保护符、连续失败触发保底等场景，确保每种逻辑正常触发。
2. 常见问题解决：①加星无反应：检查NPC编号、脚本文件是否正确加载，装备自定义属性（如StarLevel）是否已添加；②成功率异常：核对星阶与成功率的对应关系，确保随机数生成逻辑正确；③装备星阶不保存：确认使用“SetItemVar”类指令（存储在装备上），而非角色变量（存储在角色上）。
