一、核心奖励类型及对应脚本命令
传奇奖励脚本核心围绕道具、货币、属性、称号四类奖励展开，需结合对应命令实现发放逻辑，适配不同交互场景。
（一）道具奖励脚本命令及用法
道具奖励分背包发放、佩戴发放两类，支持指定数量、绑定状态，核心命令如下：
1.give物品名称数量：基储放命令，向玩家背包发放指定数量物品，可叠加物品自动合并，适用于普通道具。示例：give疗伤药10，向玩家发放10瓶疗伤药。
2.givebind物品名称数量：发放绑定道具，绑定后不可交易、丢弃，适用于任务专属奖励。示例：givebind烈火剑法1，发放绑定版烈火剑法技能书。
3.givew物品名称数量：直接发放至玩家装备栏对应位置，无对应位置则存入背包，适用于装备奖励。示例：givew裁决之杖1，发放裁决之杖至武器栏或背包。
注意：发放前需用checkbaggage命令检测背包空格，避免道具发放失败。
（二）货币奖励脚本命令及用法
货币奖励覆盖金币、元宝两类核心货币，支持增减、赋值操作，命令适配全版本通用场景。
1.givegold数值：发放金币，直接增加玩家背包金币数量。示例：givegold10000，发放10000金币。
2.GAMEGOLD符号数值：调整元宝数量，符号支持+（增加）、-（减少）、=（赋值）。示例：GAMEGOLD+50，增加50元宝；GAMEGOLD=100，将元宝数量设为100。
3.giveingot数值：发放金条、金砖等货币道具，需对应道具名称。示例：giveingot金砖2，发放2块金砖。
（三）属性奖励脚本命令及用法
属性奖励含临时加成、永久加成两种，需区分时效控制，避免属性异常叠加。
1.永久属性：ChangeHumanAttr属性类型数值，直接修改玩家永久属性。示例：ChangeHumanAttr攻击5，永久增加5点攻击；ChangeHumanAttr防御3，永久增加3点防御。
2.临时属性：BuffAddbuff编号时长等级，添加临时属性加成buff。示例：BuffAdd136002，添加编号1的buff，持续3600秒（1小时），等级2。
3.技能奖励：AddSkill技能名称等级，为玩家添加指定等级技能。示例：AddSkill召唤神兽3，为玩家添加3级召唤神兽技能。
（四）称号奖励脚本命令及用法
称号奖励通过修改玩家头顶标识实现，部分版本支持称号附带属性，命令如下：
1.SETRANKLEVELNAME称号文本：基础称号设置，直接替换玩家现有称号。示例：SETRANKLEVELNAME传奇勇士，为玩家设置“传奇勇士”称号。
2.AddTitle称号ID时长：添加带时效的称号，需提前在称号配置文件中定义ID对应称号及属性。示例：AddTitle586400，添加ID为5的称号，持续86400秒（24小时）。
二、常见奖励场景脚本编写实操
结合NPC交互、任务完成、活动触发三类高频场景，提供完整脚本示例，可直接复制修改后使用。
（一）NPC对话触发奖励脚本
适用于新手引导、日常领取奖励场景，通过对话选项触发奖励发放，含条件检测逻辑。
脚本示例：
(@Main)
#SAY
欢迎领取每日奖励！\
点击领取/@GetReward
(@GetReward)
#IF
checkday1；检测是否今日已领取
#SAY
你今日已领取奖励，明日再来！
@exit
#ELSEACT
give疗伤药20；发放道具
givegold5000；发放金币
GAMEGOLD+10；发放元宝
setday1；标记今日已领取
#SAY
奖励领取成功！请注意查收背包。
@exit
（二）任务完成触发奖励脚本
适用于主线、支线任务，需检测任务进度、物品提交状态，完成后发放对应奖励。
脚本示例（以提交10个僵尸牙齿为例）：
(@TaskFinish)
#IF
checkitem僵尸牙齿10；检测是否拥有10个任务物品
check(10)0；检测任务是否未完成
#ACT
take僵尸牙齿10；收回任务物品
givebind骷髅头盔1；发放绑定装备
ChangeHumanAttr道术2；永久增加2点道术
set(10)1；标记任务完成
#SAY
任务完成！奖励已发放，继续闯荡吧。
#ELSESAY
你尚未集齐10个僵尸牙齿，无法完成任务。
@exit
（三）活动触发批量奖励脚本
适用于全服活动、限时活动，支持向指定玩家、全服玩家批量发放奖励，含范围控制。
1.向指定玩家发放奖励：
(@SendRewardToPlayer)
#IF
ISADMIN；仅管理员可触发
#ACT
SendReward玩家名称give屠龙1；向指定玩家发放屠龙
SendReward玩家名称GAMEGOLD+100；向指定玩家发放100元宝
#SAY
奖励已发放至指定玩家背包。
2.全服批量发放奖励：
(@SendAllReward)
#IF
ISADMIN
#ACT
MapAllUsergive超级疗伤药5；向全服玩家发放道具
MapAllUsergivegold10000；向全服玩家发放金币
SENDMSG6全服福利已发放，请注意查收背包！；全服提示
三、奖励脚本编写核心规范
遵循规范编写可避免奖励发放异常、脚本冲突，保障运行稳定。
1.条件检测必加：发放奖励前需检测背包空格（checkbaggage）、领取状态（checkday/check变量），避免道具发放失败或重复领取。
2.命令顺序合理：先检测条件，再执行收回物品操作，最后发放奖励，逻辑顺序不可颠倒，防止出现物品丢失。
3.时效标记清晰：每日、每周奖励需用setday/setweek命令标记领取状态，对应checkday/checkweek检测，避免重复发放。
4.文本提示完整：发放成功、失败、重复领取均需添加#SAY提示，让玩家明确交互结果，提升体验。
5.特殊奖励适配：绑定道具、时效称号需明确对应命令，不可混用普通发放命令，避免属性异常或交易漏洞。
四、常见问题及规避方法
1.奖励发放失败：优先检查背包是否满格，添加checkbaggage命令；核对物品名称是否正确，区分大小写及特殊符号。
2.重复领取奖励：遗漏setday/set变量标记，需在发放奖励后添加对应标记命令，搭配检测命令形成闭环。
3.属性奖励异常：永久属性命令需控制数值范围，避免超出版本上限；临时buff需设置合理时长，防止无限叠加。
4.脚本无响应：检查命令语法是否错误，如缺少#IF/#ACT标记、符号使用错误，可逐段注释排查问题代码。
5.全服奖励卡顿：批量发放时避免一次性发放高数量道具，可分批次执行，减少服务器资源占用。
传奇奖励脚本核心围绕道具、货币、属性、称号四类奖励展开，需结合对应命令实现发放逻辑，适配不同交互场景。
（一）道具奖励脚本命令及用法
道具奖励分背包发放、佩戴发放两类，支持指定数量、绑定状态，核心命令如下：
1.give物品名称数量：基储放命令，向玩家背包发放指定数量物品，可叠加物品自动合并，适用于普通道具。示例：give疗伤药10，向玩家发放10瓶疗伤药。
2.givebind物品名称数量：发放绑定道具，绑定后不可交易、丢弃，适用于任务专属奖励。示例：givebind烈火剑法1，发放绑定版烈火剑法技能书。
3.givew物品名称数量：直接发放至玩家装备栏对应位置，无对应位置则存入背包，适用于装备奖励。示例：givew裁决之杖1，发放裁决之杖至武器栏或背包。
注意：发放前需用checkbaggage命令检测背包空格，避免道具发放失败。
（二）货币奖励脚本命令及用法
货币奖励覆盖金币、元宝两类核心货币，支持增减、赋值操作，命令适配全版本通用场景。
1.givegold数值：发放金币，直接增加玩家背包金币数量。示例：givegold10000，发放10000金币。
2.GAMEGOLD符号数值：调整元宝数量，符号支持+（增加）、-（减少）、=（赋值）。示例：GAMEGOLD+50，增加50元宝；GAMEGOLD=100，将元宝数量设为100。
3.giveingot数值：发放金条、金砖等货币道具，需对应道具名称。示例：giveingot金砖2，发放2块金砖。
（三）属性奖励脚本命令及用法
属性奖励含临时加成、永久加成两种，需区分时效控制，避免属性异常叠加。
1.永久属性：ChangeHumanAttr属性类型数值，直接修改玩家永久属性。示例：ChangeHumanAttr攻击5，永久增加5点攻击；ChangeHumanAttr防御3，永久增加3点防御。
2.临时属性：BuffAddbuff编号时长等级，添加临时属性加成buff。示例：BuffAdd136002，添加编号1的buff，持续3600秒（1小时），等级2。
3.技能奖励：AddSkill技能名称等级，为玩家添加指定等级技能。示例：AddSkill召唤神兽3，为玩家添加3级召唤神兽技能。
（四）称号奖励脚本命令及用法
称号奖励通过修改玩家头顶标识实现，部分版本支持称号附带属性，命令如下：
1.SETRANKLEVELNAME称号文本：基础称号设置，直接替换玩家现有称号。示例：SETRANKLEVELNAME传奇勇士，为玩家设置“传奇勇士”称号。
2.AddTitle称号ID时长：添加带时效的称号，需提前在称号配置文件中定义ID对应称号及属性。示例：AddTitle586400，添加ID为5的称号，持续86400秒（24小时）。
二、常见奖励场景脚本编写实操
结合NPC交互、任务完成、活动触发三类高频场景，提供完整脚本示例，可直接复制修改后使用。
（一）NPC对话触发奖励脚本
适用于新手引导、日常领取奖励场景，通过对话选项触发奖励发放，含条件检测逻辑。
脚本示例：
(@Main)
#SAY
欢迎领取每日奖励！\
点击领取/@GetReward
(@GetReward)
#IF
checkday1；检测是否今日已领取
#SAY
你今日已领取奖励，明日再来！
@exit
#ELSEACT
give疗伤药20；发放道具
givegold5000；发放金币
GAMEGOLD+10；发放元宝
setday1；标记今日已领取
#SAY
奖励领取成功！请注意查收背包。
@exit
（二）任务完成触发奖励脚本
适用于主线、支线任务，需检测任务进度、物品提交状态，完成后发放对应奖励。
脚本示例（以提交10个僵尸牙齿为例）：
(@TaskFinish)
#IF
checkitem僵尸牙齿10；检测是否拥有10个任务物品
check(10)0；检测任务是否未完成
#ACT
take僵尸牙齿10；收回任务物品
givebind骷髅头盔1；发放绑定装备
ChangeHumanAttr道术2；永久增加2点道术
set(10)1；标记任务完成
#SAY
任务完成！奖励已发放，继续闯荡吧。
#ELSESAY
你尚未集齐10个僵尸牙齿，无法完成任务。
@exit
（三）活动触发批量奖励脚本
适用于全服活动、限时活动，支持向指定玩家、全服玩家批量发放奖励，含范围控制。
1.向指定玩家发放奖励：
(@SendRewardToPlayer)
#IF
ISADMIN；仅管理员可触发
#ACT
SendReward玩家名称give屠龙1；向指定玩家发放屠龙
SendReward玩家名称GAMEGOLD+100；向指定玩家发放100元宝
#SAY
奖励已发放至指定玩家背包。
2.全服批量发放奖励：
(@SendAllReward)
#IF
ISADMIN
#ACT
MapAllUsergive超级疗伤药5；向全服玩家发放道具
MapAllUsergivegold10000；向全服玩家发放金币
SENDMSG6全服福利已发放，请注意查收背包！；全服提示
三、奖励脚本编写核心规范
遵循规范编写可避免奖励发放异常、脚本冲突，保障运行稳定。
1.条件检测必加：发放奖励前需检测背包空格（checkbaggage）、领取状态（checkday/check变量），避免道具发放失败或重复领取。
2.命令顺序合理：先检测条件，再执行收回物品操作，最后发放奖励，逻辑顺序不可颠倒，防止出现物品丢失。
3.时效标记清晰：每日、每周奖励需用setday/setweek命令标记领取状态，对应checkday/checkweek检测，避免重复发放。
4.文本提示完整：发放成功、失败、重复领取均需添加#SAY提示，让玩家明确交互结果，提升体验。
5.特殊奖励适配：绑定道具、时效称号需明确对应命令，不可混用普通发放命令，避免属性异常或交易漏洞。
四、常见问题及规避方法
1.奖励发放失败：优先检查背包是否满格，添加checkbaggage命令；核对物品名称是否正确，区分大小写及特殊符号。
2.重复领取奖励：遗漏setday/set变量标记，需在发放奖励后添加对应标记命令，搭配检测命令形成闭环。
3.属性奖励异常：永久属性命令需控制数值范围，避免超出版本上限；临时buff需设置合理时长，防止无限叠加。
4.脚本无响应：检查命令语法是否错误，如缺少#IF/#ACT标记、符号使用错误，可逐段注释排查问题代码。
5.全服奖励卡顿：批量发放时避免一次性发放高数量道具，可分批次执行，减少服务器资源占用。